OIDC SSO を設定する
OIDC は、ID プロバイダーを接続するための SAML の代替です。どちらも、チームが既存の会社アカウントでサインインできるようにします。OIDC はより新しいプロトコルで、一部のプロバイダーはこちらを推奨します。どちらを使うべきかわからない場合は、SAMLを使ってください。これが初期選択であり、対応するすべてのプロバイダーで動作します。プロバイダーが推奨する場合、または SAML が選択肢にない場合に OIDC を使います。
設定の形は SAML と同じです。設定し、ドメインを確認し、テストし、その後有効化します。ただし、OIDC 固有の詳細がいくつかあります。
始める前に
- シングルサインオンを管理する許可を持つ管理者アカウント。
- ID プロバイダーの管理コンソールへのアクセス。
- 確認できるドメイン(チームがサインインに使うメールドメイン)。
セットアップウィザードを開く
- User Management → Single Sign-On に移動します。
- Set up single sign-on を選びます。
- プロバイダーを選び、プロトコルを OIDC に切り替えます。
ID プロバイダーと設定を交換する
-
プロバイダーのコンソールで、新しい OIDC(または「OpenID Connect」)アプリケーションを作成します。Kliv は貼り付けるリダイレクト URL を表示します。
-
プロバイダーは client ID、client secret、issuer URL(プロバイダーのログインサービスを識別する Web アドレス)を提供します。この 3 つすべてを Kliv に貼り付けます。
-
issuer URL は、プロバイダーと完全に一致する必要があります。1 文字単位で同じでなければなりません。ここが最も間違えやすい点です。
- Microsoft Entra の issuer はテナント固有で、長い識別子を含みます。ガイドから流用せず、自分のアプリからコピーしてください。
- Google は issuer を複数の形式で公開しています。コンソールに表示される正確なものを使ってください。
issuer が少しでもずれていると、有効なサインインが拒否されます。下のテスト手順で、それが問題かどうかがわかります。
Kliv はこれを下書きとして保存します。設定済みですが live ではありません。完了するまで、チームは現在と同じ方法でサインインし続けます。
ドメインを確認する
SAML と同じく、Kliv はメールドメインをあなたが管理していることを証明するまで、プロバイダーからアカウントを作成しません。ドメインを確認するに従い、Verified と表示されたらここに戻ります。
実際のサインインでテストする
- Test login を選びます。
- チームが行うのとまったく同じように、プロバイダーでサインインします。
- 成功すると、Kliv はテストを記録し、Turn on を使えるようにします。
- 失敗すると、Kliv は期待値と受信値の詳細を表示するため、issuer、secret、redirect を修正できます。失敗した SSO ログインのトラブルシューティングを参照してください。
有効化する
テストサインインが成功したら、Turn on を選びます。確認済みドメイン上の人は、サインインのためにプロバイダーへ送られるようになります。初回サインイン時には、標準メンバーアカウントが自動的に作成されます。
新しいメンバーに付与されるのはメンバーアクセスだけです。グループマッピングを設定しない限り、高いロールは付与されません。
ユーザー ID について
OIDC は、メールアドレスではなく、プロバイダーからの安定した値のペアで各人を識別します。これは意図的です。メールが変更されても同じ Kliv アカウントを維持でき、Kliv はプロバイダーがメールを「verified」とマークすることに依存しません(一部のプロバイダーは業務アカウントでそれを送信しません)。このために設定するものはありません。変更されたメールで重複アカウントが作られない理由として知っておくと役に立ちます。