ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

クロスドメイン ID 管理システム (SCIM)

Liferay DXP 2024年第1四半期以降

クロスドメイン ID 管理システム (SCIM) は、ユーザーのプロビジョニングを自動化するオープンスタンダードです。つまり、ユーザー ID を作成、更新、非アクティブ化するための標準的な方法です。 SCIM は、異なるアプリケーション間でユーザー/グループデータを同期するための、統一された RFC 準拠の方法を提供します。それは

ユーザーとグループを表すための定義済みスキーマ。詳細については、ユーザーリソーススキーマおよびグループリソーススキーマを参照してください。
これらのユーザーとグループに対して CRUD 操作を実行し、同期を維持するための RESTful API。詳細については、 SCIM ユーザー API の基礎および SCIM グループ API の基礎を参照してください。

重要

SCIM は、Liferay DXP 2024.Q1 でベータ機能フラグの背後でリリースされ、その後、Liferay DXP 2024.Q4 でリリース機能フラグ (LPS-96845) に移動されました。これは、Liferay DXP 2025.Q1/Portal GA132 で一般公開されました。

SCIM を使用すると、会社のアプリケーションと Liferay などのサービスプロバイダー間でのユーザー ID 情報の交換を安全に自動化できます。これは、会社で複数のアプリケーションを使用しており、カスタム実装なしでユーザーデータを同期させたい場合に役立ちます。

SCIMクライアントの登録

グローバルメニュー () を開き、 コントロールパネル → インスタンス設定 → セキュリティ → SCIMに移動します。
OAuth 2 アプリケーション名フィールドに名前を入力します。

ここで入力した名前は、SCIM クライアント ID の生成に使用されます。この ID は、ユーザーとグループを SCIM クライアントにリンクします。 SCIM クライアント名が Test SCIM Clientの場合、生成される SCIM クライアント ID は SCIM_test-scim-clientになります。
Matcher フィールドを userName または emailに設定します。

SCIM クライアントはこのフィールドを使用して、サービスプロバイダーと接続されたアプリケーションのユーザーデータを照合します。これにより、プロビジョニングの問題が回避され、データの重複が防止されます。
アクセストークンフィールドは最初は空です。生成をクリックし、 OK をクリックして、フィールドにアクセストークンを入力します。アクセストークンは取り消されない限り 1 年後に期限切れになります。アクセストークンを生成するのが初めてではない場合は、既存のトークンが上書きされますが、そのトークンの有効期間は最大 10 日間です。この猶予期間を利用して、クライアントアプリケーションで新しいトークンを構成できます。

Authorization リクエストヘッダーにアクセストークンを設定することで、SCIM API を呼び出すことができます。すべてのアクセストークンを取り消すには、 [取り消し] をクリックし、 [OK]をクリックします。
[保存]をクリックします。

注

スケジューラは毎日実行され、 SCIM_ プレフィックスで始まるすべての OAuth 2 アプリケーションを取得します。アクセストークンの有効期限が 30 日以内、10 日以内、または 1 日以内の場合、すべての管理者に Liferay と電子メールで通知されます。上記のページには、有効期限前に新しいトークンを生成するように管理者に指示する警告メッセージも表示されます。

重要

SCIM 構成を保存すると、OAuth 2 アプリケーションがプロビジョニングされます。このアプリはクライアント資格情報フローを使用し、現在ログインしているユーザーがデフォルトのクライアント資格情報ユーザーになります。 SCIM アクセストークンを生成すると、このユーザーは生成されたトークンの所有者になります。このトークンを使用して行われたすべてのアクティビティは、このユーザーにまで遡ることができます。 SCIM 構成を保存する前に、適切な権限と特権を持つユーザーを作成するか、既存のユーザーを使用していることを確認する必要があります。デフォルトの SCIM ユーザーを別のユーザーに変更する場合は、以下の手順を参照してください。