SCIM 2.0 プロビジョニング

CHAMPREP は、対象となるエンタープライズ組織のプロビジョニングSCIM 2.0をサポートしています。 ID プロバイダーは、組織メンバーのプロビジョニングおよびプロビジョニング解除を行うことができ、 グループ同期が有効になっている場合は、組織グループの管理を行うことができます。

SCIM は とは別です。CHAMPREPAPI Gatewayエンタープライズ管理画面に表示される組織固有 SCIMのベース URL およびトークンを使用してください。 ブラウザの URLAPI や一般的な キーCHAMPREPAPIを代用しないでください。

ID プロバイダーの設定

1. エンタープライズダッシュボードで、[ SCIM プロビジョニング.
2. プロビジョニングを有効にする前に、デフォルトのシートタイプ、プロビジョニング解除の動作、およびグループ同期の 設定を確認してください。
3. のみを含むトークSCIMンを作成します。 Users, Groups、または IDプロバイダーが必要とする複合アクセス。
4. 表示されたベースSCIM URL とトークンを、ID プロバイダーにコピーしてください。
5. 本番環境のグループを割り当てる前に、特権のないユーザーでテストを行ってください。
6. で、結果として得られるメンバー、シート、およびグループの状態を確認しますCHAMPREP。

トークンの値は、作成時またはローテーション時にのみ表示されます。これを ID プロバイダーのシークレットストアに保存し、ブラウザバンドル、 チケット、ログ、または共有ドキュメントには絶対に記載しないでください。

認証

組織固有のトークンを OAuth ベアラー認証情報として送信します：

Authorization: Bearer YOUR_SCIM_TOKEN
Accept: application/scim+json
Content-Type: application/scim+json

トークンは有効期限が切れたり、取り消されたりする場合があります。ID プロバイダーで 更新設定を行い、同期が正常に完了したことを確認した後、 以前のトークンを取り消すことで、トークンを更新してください。

サポートされているリソース

以下のすべてのパスは、によって表示されるベースSCIM URL を基準としていますCHAMPREP。

方法	パス	目的
POST	/Users	ユーザーをプロビジョニングします。
GET	/Users	ユーザーを一覧表示するか、サポートされている属性でフィルタリングします。
GET	/Users/{id}	1人のユーザーを読み取ります。
PUT	/Users/{id}	ユーザーを置き換えます。
PATCH	/Users/{id}	サポートされている部分的な更新を適用します。
DELETE	/Users/{id}	設定されたプロビジョニング解除の動作を適用します。
POST	/Groups	グループ同期が有効な場合に、グループを作成します。
GET	/Groups	同期されたグループを一覧表示します。
GET	/Groups/{id}	1つのグループを読み取ります。
PUT	/Groups/{id}	グループおよびそのサポート対象のメンバーシップを置き換えます。
PATCH	/Groups/{id}	サポート対象のグループメンバーを追加または削除します。
DELETE	/Groups/{id}	同期されたグループを削除します。

グループ操作の結果 403 グループ同期が無効な場合。グループ リクエスト内のメンバー 識別子は、同じ 組織から可視なユーザーを指す必要があります。

ディスカバリー

CHAMPREP では、標準のディスカバリーリソースが公開されています：

パス	目的
/ServiceProviderConfig	サポートされている機能SCIMと認証方式。
/ResourceTypes	ユーザーおよびグループのリソース定義。
/Schemas	サポートされているコアおよびエンタープライズユーザースキーマ、ならびにグループスキーマ。

PATCHおよびフィルタリングがサポートされています。一括操作、パスワードの変更、および ETagについては、サポートされているとは明記されていません。オプションのSCIM機能を前提とするのではなく、 ディスカバリー応答を信頼できる情報源としてご利用ください。

運用上のガイダンス

• 自動的に プロビジョニングされるメンバーに対しては、対象となる組織ロールおよびシートタイプのみを割り当ててください。
• IDプロバイダーによるグループ割り当ては、特権的な管理 操作として扱ってください。
• 構成の変更やディレクトリの一括 更新を行った後は、エンタープライズの監査アクティビティを確認してください。
• 未使用のトークン、公開されているトークン、または廃止された統合が所有するトークンは、取り消してください。
• 同期に失敗した場合は、SCIMステータス、レスポンス本文、 リソースタイプ、およびおおよその時刻は保持しますが、ベアラートークンとユーザー データは、連絡を取る前に削除してください。 CHAMPREP サポート.