SAML SSO を設定する

シングルサインオン(SSO)により、チームは普段仕事で使っているアカウントで Kliv にサインインできます。会社の ID プロバイダー(Okta や Microsoft Entra のように従業員のログインを管理するサービス)を通じて行います。別の Kliv パスワードを管理する必要はなく、誰かが退職した場合も、1 か所で削除すればここでのアクセスも削除されます。

SAML は、ID プロバイダーを接続する最も広く対応された方法です。このページでは、設定し、実際のサインインでテストし、有効化するまでを順に説明します。この順序にすることで、チームに影響を出さずに進められます。

このすべてを自分で設定します。サポートチケットもベンダーとの通話も不要です。

始める前に

  • 組織のシングルサインオンを管理する許可を持つ管理者アカウントが必要です。
  • ID プロバイダーの管理コンソール(Okta、Entra、Google Workspace、OneLogin、または別の SAML プロバイダー)へアクセスできる必要があります。
  • 確認できるドメイン、つまりチームがサインインに使うメールドメイン(たとえば yourcompany.com)を用意します。

セットアップウィザードを開く

  1. User Management → Single Sign-On に移動します。
  2. Set up single sign-on を選びます。
  3. プロバイダーを選びます。Okta、Microsoft Entra、Google、OneLogin、または Other です。既知のプロバイダーを選ぶと適切な設定が事前入力されるため、手でコピーする量が少なくなります。
  4. プロトコルは SAML(初期設定)のままにします。OIDC は上級向けの代替です。OIDC SSO を設定するを参照してください。

ID プロバイダーと設定を交換する

SSO は、ID プロバイダーと Kliv が互いを信頼することで動作します。それぞれに、相手についてのいくつかの詳細を渡します。

  1. Kliv は、プロバイダーが必要とする値(Kliv が待ち受けるサインイン URL など)を表示します。これらをプロバイダーの管理コンソールにある新しい SAML アプリケーションへコピーします。
  2. プロバイダーは、自身の詳細を返します。通常は metadata URL または XML ファイルと、署名証明書です。メタデータを Kliv に貼り付けます(またはファイルをアップロードします)。
  3. プロバイダーが、単なるメールアドレスではなく、各ユーザーの安定した識別子を送ることを確認します。(正確な属性はプロバイダー固有です。プリセットが使うものの名前を示します。コンソール内の文言を確認してください。) これは、メールが変わっても Kliv が戻ってきた同じ人を認識するために使う値です。

Kliv はこれを下書きとして保存します。下書きは設定済みですがまだ live ではありません。完了するまで、チームは現在と同じ方法でサインインし続けます。

ドメインを確認する

Kliv がプロバイダーからアカウントを作成する前に、チームが使うメールドメインをあなたが管理していることを証明する必要があります。これにより、他人が自分のものでないドメインを主張することを防ぎます。

ドメインを確認するに従って、DNS レコードまたはファイルを Web サイトに追加します。Verified と表示されたら、ここへ戻ります。

実際のサインインでテストする

これは、SSO を安全に有効化するための手順です。誰かに影響する前に、往復全体が動作することを証明します。

  1. ウィザードで Test login を選びます。
  2. チームが行うのとまったく同じように、ID プロバイダーへ送られてサインインします。
  3. 成功すると、Kliv は成功したテストを記録し、Turn on ボタンを使えるようにします。
  4. 失敗すると、Kliv は期待していたものとプロバイダーが実際に送ったものを表示します。失敗した SSO ログインのトラブルシューティングを参照してください。プロバイダー側で修正し、再度テストします。

有効化しようとしている正確な設定に対してテストサインインが成功するまで、SSO をオンにすることはできません。単に保存するだけでは決して十分ではありません。

有効化する

テストに合格したら、Turn on を選びます。以後、確認済みドメインのメールアドレスを入力した人は、サインインのために ID プロバイダーへ送られます。初めてサインインする人には、標準メンバーアクセスの Kliv アカウントが自動的に作成されます。

新しいメンバーは everyone グループにだけ入ります。意図的に設定しない限り、ID プロバイダーから admin や高いロールを得ることはありません。IdP グループを Kliv ロールにマッピングするを参照してください。

設定後

Single Sign-On ページには、ウィザードの代わりにステータスカードが表示されます。プロバイダー、確認済みドメイン、最後に成功したサインイン、署名証明書の期限が近い場合の警告です。その警告に注意してください。証明書が期限切れになると、新しい証明書をアップロードするまでサインインが止まります。

ドメイン上の全員に SSO を必須にし、万一壊れたときにも安全な戻り道を保つには、SSO を必須にし、break-glass 管理者を設定するを参照してください。