SCIM プロビジョニングを構成する

SCIM プロビジョニングは、Kliv 内のチームを ID プロバイダーと自動的に同期します。Okta や Entra で誰かを正しいグループに追加すると、その人に Kliv アカウントが作成されます。そこで非アクティブ化すると、Kliv のアクセスも取り消されます。開いていたセッションも含めて即座に終了します。手動の後片付けも、退職後にアクセスが残ることもありません。

これはディレクトリ同期です。SSO と並行して動作します。SSO は人がサインインする方法であり、SCIM はその人たちのアカウントを作成し、削除する方法です。

設定するもの

ID プロバイダーに base URL と token の 2 つを渡すと、残りはプロバイダー側で行われます。これをオンにした後は、Kliv で個別ユーザーを管理しません。プロバイダーが信頼できる情報源です。

プロビジョニングをオンにし、詳細を取得する

  1. User Management → Single Sign-On に移動します。
  2. Provisioning タブを開きます。
  3. Kliv がプロバイダーに必要な base URL を表示します。コピーします。
  4. Generate token を選びます。Kliv は bearer token を一度だけ表示します。今コピーして、安全な場所に保存してください。セキュリティのため、Kliv が再表示することはありません。

ID プロバイダーで接続する

プロバイダーの管理コンソールで Kliv アプリケーションのプロビジョニング設定を開き、次を貼り付けます。

  • Kliv からの base URL、
  • 生成したばかりの token。

次に、必要なアクションを有効にします。通常はユーザーの作成、ユーザーの更新、ユーザーの非アクティブ化で、使う場合はグループ同期も含めます。プロバイダーには通常 Test Connection ボタンがあります。実行してリンクが動作することを確認します。

アカウントの作成と削除

  • Create / activate:プロバイダーで Kliv に割り当てられたユーザーに、標準メンバーアクセスの Kliv アカウントが作成されます。
  • Update:名前やその他の属性変更が自動的に流れます。
  • Deactivate:プロバイダーでユーザーを inactive にすると、その人の Kliv アクセスは取り消され、開いているセッションは終了します。再度サインインすることはできません。
  • Delete:ユーザーを完全に削除することは、deactivate の恒久版です。

新しく SCIM でプロビジョニングされたメンバーに付与されるのはメンバーアクセスだけです。意図的にグループマッピングを設定しない限り、プロバイダーから admin や高いロールを継承することはありません。

トークンをローテーションする

トークンが露出した可能性がある場合、またはセキュリティポリシーが求めるスケジュールで、トークンをローテーションします。

  1. Provisioning タブで Rotate token を選びます。
  2. 新しいトークン(一度だけ表示)をコピーし、ID プロバイダーで更新します。

プロバイダーを新しいトークンで更新するまで、プロビジョニングは失敗します。そのため、新しい値をすぐにプロバイダーへ貼り付けられるときにローテーションしてください。

状態を確認する

Provisioning タブには、接続の健全性と最近のエラーが表示されます。プロバイダーがプロビジョニング失敗を報告している場合は、まずここを確認します。接続失敗のほとんどは、期限切れまたは不一致のトークン、あるいは完全にコピーされていない base URL が原因です。

Kliv での SCIM ユーザー管理

ユーザーまたはグループが SCIM に所有されると、ID プロバイダーがその管理者になります。SCIM 管理のユーザーやグループを Kliv で直接編集しようとして拒否された場合、それは想定どおりです。バグではなく、プロバイダー側の内容が上書きされないよう保護しています。代わりにプロバイダーで変更してください。