SCIM プロビジョニングを構成する
SCIM プロビジョニングは、Kliv 内のチームを ID プロバイダーと自動的に同期します。Okta や Entra で誰かを正しいグループに追加すると、その人に Kliv アカウントが作成されます。そこで非アクティブ化すると、Kliv のアクセスも取り消されます。開いていたセッションも含めて即座に終了します。手動の後片付けも、退職後にアクセスが残ることもありません。
これはディレクトリ同期です。SSO と並行して動作します。SSO は人がサインインする方法であり、SCIM はその人たちのアカウントを作成し、削除する方法です。
設定するもの
ID プロバイダーに base URL と token の 2 つを渡すと、残りはプロバイダー側で行われます。これをオンにした後は、Kliv で個別ユーザーを管理しません。プロバイダーが信頼できる情報源です。
プロビジョニングをオンにし、詳細を取得する
- User Management → Single Sign-On に移動します。
- Provisioning タブを開きます。
- Kliv がプロバイダーに必要な base URL を表示します。コピーします。
- 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 や高いロールを継承することはありません。
トークンをローテーションする
トークンが露出した可能性がある場合、またはセキュリティポリシーが求めるスケジュールで、トークンをローテーションします。
- Provisioning タブで Rotate token を選びます。
- 新しいトークン(一度だけ表示)をコピーし、ID プロバイダーで更新します。
プロバイダーを新しいトークンで更新するまで、プロビジョニングは失敗します。そのため、新しい値をすぐにプロバイダーへ貼り付けられるときにローテーションしてください。
状態を確認する
Provisioning タブには、接続の健全性と最近のエラーが表示されます。プロバイダーがプロビジョニング失敗を報告している場合は、まずここを確認します。接続失敗のほとんどは、期限切れまたは不一致のトークン、あるいは完全にコピーされていない base URL が原因です。
Kliv での SCIM ユーザー管理
ユーザーまたはグループが SCIM に所有されると、ID プロバイダーがその管理者になります。SCIM 管理のユーザーやグループを Kliv で直接編集しようとして拒否された場合、それは想定どおりです。バグではなく、プロバイダー側の内容が上書きされないよう保護しています。代わりにプロバイダーで変更してください。