失敗した SSO ログインのトラブルシューティング
ID プロバイダー経由のサインインが動かないとき、Kliv は単なる「サインイン失敗」ではなく、実際の修正内容を示せるように作られています。このページでは、どこを見ればよいか、見つけた内容をどう読むかを説明します。
答えがある場所
失敗したサインインには、意図的に 2 つの異なる表示があります。
- サインインする本人には、短い reference ID 付きの「サインインできませんでした」という平易なメッセージが表示されます。技術的な詳細は見えません。ID 設定の内容が漏れるためです。
- 管理者であるあなたには、監査ログ内の完全な診断が表示されます。reference ID はそこを指しています。
そのため、チームメイトがサインイン失敗を報告したら、reference ID を尋ね、それを検索します。
診断を読む
- User Management → Single Sign-On に移動し、Audit タブを開きます。
- 失敗したサインインを見つけます(reference ID で照合するか、最新のエントリーを見ます)。
- 開いて expected-versus-received の詳細を確認します。Kliv が実行する各チェックについて、何を期待し、プロバイダーが実際に何を送ったかが表示されます。不一致が修正点です。
作業中に実ユーザーを巻き込まず、必要に応じて失敗を再現するには、Single Sign-On ページの Test login 手順を実行できます。
よくある原因と修正
issuer が一致しない(OIDC)。 最も頻繁な OIDC の問題です。issuer URL はプロバイダーと 1 文字単位で一致する必要があります。Microsoft Entra の issuer はテナント固有です。Google は複数の形式を公開しています。自分のプロバイダーアプリから正確な issuer をコピーし、Kliv に貼り付けてください。
署名証明書が期限切れ(SAML)。 昨日は動いていたサインインが急に失敗します。プロバイダーの署名証明書が期限切れです。現在の証明書をアップロードします(またはプロバイダーのメタデータから更新します)。ステータスカードはこの前に警告します。見逃さないでください。
ユーザーのメールドメインが確認されていない。 Kliv は、あなたが管理を証明したメールドメインに対してのみアカウントを作成します。未確認ドメインのためにサインインが拒否された場合は、そのドメインについてドメインを確認するを完了してください。
アカウントが非アクティブ化されている。 その人が ID プロバイダーまたは Kliv で非アクティブ化されている場合、サインインは設計上拒否されます。SSO ログインが無効化されたアカウントを黙って再有効化することはありません。アクセスすべき人なら、プロバイダーで再度有効にします。
ID(NameID)が安定していない。 プロバイダーが毎回異なる識別子を送る場合、または安定した ID ではなくメールを送る場合、Kliv は同じ人を確実に認識できません。プロバイダーが、そのプリセットで指定された安定識別子を送るように設定してください。
メールが「verified」とマークされていない。 Kliv はこれを必要としません。メール確認フラグではなく、安定したプロバイダー識別子で人を識別します。そのため「verified」マークがないことは原因ではありません。代わりに他のチェックを見てください。
まだ詰まっている場合
expected-versus-received の詳細には、失敗した具体的なチェックの名前と、プロバイダーに応じたガイダンスが示されます。その 1 つのチェックに取り組み、プロバイダー側で修正し、Test login を再実行します。有効化には成功したテストが必要だったため、以前動いていた設定が突然止まった場合、ほとんどは期限切れ証明書か、プロバイダー側で変更された設定が原因です。