ユーザー・カテゴリへのユーザーの追加
このユースケースでは、ユーザーをユーザー・カテゴリに割り当てる方法について説明します。 ユーザーを割り当てることができるのは、1つのカテゴリのみです。 ユーザーが作成されると、カテゴリが指定されていない場合、ユーザーは自動的にDEFAULTカテゴリに割り当てられます。 後で、ユーザーを別のカテゴリに再割当できます。 ただし、任意の時点で、ユーザーは1つのカテゴリにのみ属することができます。 カテゴリごとに、通知やパスワード失効警告などのユーザー・グループ・レベルの設定を構成できます。 ユーザー・カテゴリを割り当てずにユーザーが作成されると、値DEFAULTが自動的に割り当てられます。
始める前に、カテゴリ名を知っておく必要があります。 カテゴリ名を取得するには、セキュリティ・コンソールに移動し、「ユーザー・カテゴリ」ページでリストからカテゴリ名を指定します。 手順については、『アプリケーションの保護』ガイドの「実装ユーザー」を参照してください。
この例では、ユーザーを追加するカテゴリREST_SCIM_02を特定したとします。 次に、ユーザーを検索し、ユーザーの一意の識別子を取得します。
- cURLおよび
eqフィルタ・パラメータをusernameフィールドとともに使用して、ユーザーを問い合せます。 この例では、問い合せたユーザー名はCUST_CONTRACT_MGR_OPERATIONSで、問合せによって返されるユーザーIDは5A25572D96277A00C0547E3A715EF682です。curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users?filter=username eq "CUST_CONTRACT_MGR_OPERATIONS"応答ペイロードのサンプル
{ "itemsPerPage": 1, "startIndex": 1, "Resources": [ { "id": "5A25572D96277A00C0547E3A715EF682", "meta": { "created": "2009-05-25 00:00:00.000", "lastModified": "2015-12-14 10:15:48.291", "location": "https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users/5A25572D96277A00C0547E3A715EF682" }, "schemas": [ "urn:scim:schemas:core:2.0:User", "urn:scim:schemas:extension:fa:2.0:faUser" ], "userName": "CUST_CONTRACT_MGR_OPERATIONS", "name": { "familyName": "Black", "givenName": "Sophie" }, "displayName": "Sophie Black", "emails": [ { "value": "CUST_CONTRACT_MGR_OPERATIONS@dummy.oracle.com", "type": "W", "primary": true } ], "roles": [ { "id": "4EB6B72643872425B6BE573B531ABC6B", "value": "OKC_CUSTOMER_CONTRACT_MANAGER_VISION_OPERATIONS_DATA", "displayName": "Customer Contract Manager - Vision Operations", "description": "Customer Contract Manager for Vision Operations" }, { "id": "40C4AE052EC2582286A6A0FB1514656C", "value": "ORA_PER_EMPLOYEE_ABSTRACT", "displayName": "Employee", "description": "Identifies the person as an employee." }, { "id": "05E9F3576995F83E74EB3818FDCA8639", "value": "ORA_PER_LINE_MANAGER_ABSTRACT", "displayName": "Line Manager", "description": "Identifies the person as a line manager." } ], "active": true } ] } - ユーザー・リソースに対する
PATCH操作を発行して、問合せ対象ユーザーのユーザー・カテゴリを更新します。 この例では、REST_SCIM_02カテゴリに割り当てられる5A25572D96277A00C0547E3A715EF682ユーザーIDを更新します。curl -i -u "<username>:<password>" -X PATCH https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users/5A25572D96277A00C0547E3A715EF682サンプル・リクエスト・ペイロード
{ "schemas": [ "urn:scim:schemas:core:2.0:User", "urn:scim:schemas:extension:fa:2.0:faUser" ], "urn:scim:schemas:extension:fa:2.0:faUser": { "userCategory": "REST_SCIM_02" } }応答ペイロードのサンプル
{ "id": "5A25572D96277A00C0547E3A715EF682", "meta": { "created": "2017-12-12 08:12:58.000", "lastModified": "2017-12-12 08:14:26.016", "location": "https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users/5A25572D96277A00C0547E3A715EF682" }, "schemas": [ "urn:scim:schemas:core:2.0:User", "urn:scim:schemas:extension:fa:2.0:faUser" ], "userName": "CUST_CONTRACT_MGR_OPERATIONS", "name": { "familyName": "Black", "givenName": "Sophie" }, "displayName": "Sophie Black", "emails": [ { "value": "CUST_CONTRACT_MGR_OPERATIONS@dummy.oracle.com", "type": "W", "primary": true } ], "urn:scim:schemas:extension:fa:2.0:faUser": { "userCategory": "REST_SCIM_02" }, "active": true }ユーザーが特定のユーザー・カテゴリに追加されます。
複数のユーザーを異なるユーザー・カテゴリに追加する必要がある場合は、一括操作を使用して追加できます。 この例では、一括操作を使用して2人のユーザーを作成し、2つの異なるユーザー・カテゴリ(REST_SCIM_01およびREST_SCIM_02)に追加します。
サンプル・リクエスト・ペイロード
{
"Operations":[
{
"method":"POST",
"path":"/Users",
"bulkId":"scim_Bulk_{{$randomInt}}_01",
"data":{
"schemas":[
"urn:scim:schemas:core:2.0:User"
],
"name":{
"familyName":"Sun",
"givenName":"GN_Bulk_User_{{$randomInt}}_01"
},
"displayName":"DN_Bulk_User_{{$randomInt}}_01",
"emails":[
{
"value":"xx.yy@oracle.com",
"primary":true,
"type":"W"
}
],
"userName":"UN_Bulk_User_{{$randomInt}}_01",
"password":"<password>",
"urn:scim:schemas:extension:fa:2.0:faUser":{
"userCategory":"REST_SCIM_01"
}
}
},
{
"method":"POST",
"path":"/Users",
"bulkId":"scim_Bulk_{{$randomInt}}_02",
"data":{
"schemas":[
"urn:scim:schemas:core:2.0:User"
],
"name":{
"familyName":"Sun",
"givenName":"GN_Bulk_User_{{$randomInt}}_02"
},
"displayName":"DN_Bulk_User_{{$randomInt}}_02",
"emails":[
{
"value":"aa.bb@oracle.com",
"primary":true,
"type":"W"
}
],
"userName":"UN_Bulk_User_{{$randomInt}}_02",
"password":"<password>",
"urn:scim:schemas:extension:fa:2.0:faUser":{
"userCategory":"REST_SCIM_02"
}
}
}
]
}