SCIMトークン
組織がSCIM 2.0を使用してユーザーおよびグループ情報をInformatica Intelligent Cloud Servicesにプッシュする場合は、scimTokensリソースを使用してSCIMトークンを管理できます。scimTokensリソースを使用して、SCIMトークンの一覧表示、作成、および削除を行います。
次の要求方法を使用できます。
- •作成したSCIMトークンを一覧表示するには、GET要求を使用します。
- •SCIMトークンを作成するには、POST要求を使用します。
- •作成したSCIMトークンを削除するには、DELETE要求を使用します。
SCIMトークンを変更する前に、管理者で[SAMLグループとロールのマッピング]および[IdPを有効にしてユーザー/グループをプッシュ(SCIM 2.0を使用)]オプションが有効になっていることを確認してください。ユーザーロールには、組織の読み取りおよび更新の権限が割り当てられている必要もあります。
SCIM 2.0の使用と管理者のアセットの権限の詳細については、管理者のヘルプの「ユーザー管理」を参照してください。
SCIMトークンの一覧表示
scimTokensリソースを使用して、作成したSCIMトークンに関する詳細を要求します。
GET要求
作成したSCIMトークンの一覧を取得するには、次のURIを使用します。
/public/core/v3/scimTokens
GET応答
成功した場合は、作成したそれぞれのSCIMトークンとその有効期限が返されます。
エラーが発生した場合にエラーオブジェクトを返します。
GETの例
作成したSCIMトークンを一覧表示するには、次の要求を使用します。
GET <baseApiUrl>/public/core/v3/scimTokens
Content-type: application/json
Accept: application/json
INFA-SESSION-ID: <SessionId>
応答が成功した場合、以下の例のようになります。
[
{
"id": "im2hLfwsRCvl6WG64Geqi0",
"value": "8fiXOaFR**************",
"expiry": "2025-04-28T21:05:31.000Z",
"status": "active"
}
]
SCIMトークンの作成
scimTokensリソースを使用してSCIMトークンを作成します。すでに2つのトークンがある場合は、1つまたは両方のトークンの有効期限が切れている場合でも、新しいトークンを作成する前に1つのトークンを削除する必要があります。
POST要求
SCIMトークンを作成するには、次のURIを使用します。
/public/core/v3/scimTokens
POST要求の例
トークンを作成する場合、要求は次の例のようになります。
POST <baseApiUrl>/public/core/v3/scimTokens
Content-type: application/json
Accept: application/json
INFA-SESSION-ID: <SessionId>
POST応答
作成したトークンのトークン応答オブジェクトを返します。
エラーが発生した場合はエラーオブジェクトを返します。
応答が成功した場合、以下の例のようになります。
{
"id": "hTc5rzwEFKMh761VofJoG1",
"value": "k7UxoAAAACMAAAACAQAAAAEBAgAAAAyufel1d7nvOzJh5khiVmxxXrnYJl1iR23aBQtVPKPLTiB0qqLCp-davEg50diXElP4-Q==0s3URI0up6Ebu4sLzgtSGC",
"expiry": "2025-05-06T04:54:53.594Z",
"status": "active"
}
SCIMトークンの削除
scimTokensリソースを使用して、SCIMトークンを削除します。
SCIMトークンを削除するには、次のURIを使用してDELETE要求を送信します。
/public/core/v3/scimTokens/<token_id>
成功した応答は204応答コードを返します。エラーが発生した場合は、エラーオブジェクトが返されます。