Oracle® Fusion Middleware Oracle Identity Governanceのためのアプリケーションの開発とカスタマイズ 12c (12.2.1.3.3) E91981-03 |
|
![]() 前 |
![]() 次 |
この章では、SCIM/RESTサービスおよびREST APIの使用方法について説明します。次の項目が含まれます。
注意:
デフォルトでは、SCIMは、HTTPとHTTPSの両方のポートで実行するように構成されています。SCIMをHTTPSポートのみで実行できるようにするには、SCIMのHTTPSのみでの実行の有効化に記載されている手順を実行してください。アイデンティティRESTサービスは、System for Cross-Domain Identity Management (SCIM)プロトコルに基づいています。
Oracle Identity Manager SCIMサービスは、ユーザー・リソースのスキーマ属性に記載されているように、デフォルトでSCIMスキーマおよびIDM拡張機能とともに使用できます。
スキーマの取得の説明に従って、サポートされているスキーマを取得できます。
Oracle Identity Managerをデプロイする場合、SCIMがOracle Identity ManagerサーバーのWebアプリケーションとしてデフォルトでデプロイされます。
Oracle Identity ManagerでのSCIM実装は、draft-ietf-scim-api-13 and draft-ietf-scim-core-schema-13に従います。IETFドラフトの詳細は、次のURLを参照してください。
サポートされている操作に使用されるSCIMベースAPIは、ユーザー、組織、パスワード・ポリシー、システム・プロパティなど、様々なリソースで使用できます。
表21-1は、Oracle Identity Managerのサポートされている操作に使用されるSCIMベースAPIを示しています。
表21-1 SCIMベースAPIおよびサポートされている操作
リソース | エンドポイント | 操作 | スキーマURL | 説明 |
---|---|---|---|---|
ユーザー |
/Users |
GET、POST、PUT、PATCH、DELETE |
urn:ietf:params:scim:schemas:core:2.0:User urn:ietf:params:scim:schemas:extension:enterprise:2.0:User · urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User · urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User |
ユーザーの取得/追加/変更/無効化/有効化/ロック/ロック解除/削除 - identity.usermgmt.api.UserManager |
ユーザー |
/Me |
GET、POST、PUT、PATCH |
·urn:ietf:params:scim:schemas:core:2.0:User · urn:ietf:params:scim:schemas:extension:enterprise:2.0:User · urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User · urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User |
自分のプロファイルの取得/変更、自分のパスワードの変更、自分のチャレンジ・レスポンスの変更 - selfservice.self.selfmgmt.api.AuthenticatedSelfService 自己登録 - UnauthenticatedSelfServiceを使用 |
PasswordResetterWithChallenges |
/PasswordResetterWithChallenges |
POST |
· urn:ietf:params:scim:schema:oracle:core:2.0:PasswordResetterWithChallenges |
|
PasswordValidator |
/PasswordValidator |
POST |
· urn:ietf:params:scim:schema:oracle:core:2.0:PasswordValidator |
|
UserNameGenerator |
/UserNameGenerator |
POST |
· urn:ietf:params:scim:schema:oracle:core:2.0:UserNameGenerator |
|
UserNameRecoverer |
/UserNameRecoverer |
POST |
· urn:ietf:params:scim:schema:oracle:core:2.0:UserNameRecoverer |
|
UserNameValidator |
/UserNameValidator |
POST |
· urn:ietf:params:scim:schema:oracle:core:2.0:UserNameValidator |
|
グループ |
/Groups |
GET、POST、PUT、PATCH、DELETE |
· urn:ietf:params:scim:schemas:core:2.0:Group · urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group · urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group |
グループの取得/追加/変更/SetUserMembershipRule/削除 - identity.rolemgmt.api.RoleManager |
組織 |
/Organizations |
GET、POST、PUT、PATCH、DELETE |
urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization |
組織の取得/追加/変更/SetUserMembershipRule/削除 - identity.orgmgmt.api.OrganizationManager |
パスワード・ポリシー |
/PasswordPolicies |
GET、POST、PUT、PATCH、DELETE |
urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy |
パスワード・ポリシーの取得/追加/変更/削除 - passwordmgmt.api.PasswordMgmtService |
通知テンプレート |
/NotificationTemplates |
GET、POST、PUT、PATCH、DELETE |
urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate |
通知テンプレートの取得/追加/変更/削除 - notification.api.NotificationService |
システム・プロパティ |
/SystemProperties |
GET、PATCH |
urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:SystemProperty |
システム・プロパティの取得/変更 - config.api.SystemConfigurationService |
サービス・プロバイダ構成スキーマ |
/ServiceProviderConfigs |
GET |
urn:ietf:params:scim:schemas:core:2.0:ServiceProviderConfig |
サービス・プロバイダの構成の取得 |
リソース・タイプ |
/ResourceTypes |
GET |
urn:ietf:params:scim:schemas:core:2.0:ResourceType |
リソース・タイプの構成の取得 |
スキーマ |
/Schemas |
GET |
urn:ietf:params:scim:schemas:core:2.0:Schema urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Schema |
リソースのスキーマの取得 |
検索 |
[prefix]/.search |
POST |
該当なし |
POSTを使用した1つ以上のリソース・タイプのシステム・ルートまたはリソース・エンドポイント内での検索の実行 |
リソース・スキーマとサポートされているリソースのスキーマ属性を理解します。
この項では、リソース・スキーマについて説明し、サポートされているリソースのスキーマ属性をリストします。次の項目が含まれます。
サポートされているSCIM属性、SCIMスキーマ属性のタイプおよび可変性を理解します。
この項にリストするリソース・スキーマの表は、サポートされるSCIM属性を示しています。すべてのSCIMリソース・タイプおよびスキーマ拡張は、JSONリクエストとレスポンスの両方で次のURIによって識別されます。
urn:oracle:scim:schemas:idm:2.0:RESOURCE_TYPE
ユーザー、グループ、組織などのすべてのSCIMリソースには、SCIMスキーマ属性の次のタイプが含まれます。
SVA: 単一値属性
MVA: 複数値属性。
CSVA: 複合単一値属性
CMVA: 複合複数値属性。
SCIMユーザー・スキーマは、各値が個人用電子メール・アドレス、仕事用電子メール・アドレス、その他の電子メール・アドレスなどのサブ属性と値を持つことができる電子メール・アドレスなどのCMVAをサポートします。既存のOracle Identity Managerユーザー・スキーマ属性にマップできる場合を除き、Oracle Identity ManagerはCMVAをサポートせず、Oracle Identity Manager SCIM/REST APIもCMVAをサポートしません。Oracle Identity Manager SCIM/RESTでサポートされない複合SCIM属性を含むリクエストが行われた場合、RESTレスポンスに同じ内容を示すエラーが戻されます。
可変性は、特定の属性がアクセスされる方法です。可能な可変性値は次のとおりです。
読取り専用(RO): 作成および読取り/検索操作を実行できます
WO: 作成はできますが、読取り/検索操作はできません
RW: 作成および読取り/検索操作を実行できます
ユーザー・スキーマ属性、エンタープライズ・ユーザー・スキーマ属性、IDM共通ユーザー・スキーマ属性、OIGユーザー・スキーマ拡張属性など、ユーザー・リソースのスキーマ属性を理解します。
この項では、ユーザー・リソースのスキーマ属性について説明します。次の項目が含まれます。
注意:
アカウントおよびエンタイトルメントはOracle Identity Manager SCIMサービスでサポートされません。
表21-2 urn:ietf:params:scim:schemas:core:2.0:User
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
userName |
SVA |
文字列 |
はい |
RW |
name.formatted |
SVA |
文字列 |
いいえ |
RW |
name.familyName |
SVA |
文字列 |
いいえ |
RW |
name.givenName |
SVA |
文字列 |
いいえ |
RW |
name.middleName |
SVA |
文字列 |
いいえ |
RW |
name.honorificPrefix |
SVA |
文字列 |
いいえ |
RW |
name.honorificSuffix |
SVA |
文字列 |
いいえ |
RW |
displayName |
SVA |
文字列 |
いいえ |
RW |
nickName |
SVA |
文字列 |
いいえ |
RW |
profileUrl |
SVA |
文字列 |
いいえ |
RW |
title |
SVA |
文字列 |
いいえ |
RW |
title |
SVA |
文字列 |
いいえ |
RW |
userType |
SVA |
文字列 |
いいえ |
RW |
preferredLanguage |
SVA |
文字列 |
いいえ |
RW |
timezone |
SVA |
文字列 |
いいえ |
RW |
locale |
SVA |
文字列 |
いいえ |
RW |
active |
SVA |
Boolean |
いいえ |
RW |
password |
SVA |
文字列 |
いいえ |
WO |
emails |
CMVA |
該当なし |
いいえ |
RW |
emails[work].value |
SVA |
文字列 |
いいえ |
RW |
emails[<type>].primary |
SVA |
文字列 |
いいえ |
RW |
phoneNumbers |
CMVA |
該当なし |
いいえ |
RW |
phoneNumbers.type |
SVA |
文字列 |
いいえ |
RW |
phoneNumbers[work].value |
SVA |
文字列 |
いいえ |
RW |
phoneNumbers[home].value |
SVA |
文字列 |
いいえ |
RW |
phoneNumbers[mobile].value |
SVA |
文字列 |
いいえ |
RW |
phoneNumber[fax].value |
SVA |
文字列 |
いいえ |
RW |
phoneNumber[pager].value |
SVA |
文字列 |
いいえ |
RW |
phoneNumber[other].value |
SVA |
文字列 |
いいえ |
RW |
ims |
CMVA |
該当なし |
いいえ |
RW |
photos |
CMVA |
該当なし |
いいえ |
RW |
addresses |
CMVA |
該当なし |
いいえ |
RW |
addresses.type |
SVA |
文字列 |
いいえ |
RW |
addresses[<type>].primary |
SVA |
文字列 |
いいえ |
RW |
addresses[work].formatted |
SVA |
文字列 |
いいえ |
RW |
addresses[home].formatted |
SVA |
文字列 |
いいえ |
RW |
addresses[work].streetAddress |
SVA |
文字列 |
いいえ |
RW |
addresses[work].locality |
SVA |
文字列 |
いいえ |
RW |
addresses[work].region |
SVA |
文字列 |
いいえ |
RW |
addresses[work].postalCode |
SVA |
文字列 |
いいえ |
RW |
addresses[work].country |
SVA |
文字列 |
いいえ |
RW |
groups |
CMVA |
該当なし |
いいえ |
RO |
groups.value |
SVA |
文字列 |
いいえ |
RO |
groups.$ref |
SVA |
文字列 |
いいえ |
RO |
groups.type |
SVA |
文字列 |
いいえ |
RO |
entitlements |
SMVA |
文字列 |
いいえ |
RW |
roles |
SMVA |
文字列 |
いいえ |
RW |
x509Certificates |
SMVA |
文字列 |
いいえ |
RW |
表21-3に、SCIMエンタープライズ・ユーザー・スキーマ属性をリストします。
表21-3 urn:ietf:params:scim:schemas:extension:enterprise:2.0:User
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
employeeNumber |
SVA |
文字列 |
いいえ |
RW |
costCenter |
SVA |
文字列 |
いいえ |
RW |
organization |
SVA |
文字列 |
いいえ |
RO |
division |
SVA |
文字列 |
いいえ |
RW |
department |
SVA |
文字列 |
いいえ |
RW |
manager.value |
SVA |
文字列 |
いいえ |
RW |
manager.$ref |
SVA |
文字列 |
いいえ |
RW |
manager.displayName |
SVA |
文字列 |
いいえ |
RO |
表21-4に、SCIM IDM共通ユーザー・スキーマ拡張属性をリストします。
表21-4 urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
createBy.value |
SVA |
文字列 |
いいえ |
RO |
createBy.$ref |
SVA |
文字列 |
いいえ |
RO |
updateBy.value |
SVA |
文字列 |
いいえ |
RO |
updateBy.$ref |
SVA |
文字列 |
いいえ |
RO |
passwd |
CSVA |
|||
passwd.value |
SVA |
文字列 |
いいえ |
WO |
passwd.oldValue |
SVA |
文字列 |
いいえ |
WO |
passwd.sendNotification |
SVA |
文字列 |
いいえ |
WO |
passwd.sendNotificationTo |
SVA |
文字列 |
いいえ |
WO |
passwordMustChange |
SVA |
文字列 |
いいえ |
RO |
passwordExpireDate |
SVA |
文字列 |
いいえ |
RO |
locked.value |
SVA |
文字列 |
いいえ |
RW |
locked.duration |
SVA |
文字列 |
いいえ |
RW |
locked.reason |
SVA |
文字列 |
いいえ |
RO |
locked.on |
SVA |
文字列 |
いいえ |
RO |
challenges |
CMVA |
該当なし |
いいえ |
RW |
challenges.challenge |
SVA |
文字列 |
いいえ |
RW |
challenges.response |
SVA |
文字列 |
いいえ |
RW |
表21-5に、Oracle Identity Governance (OIG)ユーザー・スキーマ拡張属性をリストします。
表21-5 urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
dataLevel |
SVA |
文字列 |
いいえ |
RO |
disabled |
SVA |
文字列 |
いいえ |
RO |
passwordCreateDate |
SVA |
Date |
いいえ |
RO |
passwordCantChange |
SVA |
文字列 |
いいえ |
RO |
passwordNeverExpires |
SVA |
文字列 |
いいえ |
RO |
passwordIsExpired |
SVA |
文字列 |
いいえ |
RO |
passwordWarnDate |
SVA |
Date |
いいえ |
RO |
lastSuccessfulLoginDate |
SVA |
Date |
いいえ |
RO |
lastFailedLoginDate |
SVA |
Date |
いいえ |
RO |
hireDate |
SVA |
Date |
いいえ |
RW |
startDate |
SVA |
Date |
いいえ |
RW |
endDate |
SVA |
Date |
いいえ |
RW |
provisioningDate |
SVA |
Date |
いいえ |
RW |
provisionedDate |
SVA |
Date |
いいえ |
RO |
deprovisioningDate |
SVA |
Date |
いいえ |
RW |
deprovisionedDate |
SVA |
Date |
いいえ |
RO |
automaticallyDeleteOn |
SVA |
Date |
いいえ |
RO |
userLoginAttemptsCounter |
SVA |
Int |
いいえ |
RO |
userPasswordResetAttemptsCounter |
SVA |
Int |
いいえ |
RO |
userMustChangePasswordAtNextLogin |
SVA |
文字列 |
いいえ |
RO |
userPasswordMinAgeDate |
SVA |
Date |
いいえ |
RO |
description |
SVA |
文字列 |
いいえ |
RW |
ldapCommonName |
SVA |
文字列 |
いいえ |
RW |
ldapCommonNameGenerated |
SVA |
文字列 |
いいえ |
RW |
ldapOrganization |
SVA |
文字列 |
いいえ |
RW |
ldapOrganizationalUnit |
SVA |
文字列 |
いいえ |
RW |
ldapDn |
SVA |
文字列 |
いいえ |
RW |
ldapGuid |
SVA |
文字列 |
いいえ |
RW |
poBox |
SVA |
文字列 |
いいえ |
RW |
jobCode |
SVA |
文字列 |
いいえ |
RW |
officeName |
SVA |
文字列 |
いいえ |
RW |
initials |
SVA |
文字列 |
いいえ |
RW |
faLanguage |
SVA |
文字列 |
いいえ |
RW |
faTerritory |
SVA |
文字列 |
いいえ |
RW |
embeddedHelp |
SVA |
文字列 |
いいえ |
RW |
fontSize |
SVA |
文字列 |
いいえ |
RW |
colorContrast |
SVA |
文字列 |
いいえ |
RW |
accessibilityMode |
SVA |
文字列 |
いいえ |
RW |
numberFormat |
SVA |
文字列 |
いいえ |
RW |
dateFormat |
SVA |
文字列 |
いいえ |
RW |
timeFormat |
SVA |
文字列 |
いいえ |
RW |
currency |
SVA |
文字列 |
いいえ |
RW |
summaryRisk |
SVA |
文字列 |
いいえ |
RO |
hasHighRiskRole |
SVA |
文字列 |
いいえ |
RO |
hasHighRiskResource |
SVA |
文字列 |
いいえ |
RO |
hasHighRiskEntitlement |
SVA |
文字列 |
いいえ |
RO |
hasHighRiskProvisioningMethod |
SVA |
文字列 |
いいえ |
RO |
hasHighRiskOpenSod |
SVA |
文字列 |
いいえ |
RO |
hasHighRiskLastCert |
SVA |
文字列 |
いいえ |
RO |
roleSummaryRisk |
SVA |
文字列 |
いいえ |
RO |
accountSummaryRisk |
SVA |
文字列 |
いいえ |
RO |
entitlementSummaryRisk |
SVA |
文字列 |
いいえ |
RO |
riskUpdateDate |
SVA |
文字列 |
いいえ |
RO |
homeOrganization |
CSVA |
該当なし |
いいえ |
RW |
homeOrganization.value |
SVA |
文字列 |
いいえ |
RW |
homeOrganization.$ref |
SVA |
文字列 |
いいえ |
RO |
Organizations |
CMVA |
該当なし |
いいえ |
RO |
organizations.value |
SVA |
文字列 |
いいえ |
RO |
organizations.$ref |
SVA |
文字列 |
いいえ |
RO |
passwordPolicyDescription |
SVA |
文字列 |
いいえ |
RO |
requestId |
SVA |
文字列 |
いいえ |
RO |
IDM PasswordResetterWithChallengesユーザー・スキーマ属性を理解します。
表21-6に、IDM PasswordResetterWithChallengesユーザー・スキーマ属性をリストします。
表21-6 urn:ietf:params:scim:schemas:oracle:core:2.0:PasswordResetterWithChallenges
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
userName |
SVA |
文字列 |
はい |
WO |
Challenges |
CMVA |
該当なし |
はい |
WO |
challenges.challenge |
SVA |
文字列 |
はい |
WO |
challenges.response |
SVA |
文字列 |
はい |
WO |
password |
SVA |
文字列 |
はい |
WO |
IDM PasswordValidatorスキーマ属性を理解します。
表21-7に、IDM PasswordValidatorスキーマ属性をリストします。
表21-7 urn:ietf:params:scim:schemas:oracle:core:2.0:PasswordValidator
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
userRef |
SVA |
文字列 |
はい |
WO |
password |
SVA |
文字列 |
はい |
WO |
IDM UserNameValidatorスキーマ属性を理解します。
表21-8に、IDM UserNameValidatorスキーマ属性をリストします。
表21-8 urn:ietf:params:scim:schemas:oracle:core:2.0:UserNameValidator
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
userName |
SVA |
文字列 |
はい |
WO |
IDM UserNameGeneratorスキーマ属性を理解します。
表21-9に、IDM UserNameGeneratorスキーマ属性をリストします。
表21-9 urn:ietf:params:scim:schemas:oracle:core:2.0:UserNameGenerator
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
name |
CSVA |
該当なし |
はい |
WO |
name.formatted |
SVA |
文字列 |
はい |
WO |
name.familyName |
SVA |
文字列 |
はい |
WO |
name.givenName |
SVA |
文字列 |
はい |
WO |
name.middleName |
SVA |
文字列 |
はい |
WO |
name.honorificSuffix |
SVA |
文字列 |
はい |
WO |
IDM UserNameRecovererスキーマ属性を理解します。
表21-10に、IDM UserNameRecovererスキーマ属性をリストします。
表21-10 urn:ietf:params:scim:schemas:oracle:core:2.0:UserNameRecoverer
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
SVA |
文字列 |
はい |
WO |
グループ・スキーマ属性、IDM共通グループ・スキーマ拡張属性、OIGグループ・スキーマ拡張属性など、グループ・リソースのスキーマ属性を理解します。
この項では、グループ・リソースのスキーマ属性について説明します。次の項目が含まれます。
表21-11に、SCIMグループ・スキーマ属性をリストします。
表21-11 urn:ietf:params:scim:schemas:core:2.0:Group
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
displayName |
SVA |
文字列 |
はい |
RW |
members |
CMVA |
該当なし |
いいえ |
|
members.value |
SVA |
文字列 |
いいえ |
RW |
members.$ref |
SVA |
文字列 |
いいえ |
RW |
表21-12に、IDM共通グループ・スキーマ拡張属性をリストします。
表21-12 urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
createBy.value |
SVA |
文字列 |
いいえ |
RO |
createBy.$ref |
SVA |
文字列 |
いいえ |
RO |
updateBy.value |
SVA |
文字列 |
いいえ |
RO |
updateBy.$ref |
SVA |
文字列 |
いいえ |
RO |
SVA |
文字列 |
いいえ |
RW |
|
description |
SVA |
文字列 |
いいえ |
RW |
owner |
CSVA |
該当なし |
いいえ |
RW |
owner.value |
SVA |
文字列 |
いいえ |
RW |
owner.$ref |
SVA |
文字列 |
いいえ |
RO |
owner.firstName |
SVA |
文字列 |
いいえ |
RO |
owner.lastName |
SVA |
文字列 |
いいえ |
RO |
owner.displayName |
SVA |
文字列 |
いいえ |
RO |
owner.email |
SVA |
文字列 |
いいえ |
RO |
owner.login |
SVA |
文字列 |
いいえ |
RO |
表21-13に、OIGグループ・スキーマ拡張属性をリストします。
表21-13 urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
dataLevel |
SVA |
文字列 |
いいえ |
RO |
namespace |
SVA |
文字列 |
いいえ |
RW |
category |
CSVA |
該当なし |
いいえ |
RW |
category.value |
SVA |
文字列 |
いいえ |
RW |
category.name |
SVA |
文字列 |
いいえ |
RO |
ldapGuid |
SVA |
文字列 |
いいえ |
RO |
ldapDn |
SVA |
文字列 |
いいえ |
RO |
requestId |
SVA |
文字列 |
いいえ |
RO |
accessPolicies.value |
MVA |
文字列 |
いいえ |
RW |
organizationsPublishedTo |
CMVA |
該当なし |
いいえ |
RW |
organizationsPublishedTo.value |
SVA |
文字列 |
いいえ |
RW |
organizationsPublishedTo.$ref |
SVA |
文字列 |
いいえ |
RO |
catalog |
CSVA |
該当なし |
いいえ |
RW |
catalog.id |
SVA |
文字列 |
いいえ |
RO |
catalog.categoryName |
SVA |
文字列 |
いいえ |
RW |
catalog.auditObjectives |
SVA |
文字列 |
いいえ |
RW |
catalog.itemRisk |
SVA |
Integer |
いいえ |
RW |
catalog.userDefinedTags |
SVA |
文字列 |
いいえ |
RW |
catalog.certifiable |
SVA |
Boolean |
いいえ |
RW |
catalog.auditable |
SVA |
Boolean |
いいえ |
RW |
catalog.requestable |
SVA |
Boolean |
いいえ |
RW |
catalog.tags |
SVA |
文字列 |
いいえ |
RO |
catalog.hierarchicalDataAvailable |
SVA |
Boolean |
いいえ |
RO |
catalogApproverUser.value |
SVA |
文字列 |
いいえ |
RW |
catalogApproverUser.$ref |
SVA |
Reference |
いいえ |
RW |
catalogApproverRole.value |
SVA |
文字列 |
いいえ |
RW |
catalogApproverRole.$ref |
SVA |
Reference |
いいえ |
RW |
catalogCertifierUser.value |
SVA |
文字列 |
いいえ |
RW |
catalogCertifierUser.$ref |
SVA |
Reference |
いいえ |
RW |
catalogCertifierRole.value |
SVA |
文字列 |
いいえ |
RW |
catalogCertifierRole.$ref |
SVA |
Reference |
いいえ |
RW |
catalogFulfillmentUser.value |
SVA |
文字列 |
いいえ |
RW |
catalogFulfillmentUser.$ref |
SVA |
Reference |
いいえ |
RW |
catalogFulfillmentRole.value |
SVA |
文字列 |
いいえ |
RW |
catalogFulfillmentRole.$ref |
SVA |
Reference |
いいえ |
RW |
catalogAttributes |
CMVA |
該当なし |
いいえ |
RW |
catalogAttributes.name |
SVA |
文字列 |
いいえ |
RW |
catalogAttributes.value |
SVA |
文字列 |
いいえ |
RW |
catalogAttributes.udf |
SVA |
Boolean |
いいえ |
RW |
catalogAttributes.description |
SVA |
文字列 |
いいえ |
RW |
catalogAttributes.searchable |
SVA |
Boolean |
いいえ |
RW |
catalogAttributes.sortable |
SVA |
Boolean |
いいえ |
RW |
catalogAttributes.certifiable |
SVA |
Boolean |
いいえ |
RW |
catalogAttributes.datatype |
SVA |
文字列 |
いいえ |
RO |
userMembershipRule |
CSVA |
該当なし |
いいえ |
RW |
userMembershipRule.value |
SVA |
文字列 |
いいえ |
RW |
userMembershipRule.evaluate |
SVA |
Boolean |
いいえ |
WO |
OIG組織スキーマ属性を理解します。
表21-14に、OIG組織スキーマ属性をリストします。
表21-14 urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
createBy.value |
SVA |
文字列 |
いいえ |
RO |
createBy.$ref |
SVA |
文字列 |
いいえ |
RO |
updateBy.value |
SVA |
文字列 |
いいえ |
RO |
updateBy.$ref |
SVA |
文字列 |
いいえ |
RO |
dataLevel |
SVA |
文字列 |
いいえ |
RO |
name |
SVA |
文字列 |
いいえ |
RW |
customerType |
SVA |
文字列 |
いいえ |
RW |
status |
SVA |
文字列 |
いいえ |
RW |
disabled |
SVA |
文字列 |
いいえ |
RW |
parent |
CSVA |
該当なし |
いいえ |
RW |
parent.value |
SVA |
文字列 |
いいえ |
RW |
parent.$ref |
SVA |
文字列 |
いいえ |
RO |
parent.name |
SVA |
文字列 |
いいえ |
RO |
passwordPolicy |
CSVA |
該当なし |
いいえ |
RW |
passwordPolicy.value |
SVA |
文字列 |
いいえ |
RW |
passwordPolicy.$ref |
SVA |
文字列 |
いいえ |
RO |
passwordPolicy.name |
SVA |
文字列 |
いいえ |
RO |
certifierUser |
CSVA |
該当なし |
いいえ |
RW |
certifierUser.value |
SVA |
文字列 |
いいえ |
RW |
certifierUser.$ref |
SVA |
文字列 |
いいえ |
RO |
certifierUser.login |
SVA |
文字列 |
いいえ |
RO |
enforceNewPasswordPolicy |
SVA |
文字列 |
いいえ |
RW |
userMembershipRule |
CSVA |
該当なし |
いいえ |
RW |
userMembershipRule.value |
SVA |
文字列 |
いいえ |
RW |
userMembershipRule.evaluate |
SVA |
文字列 |
いいえ |
WO |
members |
CMVA |
該当なし |
いいえ |
RO |
members.value |
SVA |
文字列 |
いいえ |
RO |
members.$ref |
SVA |
文字列 |
いいえ |
RO |
childOrganizations |
CSVA |
該当なし |
いいえ |
RO |
childOrganizations.value |
SVA |
文字列 |
いいえ |
RO |
childOrganizations.$ref |
SVA |
Reference |
いいえ |
RO |
IDMパスワード・ポリシー・スキーマ属性を理解します。
表21-15に、IDMパスワード・ポリシー・スキーマ属性をリストします。
表21-15 urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
name |
SVA |
文字列 |
いいえ |
RW |
description |
SVA |
文字列 |
いいえ |
RW |
maxLength |
SVA |
文字列 |
いいえ |
RW |
minLength |
SVA |
文字列 |
いいえ |
RW |
minAlphas |
SVA |
文字列 |
いいえ |
RW |
minNumerals |
SVA |
文字列 |
いいえ |
RW |
minAlphaNumerals |
SVA |
文字列 |
いいえ |
RW |
minSpecialChars |
SVA |
文字列 |
いいえ |
RW |
maxSpecialChars |
SVA |
文字列 |
いいえ |
RW |
minUpperCase |
SVA |
文字列 |
いいえ |
RW |
minLowerCase |
SVA |
文字列 |
いいえ |
RW |
minUniqueChars |
SVA |
文字列 |
いいえ |
RW |
maxRepeatedChars |
SVA |
文字列 |
いいえ |
RW |
startsWithAlphabet |
SVA |
文字列 |
いいえ |
RW |
minUnicodeChars |
SVA |
文字列 |
いいえ |
RW |
maxUnicodeChars |
SVA |
文字列 |
いいえ |
RW |
firstNameDisallowed |
SVA |
文字列 |
いいえ |
RW |
lastNameDisallowed |
SVA |
文字列 |
いいえ |
RW |
userIdDisallowed |
SVA |
文字列 |
いいえ |
RW |
minPasswordAgeInDays |
SVA |
文字列 |
いいえ |
RW |
passwordWarningAfterInDays |
SVA |
文字列 |
いいえ |
RW |
passwordExpiresAfterInDays |
SVA |
文字列 |
いいえ |
RW |
requiredChars |
SVA |
文字列 |
いいえ |
RW |
disallowedChars |
SVA |
文字列 |
いいえ |
RW |
allowedChars |
SVA |
文字列 |
いいえ |
RW |
disallowedSubstrings |
SVA |
文字列 |
いいえ |
RW |
dictionaryLocation |
SVA |
文字列 |
いいえ |
RW |
dictionaryDelimiter |
SVA |
文字列 |
いいえ |
RW |
numPasswordsInHistory |
SVA |
文字列 |
いいえ |
RW |
maxIncorrectAttempts |
SVA |
文字列 |
いいえ |
RW |
lockoutDuration |
SVA |
文字列 |
いいえ |
RW |
complexPolicy |
SVA |
文字列 |
いいえ |
RW |
challengesEnabled |
SVA |
文字列 |
いいえ |
RW |
challengeSource |
SVA |
文字列 |
いいえ |
RW |
challengeDefaultQuestions.value |
SVA |
文字列 |
いいえ |
RW |
challengeMinQuestions |
SVA |
文字列 |
いいえ |
RW |
challengeMinAnswers |
SVA |
文字列 |
いいえ |
RW |
challengeAllAtOnce |
SVA |
文字列 |
いいえ |
RW |
challengeResponseMinLength |
SVA |
文字列 |
いいえ |
RW |
challengeAllowDuplicateResponses |
SVA |
文字列 |
いいえ |
RW |
challengeMaxIncorrectAttempts |
SVA |
文字列 |
いいえ |
RW |
OIG通知テンプレート・スキーマ属性を理解します。
表21-16に、OIG通知テンプレート・スキーマ属性をリストします。
表21-16 urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
name |
SVA |
文字列 |
はい |
RW |
eventName |
SVA |
文字列 |
はい |
RW |
description |
SVA |
文字列 |
いいえ |
RW |
locales |
CMVA |
該当なし |
いいえ |
RW |
locales.locale |
SVA |
文字列 |
はい |
RW |
locales.encoding |
SVA |
文字列 |
はい |
RW |
locales .subject |
SVA |
文字列 |
はい |
RW |
locales .contentType |
SVA |
文字列 |
はい |
RW |
locales.shortMessage |
SVA |
文字列 |
いいえ |
RW |
locales.longMessage |
SVA |
文字列 |
はい |
RW |
OIGシステム・プロパティ・スキーマ属性を理解します。
表21-17に、OIGシステム・プロパティ・スキーマ属性をリストします。
表21-17 urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:SystemProperty
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
name |
SVA |
文字列 |
はい |
RW |
displayName |
SVA |
文字列 |
いいえ |
RW |
value |
SVA |
文字列 |
いいえ |
RW |
SCIMサービス・プロバイダ構成スキーマ属性を理解します。
表21-18に、SCIMサービス・プロバイダ構成スキーマ属性をリストします。
表21-18 urn:ietf:params:scim:schemas:core:2.0:ServiceProviderConfig
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
documentationUrl |
SVA |
文字列 |
いいえ |
RO |
patch.supported |
SVA |
Boolean |
いいえ |
RO |
bulk.supported |
SVA |
Boolean |
いいえ |
RO |
bulk.maxOperations |
SVA |
Integer |
いいえ |
RO |
bulk.maxPayloadSize |
SVA |
Integer |
いいえ |
RO |
filter.supported |
SVA |
Boolean |
いいえ |
RO |
filter.maxResults |
SVA |
Integer |
いいえ |
RO |
changePassword.supported |
SVA |
Boolean |
いいえ |
RO |
sort.supported |
SVA |
Boolean |
いいえ |
RO |
Etag.supported |
SVA |
Boolean |
いいえ |
RO |
authenticationSchemes.name |
SVA |
文字列 |
いいえ |
RO |
authenticationSchemes.description |
SVA |
文字列 |
いいえ |
RO |
authenticationSchemes.specUrl |
SVA |
文字列 |
いいえ |
RO |
authenticationSchemes.documentationUrl |
SVA |
文字列 |
いいえ |
RO |
SCIMリソース・タイプ・スキーマ属性を理解します。
表21-19に、SCIMリソース・タイプ・スキーマ属性をリストします。
表21-19 urn:ietf:params:scim:schemas:core:2.0:ResourceType
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
name |
SVA |
文字列 |
いいえ |
RO |
description |
SVA |
文字列 |
いいえ |
RO |
endpoint |
SVA |
文字列 |
いいえ |
RO |
schema |
SVA |
文字列 |
いいえ |
RO |
schemaExtensions.schema |
SVA |
文字列 |
いいえ |
RO |
schemaExtensions.required |
SVA |
Boolean |
いいえ |
RO |
SCIMスキーマ属性、OIGスキーマ拡張属性など、スキーマ・リソースのスキーマ属性を理解します。
この項では、スキーマ・リソースのスキーマ属性について説明します。次の項目が含まれます。
表21-20に、SCIMスキーマの属性をリストします。
表21-20 urn:ietf:params:scim:schemas:core:2.0:Schema
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
id |
SVA |
文字列 |
いいえ |
RO |
name |
SVA |
文字列 |
いいえ |
RO |
description |
SVA |
文字列 |
いいえ |
RO |
attributes.name |
SVA |
文字列 |
いいえ |
RO |
attributes.type |
SVA |
文字列 |
いいえ |
RO |
attributes.multiValued |
SVA |
文字列 |
いいえ |
RO |
attributes.description |
SVA |
文字列 |
いいえ |
RO |
attributes.readOnly |
SVA |
Boolean |
いいえ |
RO |
attributes.required |
SVA |
Boolean |
いいえ |
RO |
attributes.mutability |
SVA |
文字列 |
いいえ |
RO |
attributes.returned |
SVA |
文字列 |
いいえ |
RO |
attributes.uniqueness |
SVA |
文字列 |
いいえ |
RO |
attributes.caseExact |
SVA |
Boolean |
いいえ |
RO |
表21-21に、OIGスキーマのスキーマ拡張属性をリストします。
表21-21 urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Schema
SCIM属性 | 属性タイプ | データ型 | 必須 | 可変性 |
---|---|---|---|---|
attributes.indexes |
SVA |
文字列 |
いいえ |
RO |
サポートされている操作タイプは、GET、POST、PUT、PATCHおよびDELETEです。
次の操作タイプがサポートされています。
GET: 1つ以上の完全または部分リソースを取得します。
POST: エンドポイントに応じて、新規リソースを作成するか、検索リクエストを作成します。
PUT: 既存の属性を指定した置換属性のセット(replace)で置換することでリソースを変更します。PUTを使用して新規リソースを作成する必要があります。
PATCH: クライアントが指定した変更のセット(partial updates)でリソースを変更します。
DELETE: リソースを削除します。
操作タイプの詳細は、次のURLを参照してください。
HTTPレスポンス・コードを返すことに加えて、アイデンティティRESTサービスはレスポンスの本文内のエラーをエラー・コードと説明とともに返します。
この項では、エラー・コード、成功コードおよびその意味をリストします。次の項目が含まれます。
エラー状態、HTTPリターン・コードおよびその意味を理解します。
表21-22に、エラー・コードとその意味をリストします。
表21-22 エラー・コードと意味
エラー状態 | HTTPリターン・コード | 意味 |
---|---|---|
入力を解析できない、入力が必要なエンティティと一致しない、または検証失敗 |
400 |
不正なリクエスト: 検証失敗、スキーマ違反 |
リクエスト・リソースが見つからない |
404 |
ADDITIONAL_INFORMATION_INDICATING_NOT_FOUND_OBJECTが見つからない |
ユーザーにアクティビティの実行権限がない。 |
401 |
未認可 |
リクエストされたメソッドがサポートされていない。 |
501 |
使用できないメソッド |
作成されたコンテンツ・タイプをクライアントが受け付けない。 |
406 |
受入れ不可 |
リクエスト・パラメータのセマンティックが正しくない |
422 |
処理不能なエンティティ。ADDITIONAL_INFORMATION_ON_NATURE_OF_ERROR |
クライアント・メディア・タイプがサポートされていない。 |
415 |
サポートされないメディア・タイプ |
依存性のエラーが発生 |
424 |
依存性のエラーが発生。ADDITIONAL_INFORMATION_ON_FAILED_DEPENDENCY |
汎用的なサーバー・エラー |
500 |
内部サーバー・エラー |
競合 |
409 |
指定したバージョン番号が一致しないか、リソースの最新バージョン番号またはサービス・プロバイダが新しい重複リソースの作成を拒否 |
事前の条件設定に失敗 |
412 |
サーバーで最後に取得されたリソースIDが変更されたため、更新に失敗 |
禁止 |
403 |
サーバーは指定されたリソースでリクエストされた操作をサポートしていない |
成功した操作のHTTPリターン・コードとその意味を理解します。
表21-23に、成功コードとその意味をリストします。
表21-23 成功コードと意味
HTTPリターン・コード | 意味 |
---|---|
200 |
正常に処理されました。 |
201 |
リクエストが完了し、新規のリソースが作成されました。 |
204 |
サーバーはリクエストを実行しましたが、レスポンス本文を返しません。 |
SCIMベースAPIは、セルフ・サービス、エンティティ管理、システム・プロパティ管理など、様々なタイプの操作に使用できます。
この項では、次のSCIMベースAPIの使用例を示します。
注意:
SCIMリクエストでユーザー定義フィールド(UDF)を使用できます。UDFがOracle Identity Managerに作成された後、これらはSCIMリソースに通常の属性として自動的に表示されます。通常の属性を持つリクエストとレスポンスに違いはありません。
ユーザー・リソースに関するSCIMベースAPIの使用例を理解します。
この項では、ユーザー・リソースの次の例を示します。
この項では、POST操作タイプを使用した「ユーザーの作成」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ユーザーの作成」操作のリクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:PORT
/iam/governance/scim/v1/Users
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User" ], "userName": "bjensen@example.com", "name": { "familyName": "Jensen", "givenName": "Barbara", "middleName": "Jane", "honorificSuffix": "III" }, "displayName": "Babs Jensen", "profileUrl": "https://HOST_NAME:PORT/bjensen", "emails": [ { "value": "bjensen@example.com", "type": "work" } ], "addresses": [ { "type": "work", "streetAddress": "100 Universal City Plaza", "locality": "Hollywood", "region": "CA", "postalCode": "91608", "country": "USA", "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA" }, { "type": "home", "formatted": "456 Hollywood Blvd\nHollywood, CA 91608 USA" } ], "phoneNumbers": [ { "value": "555-555-5555", "type": "work" }, { "value": "555-555-4444", "type": "mobile" } ], "userType": "Contractor", "title": "Tour Guide", "preferredLanguage":"en-US", "locale": "en-US", "timezone": "America/Los_Angeles", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "employeeNumber": "701984", "costCenter": "4130", "division": "Theme Park", "department": "Tour Operations", "manager": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" } }, "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User": { "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" } } }
「ユーザーの作成」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 201 Created
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User": { "userLoginAttemptsCounter": 0, "passwordIsExpired": "0", "ldapCommonNameGenerated": 0, "userPasswordResetAttemptsCounter": 0, "passwordWarnDate": "2015-04-29T03:24:16.000-07:00", "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" }, "passwordCreateDate": "2015-01-06T03:24:16.000-08:00", "provisionedDate": "2015-01-06T03:24:16.000-08:00", "passwordPolicyDescription": [], "userMustChangePasswordAtNextLogin": "1", "disabled": false, "organizations": [ { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1", "display": "Xellerate Users" } ] }, "displayName": "Babs Jensen", "id": "145", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "passwordExpireDate": "2015-05-06T03:24:16.000-07:00", "locked": { "duration": 0, "value": "0", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/0" } }, "userName": "BJENSEN@EXAMPLE.COM", "emails": [ { "value": "bjensen@example.com", "type": "work" } ], "active": true, "userType": "Contractor", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "employeeNumber": "701984", "manager": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance//v1/Users/1", "displayName": "new display" }, "department": "Tour Operations", "organization": "Xellerate Users" }, "preferredLanguage": "en-US", "phoneNumbers": [ { "value": "555-555-4444", "type": "mobile" }, { "value": "555-555-5555", "type": "work" } ], "name": { "middleName": "Jane", "familyName": "Jensen", "givenName": "Barbara", "honorificSuffix": "III" }, "addresses": [ { "region": "CA", "streetAddress": "100 Universal City Plaza", "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA", "postalCode": "91608", "locality": "Hollywood", "country": "USA", "type": "work" }, { "formatted": "456 Hollywood Blvd\nHollywood, CA 91608 USA", "type": "home" } ], "groups": [ { "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/3", "type": "direct" } ], "timezone": "America/Los_Angeles", "title": "Tour Guide", "meta": { "lastModified": "2015-01-06T03:24:17.000-08:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/145", "created": "2015-01-06T03:24:17.000-08:00", "resourceType": "User" } }
この項では、PUT操作タイプを使用した「ユーザーの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ユーザーの変更」操作(PUT)のリクエストの内容は次のとおりです。
操作とURI: PUT http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Users/355
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User", "urn:ietf:params:scim:schemas:core:2.0:User" ], "userName": "userName_user216_08_09.382323", "name": { "familyName": "familyName2_user216_08_09.382323" }, "userType": "Contractor", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User": { "description": "description2_user216_08_09.382323" }, "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "organization": "org2_post_1404312744114", "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" } } }
「ユーザーの変更」(PUT)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User": { "passwordIsExpired": "0", "userLoginAttemptsCounter": 0, "ldapCommonNameGenerated": 0, "userPasswordResetAttemptsCounter": 0, "passwordWarnDate": "2015-07-02T08:46:57.000-07:00", "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" }, "passwordCreateDate": "2015-03-11T08:46:57.000-07:00", "provisionedDate": "2015-03-11T08:46:57.000-07:00", "passwordPolicyDescription": [ { "value": "Password must not match or contain first name." }, { "value": "Password must not match or contain last name." }, { "value": "Password must contain at least 2 alphabetic character(s)." }, { "value": "Password must be at least 6 character(s) long." }, { "value": "Password must contain at least 1 lowercase letter(s)." }, { "value": "Password must contain at least 1 numeric character(s)." }, { "value": "Password must contain at least 1 uppercase letter(s)." }, { "value": "Password must start with an alphabetic character." }, { "value": "Password must not match or contain user ID." } ], "userMustChangePasswordAtNextLogin": "1", "disabled": false, "organizations": [ { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1", "display": "Xellerate Users" } ], "description": "description2_user216_08_09.382323" }, "displayName": "Babs Jensen", "id": "355", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "passwordExpireDate": "2015-07-09T08:46:57.000-07:00", "locked": { "duration": 0, "value": "0" } }, "userName": "USERNAME_USER216_08_09.382323", "emails": [ { "value": "u1@example.com", "type": "work" } ], "active": true, "userType": "Contractor", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "employeeNumber": "701984", "manager": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1", "displayName": "display" }, "department": "Tour Operations", "organization": "Xellerate Users" }, "preferredLanguage": "en-US", "phoneNumbers": [ { "value": "555-555-4444", "type": "mobile" }, { "value": "555-555-5555", "type": "work" } ], "name": { "middleName": "Jane", "familyName": "familyName2_user216_08_09.382323", "givenName": "Barbara", "honorificSuffix": "III" }, "addresses": [ { "region": "CA", "streetAddress": "100 Universal City Plaza", "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA", "postalCode": "91608", "locality": "Hollywood", "country": "USA", "type": "work" }, { "formatted": "456 Hollywood Blvd\nHollywood, CA 91608 USA", "type": "home" } ], "groups": [ { "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/3", "type": "direct" } ], "timezone": "America/Los_Angeles", "title": "Tour Guide", "meta": { "lastModified": "2015-03-11T08:47:19.000-07:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/355", "created": "2015-03-11T08:46:57.000-07:00", "resourceType": "User" } }
この項では、PATCH操作タイプを使用した「ユーザーの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ユーザーの変更」操作(PATCH)のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Users/355
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations": [ { "op":"replace", "path":"urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User:description, "value":"description3" } ] }
「ユーザーの変更」(PATCH)のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User": { "passwordIsExpired": "0", "userLoginAttemptsCounter": 0, "ldapCommonNameGenerated": 0, "userPasswordResetAttemptsCounter": 0, "passwordWarnDate": "2015-07-02T08:46:57.000-07:00", "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" }, "passwordCreateDate": "2015-03-11T08:46:57.000-07:00", "provisionedDate": "2015-03-11T08:46:57.000-07:00", "passwordPolicyDescription": [ { "value": "Password must not match or contain first name." }, { "value": "Password must not match or contain last name." }, { "value": "Password must contain at least 2 alphabetic character(s)." }, { "value": "Password must be at least 6 character(s) long." }, { "value": "Password must contain at least 1 lowercase letter(s)." }, { "value": "Password must contain at least 1 numeric character(s)." }, { "value": "Password must contain at least 1 uppercase letter(s)." }, { "value": "Password must start with an alphabetic character." }, { "value": "Password must not match or contain user ID." } ], "userMustChangePasswordAtNextLogin": "1", "disabled": false, "organizations": [ { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1", "display": "Xellerate Users" } ], "description": "description3" }, "displayName": "Babs Jensen", "id": "355", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "passwordExpireDate": "2015-07-09T08:46:57.000-07:00", "locked": { "duration": 0, "value": "0" } }, "userName": "USERNAME_USER216_08_09.382323", "emails": [ { "value": "u1@example.com", "type": "work" } ], "active": true, "userType": "Contractor", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "employeeNumber": "701984", "manager": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1", "displayName": "display" }, "department": "Tour Operations", "organization": "Xellerate Users" }, "preferredLanguage": "en-US", "phoneNumbers": [ { "value": "555-555-4444", "type": "mobile" }, { "value": "555-555-5555", "type": "work" } ], "name": { "middleName": "Jane", "familyName": "familyName2_user216_08_09.382323", "givenName": "Barbara", "honorificSuffix": "III" }, "addresses": [ { "region": "CA", "streetAddress": "100 Universal City Plaza", "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA", "postalCode": "91608", "locality": "Hollywood", "country": "USA", "type": "work" }, { "formatted": "456 Hollywood Blvd\nHollywood, CA 91608 USA", "type": "home" } ], "groups": [ { "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/3", "type": "direct" } ], "timezone": "America/Los_Angeles", "title": "Tour Guide", "meta": { "lastModified": "2015-03-11T08:49:17.000-07:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/355", "created": "2015-03-11T08:46:57.000-07:00", "resourceType": "User" } }
この項では、GET操作タイプを使用した「ページ区切りでのユーザーの表示」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ページ区切りでのユーザーの表示」操作のリクエストは次のとおりです。
操作とURI: GET /Users http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Users?attributes=id&startIndex=6&count=5
「ページ区切りでのユーザーの表示」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "totalResults": 5, "itemsPerPage": 5, "startIndex": 6, "Resources": [ { "id": "59" }, { "id": "42" }, { "id": "25" }, { "id": "106" }, { "id": "89" } ] }
次に、検索のフィルタの例を示します。
http://HOST_NAME:PORT/iam/governance/scim/v1/Users?filter=(userName co xel)&attributes=id http://HOST_NAME:PORT/iam/governance/scim/v1/Users?attributes=userName&filter=(userName co 4) and (userName co BUG) http://HOST_NAME:PORT/iam/governance/scim/v1/Users?attributes=userName&filter=(emails.type eq work and emails.value sw u)
注意:
検索フィルタの詳細な説明は、次のURLにあるSCIM REST API IETFドラフトのフィルタリングに関する項を参照してください。
https://tools.ietf.org/html/draft-ietf-scim-api-14#section-3.2.2.2
この項では、DELETE操作タイプを使用した「ユーザーの削除」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ユーザーの削除」操作のリクエストの内容は次のとおりです。
操作とURI: DELETE http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Users/355
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文: NA
この項では、PATCH操作タイプを使用した「ユーザーのロック」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ユーザーのロック」操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Users/356
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"], "Operations": [ { "op":"replace", "path":"urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User:locked", "value" : { "value" : 1, "duration" : 3600 } } ] }
この項では、PATCH操作タイプを使用した「ユーザーのロック解除」操作のリクエストとレスポンスを紹介します。次の項目が含まれます。
「ユーザーのロック解除」操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Users/356
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"], "Operations": [ { "op":"replace", "path":"urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User:locked", "value" : { "value" : 0 } } ] }
この項では、PATCH操作タイプを使用した「新しいパスワードの指定によるパスワードのリセット」操作のリクエストとレスポンスを紹介します。次の項目が含まれます。
「新しいパスワードの指定によるパスワードのリセット」操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Users/356
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"], "Operations": [ { "op": "replace","path": "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User:passwd", "value" : { "value": "newPassw0rd", "sendNotification": "true", "sendNotificationTo": "example2@example.com" } } ] }
この項では、PATCH操作タイプを使用した「自動生成済パスワードによるパスワードのリセット」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「自動生成済パスワードによるパスワードのリセット」のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Users/356
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"], "Operations": [ { "op": "replace", "path": "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User:passwd", "value": { "value": "auto-generate", "sendNotification": "true", "sendNotificationTo": "john.doe@example.com" } } ] }
この項では、GET操作タイプを使用した「ユーザーの表示」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ユーザーの表示」操作のリクエストの内容は次のとおりです。
操作とURI: GET http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Me
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
「ユーザーの表示」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User": { "userLoginAttemptsCounter": 0, "ldapCommonNameGenerated": 0, "userPasswordResetAttemptsCounter": 0, "ldapCommonName": "System Administrator", "passwordWarnDate": "2015-06-30T01:51:27.000-07:00", "lastSuccessfulLoginDate": "2015-03-11T00:00:00.000-07:00", "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" }, "passwordPolicyDescription": [ { "value": "Password must not match or contain first name." }, { "value": "Password must not match or contain last name." }, { "value": "Password must contain at least 2 alphabetic character(s)." }, { "value": "Password must be at least 6 character(s) long." }, { "value": "Password must contain at least 1 lowercase letter(s)." }, { "value": "Password must contain at least 1 numeric character(s)." }, { "value": "Password must contain at least 1 uppercase letter(s)." }, { "value": "Password must start with an alphabetic character." }, { "value": "Password must not match or contain user ID." } ], "disabled": false, "dataLevel": "2", "organizations": [ { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1", "display": "Xellerate Users" } ] }, "displayName": "display", "id": "1", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "passwordExpireDate": "2015-07-07T01:51:27.000-07:00", "locked": { "value": "0" } }, "userName": "XELSYSADM", "emails": [ { "value": "donotreply@example.com", "type": "work" } ], "active": true, "userType": "Full-Time", "name": { "familyName": "Administrator", "givenName": "System" }, "groups": [ { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/1", "type": "direct" }, { "value": "6", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/6", "type": "direct" } ], "meta": { "lastModified": "2015-03-11T08:15:44.000-07:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Me", "created": "2015-03-09T01:51:27.000-07:00", "resourceType": "User" }, "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "organization": "Xellerate Users" } }
この項では、POST操作タイプを使用した「自己登録」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「自己登録」操作のリクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Me
ヘッダー:
Content-Type: application/scim+json
Authorization: NA
X-Requested-By: <random_value>
本文:
{ "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"], "userName": "bjensen@example.com", "name": { "familyName": "Jensen", "givenName": "Barbara", "middleName": "Jane", "honorificSuffix": "III" }, "displayName": "Babs Jensen", "emails": [ { "value": "bjensen@example.com", "type": "work" } ], "userType": "Full-Time", "password":"t1meMa$heen", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User": { "challenges": [ { "challenge":"What is your favorite color?", "response":"color" }, { "challenge":"What is the name of your pet?", "response":"pet" }, { "challenge":"What is the city of your birth?", "response":"city" } ] } }
この項では、PATCH操作タイプを使用した「セルフ・プロファイルの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「セルフ・プロファイルの変更」(PATCH)操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Me
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"], "Operations":[ { "op":"replace", "path":"displayName", "value" : "NEW_NAME" } ] }
「セルフ・プロファイルの変更」(PATCH)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User": { "userLoginAttemptsCounter": 0, "ldapCommonNameGenerated": 0, "userPasswordResetAttemptsCounter": 0, "ldapCommonName": "System Administrator", "passwordWarnDate": "2015-06-30T01:51:27.000-07:00", "lastSuccessfulLoginDate": "2015-03-11T00:00:00.000-07:00", "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" }, "passwordPolicyDescription": [ { "value": "Password must not match or contain first name." }, { "value": "Password must not match or contain last name." }, { "value": "Password must contain at least 2 alphabetic character(s)." }, { "value": "Password must be at least 6 character(s) long." }, { "value": "Password must contain at least 1 lowercase letter(s)." }, { "value": "Password must contain at least 1 numeric character(s)." }, { "value": "Password must contain at least 1 uppercase letter(s)." }, { "value": "Password must start with an alphabetic character." }, { "value": "Password must not match or contain user ID." } ], "disabled": false, "dataLevel": "2", "organizations": [ { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1", "display": "Xellerate Users" } ] }, "displayName": "NEW_NAME", "id": "1", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "passwordExpireDate": "2015-07-07T01:51:27.000-07:00", "locked": { "value": "0" } }, "userName": "XELSYSADM", "emails": [ { "value": "donotreply@example.com", "type": "work" } ], "active": true, "userType": "Full-Time", "name": { "familyName": "Administrator", "givenName": "System" }, "groups": [ { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/1", "type": "direct" }, { "value": "6", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/6", "type": "direct" } ], "meta": { "lastModified": "2015-03-11T08:55:23.000-07:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Me", "created": "2015-03-09T01:51:27.000-07:00", "resourceType": "User" }, "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "organization": "Xellerate Users" } }
この項では、PUT操作タイプを使用した「プロファイルの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「プロファイルの変更」(PUT)操作のリクエストの内容は次のとおりです。
操作とURI: PUT http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Me
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User", "urn:ietf:params:scim:schemas:core:2.0:User" ], "userName": "bjensen@example.com", "name": { "familyName": "Jensen" }, "userType": "Contractor", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "organization": "Xellerate Users", "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" } } }
「プロファイルの変更」(PUT)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User", "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:User": { "userLoginAttemptsCounter": 0, "passwordIsExpired": "0", "ldapCommonNameGenerated": 0, "userPasswordResetAttemptsCounter": 0, "passwordWarnDate": "2015-04-29T03:24:16.000-07:00", "homeOrganization": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1" }, "passwordCreateDate": "2015-01-06T03:24:16.000-08:00", "provisionedDate": "2015-01-06T03:24:16.000-08:00", "passwordPolicyDescription": [], "userMustChangePasswordAtNextLogin": "1", "disabled": false, "organizations": [ { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/1", "display": "Xellerate Users" } ] }, "displayName": "Babs Jensen", "id": "145", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:User": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "passwordExpireDate": "2015-05-06T03:24:16.000-07:00", "locked": { "duration": 0, "value": "0", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/0" } }, "userName": "BJENSEN@EXAMPLE.COM", "emails": [ { "value": "bjensen@example.com", "type": "work" } ], "active": true, "userType": "Contractor", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "employeeNumber": "701984", "manager": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1", "displayName": "new display" }, "department": "Tour Operations", "organization": "Xellerate Users" }, "preferredLanguage": "en-US", "phoneNumbers": [ { "value": "555-555-4444", "type": "mobile" }, { "value": "555-555-5555", "type": "work" } ], "name": { "middleName": "Jane", "familyName": "Jensen", "givenName": "Barbara", "honorificSuffix": "III" }, "addresses": [ { "region": "CA", "streetAddress": "100 Universal City Plaza", "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA", "postalCode": "91608", "locality": "Hollywood", "country": "USA", "type": "work" }, { "formatted": "456 Hollywood Blvd\nHollywood, CA 91608 USA", "type": "home" } ], "groups": [ { "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/3", "type": "direct" } ], "timezone": "America/Los_Angeles", "title": "Tour Guide", "meta": { "lastModified": "2015-01-06T03:24:17.000-08:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/145", "created": "2015-01-06T03:24:17.000-08:00", "resourceType": "User" } }
この項では、POST操作タイプを使用したPasswordResetterWithChallenges操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
PasswordResetterWithChallenges操作のリクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/PasswordResetterWithChallenges
ヘッダー:
Content-Type: application/json
Authorization: NA
X-Requested-By: <random_value>
本文:
{ "schemas": ["urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordResetterWithChallenges"], "userName": "JDOE", "challenges": [ { "challenge":"What is the name of your pet?", "response":"name" }, { "challenge":"What is the city of your birth?", "response":"city" }, { "challenge":"What is your favorite color?", "response":"color" } ], "password": "Welcome3" }
この項では、POST操作タイプを使用したPasswordValidator操作の例を紹介します。次の項目が含まれます。
次のリクエストは、潜在的なパスワードを検証します。パスワードの検証リクエストの正常なレスポンスは、パスワードが有効であることを意味します。
操作とURI: POST http://
HOST_NAME
:PORT
/iam/governance/scim/v1/PasswordValidator
ヘッダー:
Content-Type: application/json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordValidator" ], "userRef": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1", "password": "jijijSSij1" }
この項では、POST操作タイプを使用したUserNameValidator操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
ユーザー名の検証リクエストの正常なレスポンスは、パスワードが有効であることを意味します。次に、リクエストを示します。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/UserNameValidator
ヘッダー:
Content-Type: application/json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas":["urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:UserNameValidator"], "userName": "aUserName" }
この項では、POST操作タイプを使用したUserNameGenerator操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
UserNameGenerator操作のリクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/UserNameGenerator
ヘッダー:
Content-Type: application/json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas":["urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:UserNameGenerator"], "name": { "formatted": "Ms. Barbara J Doe III", "familyName": "Doe", "givenName": "Barbara", "middleName": "Jane", "honorificSuffix": "III" } }
UserNameGenerator操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 201 Created
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:UserNameGenerator" ], "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/UserNameGenerator", "resourceType": "UserNameGenerator" }, "urn:ietf:params:scim:schemas:core:2.0:User": { "userName": "Barbara.Doe@example.com" } }
この項では、POST操作タイプを使用したUserNameRecoverer操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
UserNameRecoverer操作のリクエストは次のとおりです(Authorizationヘッダーなし、認証されていないフロー)。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/UserNameRecoverer
ヘッダー:
Content-Type: application/json
Authorization: NA
X-Requested-By: <random_value>
本文:
{ "schemas": ["urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:UserNameRecoverer"], "email": "myemail@example.com" }
グループ・リソースに関するSCIMベースAPIの使用例を理解します。
この項では、グループ・リソースの次の例を示します。
この項では、GET操作タイプを使用した「ロールの表示」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ロールの表示」操作のリクエストの内容は次のとおりです。
操作とURI: GET http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Groups?attributes=id,displayName
「ロールの表示」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "totalResults": 4, "Resources": [ { "displayName": "Group1", "id": "2" }, { "displayName": "SYSTEM ADMINISTRATORS", "id": "3" }, { "displayName": "Group2", "id": "4" }, { "displayName": "Group3", "id": "5" } ] }
この項では、POST操作タイプを使用した「ロールの作成」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ロールの作成」操作のリクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Groups
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group" ], "displayName": "Group33", "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group": { "email": "group33@example.com", "description": "description1" }, "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group": { "namespace": "Default" } }
「ロールの作成」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 201 Created
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group", "urn:ietf:params:scim:schemas:core:2.0:Group" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group": { "organizationsPublishedTo": [ { "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/3" } ], "category": { "name": "Default", "value": 1 }, "namespace": "Default", "catalog": { "tags": "Group33 Group33 Default", "requestable": true, "certifiable": false, "id": "151", "categoryName": "Role", "auditable": false, "itemRisk": 3, "hierarchicalDataAvailable": false } }, "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "description": "description1", "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "owner": { "lastName": "Administrator", "email": "donotreply@example.com", "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1", "login": "XELSYSADM", "firstName": "System", "displayName": "NEW_NAME" }, "email": "group33@example.com" }, "meta": { "lastModified": "2015-03-11T08:55:57.000-07:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/157", "created": "2015-03-11T08:55:57.000-07:00", "resourceType": "Group" }, "displayName": "Group33", "id": "157" }
この項では、PUT操作タイプを使用した「ロールの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「ロールの変更」(PUT)操作のリクエストの内容は次のとおりです。
操作とURI: PUT http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Groups/157
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group", "urn:ietf:params:scim:schemas:core:2.0:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group": { "organizationsPublishedTo": [ { "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/3" } ], "category": { "name": "Default", "value": 1 }, "namespace": "Default" }, "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group": { "description": "description1", "localeNames": [ { "name": "Group_group09_53_11.228163", "locale": "base" } ], "email": "group_new@example.com" }, "displayName": "Group_group09_53_11.228163" }
「ロールの変更」(PUT)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
場所: https://
HOST_NAME
:
PORT
/Groups/157
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group", "urn:ietf:params:scim:schemas:core:2.0:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group": { "organizationsPublishedTo": [ { "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/3" } ], "category": { "name": "Default", "value": 1 }, "namespace": "Default" }, "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "description": "description1", "localeNames": [ { "name": "Group_group09_53_11.228163", "locale": "base" } ], "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "owner": { "lastName": "Administrator", "email": "donotreply@example.com", "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1", "login": "XELSYSADM", "displayName": "System Administrator", "firstName": "System" }, "email": "group_new@example.com" }, "meta": { "lastModified": "2015-01-05T06:59:25.000-08:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/157", "created": "2015-01-05T06:55:14.000-08:00", "resourceType": "Group" }, "displayName": "Group_group09_53_11.228163", "id": "157" }
この項では、PATCH操作タイプを使用した「ロールの変更」操作の例を紹介します。次の項目が含まれます。
「ロールの変更」(PATCH)操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Groups/153
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations": [ { "op":"replace" , "path":"urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group:description", "value":"description3" } ] }
「ロールの変更」(PATCH)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group", "urn:ietf:params:scim:schemas:core:2.0:Group" ], "urn:ietf:params:scim:schemas:extension:oracle:2.0:OIG:Group": { "organizationsPublishedTo": [ { "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/3" } ], "category": { "name": "Default", "value": 1 }, "namespace": "Default", "catalog": { "tags": "replace_catalog_requestable_6587843 replace_catalog_requestable_6587843 Default", "requestable": true, "certifiable": false, "id": "147", "categoryName": "Role", "auditable": false, "itemRisk": 3, "hierarchicalDataAvailable": false } }, "urn:ietf:params:scim:schemas:extension:oracle:2.0:IDM:Group": { "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "description": "description3", "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "owner": { "lastName": "Administrator", "email": "donotreply@example.com", "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1", "login": "XELSYSADM", "firstName": "System", "displayName": "NEW_NAME" } }, "meta": { "lastModified": "2015-03-11T08:59:16.000-07:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Groups/153", "created": "2015-03-11T08:13:11.000-07:00", "resourceType": "Group" }, "displayName": "replace_catalog_requestable_6587843", "id": "153" }
この項では、GET操作タイプを使用した「組織の表示」操作の例を紹介します。次の項目が含まれます。
「組織の表示」操作のリクエストの内容は次のとおりです。
操作とURI: GET http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Organizations/148
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
「組織の表示」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
場所: https://
HOST_NAME
:
PORT
/Organization/148
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization" ], "parent": { "name": "Top", "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/3" }, "name": "org_pcu3_1426086587854", "passwordPolicy": { "name": "ppchg_1426086587854", "value": "94" }, "id": "148", "meta": { "lastModified": "2015-03-11T08:16:00.000-07:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/148", "created": "2015-03-11T08:16:00.000-07:00", "resourceType": "Organization" }, "customerType": "Company", "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "enforceNewPasswordPolicy": "Yes", "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "status": "Active", "members": [ { "value": "353", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/353" } ] }
この項では、POST操作タイプを使用した「組織の作成」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「組織の作成」操作のリクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Organizations
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization" ], "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization": { "name": "organization16_08_50.141529", "customerType": "Scim1" } }
「組織の作成」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 201 Created
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization" ], "parent": { "name": "Top", "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/3" }, "name": "organization16_08_50.141529", "id": "77", "meta": { "lastModified": "2015-02-06T07:06:46.000-08:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/77", "created": "2015-02-06T07:06:46.000-08:00", "resourceType": "Organization" }, "customerType": "Scim1", "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "enforceNewPasswordPolicy": "Yes", "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "status": "Active" }
この項では、PUT操作タイプを使用した「組織の変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「組織の変更」(PUT)操作のリクエストの内容は次のとおりです。
操作とURI: PUT http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Organizations/77
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization" ], "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization": { "name": "organization16_08_53.883452", "customerType": "Scim2" } }
「組織の変更」(PUT)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization" ], "parent": { "name": "Top", "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/3" }, "name": "organization16_08_53.883452", "id": "77", "meta": { "lastModified": "2015-02-06T07:09:27.000-08:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/77", "created": "2015-02-06T07:06:46.000-08:00", "resourceType": "Organization" }, "customerType": "Scim2", "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "enforceNewPasswordPolicy": "Yes", "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "status": "Active" }
この項では、PATCH操作タイプを使用した「組織の変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「組織の変更」(PATCH)操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Organizations/77
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations": [ { "op":"replace", "path":"customerType", "value":"Scim3" } ] }
「組織の変更」(PATCH)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:Organization" ], "parent": { "name": "Top", "value": "3", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/3" }, "name": "organization16_08_53.883452", "id": "77", "meta": { "lastModified": "2015-02-06T07:13:19.000-08:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/Organizations/77", "created": "2015-02-06T07:06:46.000-08:00", "resourceType": "Organization" }, "customerType": "Scim3", "createBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "enforceNewPasswordPolicy": "Yes", "updateBy": { "value": "1", "$ref": "http://HOST_NAME:PORT/iam/governance/scim/v1/Users/1" }, "status": "Active" }
この項では、DELETE操作タイプを使用した「組織の削除」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「組織の削除」操作のリクエストの内容は次のとおりです。
操作とURI: DELETE http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/Organizations/77
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
パスワード・ポリシー・リソースに関するSCIMベースAPIの使用例を理解します。
この項では、パスワード・ポリシー・リソースの次の例を示します。
この項では、GET操作タイプを使用した「パスワード・ポリシーの表示」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「パスワード・ポリシーの表示」操作のリクエストの内容は次のとおりです。
操作とURI: GET http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/PasswordPolicies?filter=(urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy:allowedChars co q)&attributes=id,description,name
「パスワード・ポリシーの表示」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "totalResults": 3, "Resources": [ { "id": "2", "name": "pwp1_1423213466123", "description": "1" }, { "id": "6", "name": "pwp_q_3466186", "description": "pwp_q_3466186" }, { "id": "36", "name": "p1214_1423213645161" } ] }
この項では、POST操作タイプを使用した「パスワード・ポリシーの作成」操作の例を紹介します。内容は次のとおりです。
「パスワード・ポリシーの作成」操作のリクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/PasswordPolicies
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy" ], "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy": { "name":"pwdpol0901258070", "description":"complex password policy for ST org", "passwordWarningAfterInDays": 20, "passwordExpiresAfterInDays": 30, "minPasswordAgeInDays": 10, "userIdDisallowed": "false", "minLength": 3, "maxLength": 8, "firstNameDisallowed": "true", "challengeSource": 1, "challengeMinQuestions": 3, "challengeMinAnswers": 2, "challengeResponseMinLength": 5, "challengeAllowDuplicateResponses": "false", "challengeMaxIncorrectAttempts": 5, "challengeDefaultQuestions": [ { "value": "what is your favorite color" }, { "value": "what is name of your pet" }, { "value": "which is your favorite movie" }, { "value": "which is your favorite sport" } ] } }
「パスワード・ポリシーの作成」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 201 Created
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy" ], "challengesEnabled": false, "id": "49", "challengeSource": 1, "minLength": 3, "startsWithAlphabet": false, "description": "complex password policy for ST org", "name": "pwdpol0901258070", "complexPolicy": false, "challengeDefaultQuestions": [ { "value": "what is your favorite color" }, { "value": "what is name of your pet" }, { "value": "which is your favorite movie" }, { "value": "which is your favorite sport" } ], "challengeAllAtOnce": true, "minPasswordAgeInDays": 10, "passwordWarningAfterInDays": 20, "challengeResponseMinLength": 5, "userIdDisallowed": false, "maxLength": 8, "challengeMinQuestions": 3, "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/PasswordPolicies/49", "resourceType": "PasswordPolicy" }, "challengeMaxIncorrectAttempts": 5, "challengeMinAnswers": 2, "passwordExpiresAfterInDays": 30, "challengeAllowDuplicateResponses": false, "lastNameDisallowed": false, "firstNameDisallowed": true, "dictionaryDelimiter": "\u0000" }
この項では、PUT操作タイプを使用した「パスワード・ポリシーの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「パスワード・ポリシーの変更」(PUT)操作のリクエストの内容は次のとおりです。
操作とURI: PUT http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/PasswordPolicies/49
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy" ], "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy": { "name":"pwdpol0905770857", "description":"complex password policy for ST org", "passwordWarningAfterInDays": 20, "passwordExpiresAfterInDays": 30, "minPasswordAgeInDays": 10, "userIdDisallowed": "false", "minLength": 3, "maxLength": 8, "firstNameDisallowed": "true", "challengeSource": 1, "challengeMinQuestions": 3, "challengeMinAnswers": 2, "challengeResponseMinLength": 5, "challengeAllowDuplicateResponses": "false", "challengeMaxIncorrectAttempts": 5, "challengeDefaultQuestions": [ { "value": "what is your favorite car" }, { "value": "what is name of your truck" }, { "value": "which is your favorite bicycle" }, { "value": "which is your favorite shoe" } ] } }
「パスワード・ポリシーの変更」(PUT)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy" ], "challengesEnabled": false, "id": "49", "challengeSource": 1, "minLength": 3, "startsWithAlphabet": false, "description": "complex password policy for ST org", "name": "pwdpol0905770857", "complexPolicy": false, "challengeDefaultQuestions": [ { "value": "what is your favorite car" }, { "value": "what is name of your truck" }, { "value": "which is your favorite bicycle" }, { "value": "which is your favorite shoe" } ], "challengeAllAtOnce": true, "minPasswordAgeInDays": 10, "passwordWarningAfterInDays": 20, "challengeResponseMinLength": 5, "userIdDisallowed": false, "maxLength": 8, "challengeMinQuestions": 3, "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/PasswordPolicies/49", "resourceType": "PasswordPolicy" }, "challengeMaxIncorrectAttempts": 5, "challengeMinAnswers": 2, "passwordExpiresAfterInDays": 30, "challengeAllowDuplicateResponses": false, "lastNameDisallowed": false, "firstNameDisallowed": true, "dictionaryDelimiter": "\u0000" }
この項では、PATCH操作タイプを使用した「パスワード・ポリシーの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「パスワード・ポリシーの変更」(PATCH)操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/PasswordPolicies/49
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations": [ { "op":"replace", "path":"firstNameDisallowed", "value":"false" } ] }
「パスワード・ポリシーの変更」(PATCH)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:IDM:PasswordPolicy" ], "challengesEnabled": false, "id": "49", "challengeSource": 1, "minLength": 3, "startsWithAlphabet": false, "description": "complex password policy for ST org", "name": "pwdpol0905770857", "complexPolicy": false, "challengeDefaultQuestions": [ { "value": "what is your favorite car" }, { "value": "what is name of your truck" }, { "value": "which is your favorite bicycle" }, { "value": "which is your favorite shoe" } ], "challengeAllAtOnce": true, "minPasswordAgeInDays": 10, "passwordWarningAfterInDays": 20, "challengeResponseMinLength": 5, "userIdDisallowed": false, "maxLength": 8, "challengeMinQuestions": 3, "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/PasswordPolicies/49", "resourceType": "PasswordPolicy" }, "challengeMaxIncorrectAttempts": 5, "challengeMinAnswers": 2, "passwordExpiresAfterInDays": 30, "challengeAllowDuplicateResponses": false, "lastNameDisallowed": false, "firstNameDisallowed": false, "dictionaryDelimiter": "\u0000" }
この項では、DELETE操作タイプを使用した「パスワード・ポリシーの削除」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「パスワード・ポリシーの削除」操作のリクエストの内容は次のとおりです。
操作とURI: DELETE http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/PasswordPolicies/49
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
通知テンプレート・リソースに関するSCIMベースAPIの使用例を理解します。
この項では、通知テンプレート・リソースの次の例を示します。
この項では、GET操作タイプを使用した「通知テンプレートの表示」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「通知テンプレートの表示」操作のリクエストの内容は次のとおりです。
操作とURI: GET http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/NotificationTemplates?attributes=id,name
「通知テンプレートの表示」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "totalResults": 4, "Resources": [ { "name": "AddProxyNotificationTemplate", "id": "12" }, { "name": "BulkRequestCreation", "id": "6" }, { "name": "CreateUserSelfServiceNotification", "id": "7" }, { "name": "UserDeletedNotificationTemplate", "id": "10" } ] }
この項では、POST操作タイプを使用した「通知テンプレートの作成」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「通知テンプレートの作成」操作のリクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/NotificationTemplates/
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate" ], "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate": { "name":"notificationtemplate16_09_14.724166_1", "eventName":"AddProxy", "description":"myTemplate", "locales": [ { "locale": "dddd", "subject": "Notification for contractors 1", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "shortMessage": "short message1", "longMessage": "long message1" }, { "locale": "eeee", "subject": "Notification for contractors 2", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "shortMessage": "short message2", "longMessage": "long message2" } ] } }
「通知テンプレートの作成」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 201 Created
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate" ], "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/NotificationTemplates/25", "resourceType": "NotificationTemplate" }, "name": "notificationtemplate16_09_14.724166_1", "eventName": "AddProxy", "locales": [ { "subject": "Notification for contractors 2", "locale": "eeee", "shortMessage": "short message2", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "longMessage": "long message2" }, { "subject": "Notification for contractors 1", "locale": "dddd", "shortMessage": "short message1", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "longMessage": "long message1" } ], "description": "myTemplate", "id": "25" }
この項では、PUT操作タイプを使用した「通知テンプレートの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「通知テンプレートの変更」(PUT)操作のリクエストの内容は次のとおりです。
操作とURI: PUT http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/NotificationTemplates/25
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate" ], "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate": { "name":"notificationtemplate16_09_17.742004_2", "eventName":"AddProxy", "description":"Template to notify contractors after password has been reset", "locales": [ { "subject": "Notification for contractors 1", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "shortMessage": "short message1", "longMessage": "long message1", "locale": "ffff" }, { "subject": "Notification for contractors 2", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "shortMessage": "short message2", "longMessage": "long message2", "locale": "gggg" } ] } }
「通知テンプレートの変更」(PUT)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate" ], "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/NotificationTemplates/25", "resourceType": "NotificationTemplate" }, "name": "notificationtemplate16_09_14.724166_1", "eventName": "AddProxy", "locales": [ { "subject": "Notification for contractors 2", "locale": "gggg", "shortMessage": "short message2", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "longMessage": "long message2" }, { "subject": "Notification for contractors 1", "locale": "ffff", "shortMessage": "short message1", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "longMessage": "long message1" } ], "description": "Template to notify contractors after password has been reset", "id": "25" }
この項では、PATCH操作タイプを使用した「通知テンプレートの変更」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「通知テンプレートの変更」(PATCH)操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/NotificationTemplates/25
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations": [ { "op":"replace", "path":"description", "value":"description3" } ] }
「通知テンプレートの変更」(PATCH)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:NotificationTemplate" ], "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/NotificationTemplates/25", "resourceType": "NotificationTemplate" }, "name": "notificationtemplate16_09_14.724166_1", "eventName": "AddProxy", "locales": [ { "subject": "Notification for contractors 2", "locale": "gggg", "shortMessage": "short message2", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "longMessage": "long message2" }, { "subject": "Notification for contractors 1", "locale": "ffff", "shortMessage": "short message1", "encoding": "UTF-8", "contentType": "text/html, charset=UTF-8", "longMessage": "long message1" } ], "description": "description3", "id": "25" }
この項では、DELETE操作タイプを使用した「通知テンプレートの削除」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「通知テンプレートの削除」操作のリクエストの内容は次のとおりです。
操作とURI: DELETE http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/NotificationTemplates/12
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
システム・プロパティ・リソースに関するSCIMベースAPIの使用例を理解します。
この項では、システム・プロパティ・リソースの次の例を示します。
この項では、GET操作タイプを使用した「システム・プロパティの表示」操作のリクエストとレスポンスの例を紹介します。次の項目が含まれます。
「システム・プロパティの表示」操作のリクエストの内容は次のとおりです。
操作とURI: GET http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/SystemProperties?filter=(name eq AllowDisabledManagers)
「システム・プロパティの表示」操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "totalResults": 1, "Resources": [ { "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:SystemProperty" ], "id": "40", "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/SystemProperties/40", "resourceType": "SystemProperty" }, "value": "FALSE", "name": "AllowDisabledManagers", "displayName": "Is disabled manager allowed" } ] }
この項では、PATCH操作タイプを使用した「システム・プロパティの変更」操作の例を紹介します。次の項目が含まれます。
「システム・プロパティの変更」(PATCH)操作のリクエストの内容は次のとおりです。
操作とURI: PATCH http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/SystemProperties/27
ヘッダー:
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations": [ { "op":"replace", "path":"displayName", "value":"new_displayName_for_systemProperty" } ] }
「システム・プロパティの変更」(PATCH)操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:schemas:oracle:core:2.0:OIG:SystemProperty" ], "id": "27", "meta": { "lastModified": "2015-02-05T08:44:04.000-08:00", "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/SystemProperties/27", "created": "2015-02-05T08:44:04.000-08:00", "resourceType": "SystemProperty" }, "value": "NONE", "name": "OIM.ChallengeQuestionModificationURL", "displayName": "new_displayName_for_systemProperty" }
GET操作タイプを使用したサービス・プロバイダ構成操作のリクエストとレスポンスのSCIMベースAPIの使用例を理解します。
この項の内容は次のとおりです。
サービス・プロバイダ構成操作のリクエストの内容は次のとおりです。
操作とURI: GET http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/ServiceProviderConfigs
サービス・プロバイダ構成操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "totalResults": 1, "Resources": [ { "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:ServiceProviderConfig" ], "patch": { "supported": true }, "meta": { "location": "http://HOST_NAME:PORT/iam/governance/scim/v1/ServiceProviderConfigs", "resourceType": "ServiceProviderConfig" }, "bulk": { "maxPayloadSize": 1048576, "supported": false, "maxOperations": 1000 }, "authenticationSchemes": [ { "documentationUrl": "http://HOST_NAME/help/httpBasic.htm", "specUrl": "http://www.ietf.org/rfc/rfc2617.txt", "description": "Authentication Scheme using the Http Basic Standard", "name": "HTTP Basic" } ], "documentationUrl": "http://HOST_NAME", "changePassword": { "supported": true }, "etag": { "supported": false }, "sort": { "supported": true }, "filter": { "supported": true, "maxResults": 200 } } ] }
リソース・タイプ管理操作のリクエストの内容は次のとおりです。
操作とURI: GET http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/ResourceTypes?attributes=name
リソース・タイプ管理操作のレスポンスの内容は次のとおりです。
ステータス: HTTP/1.1 200 OK
本文:
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "totalResults": 15, "Resources": [ { "name": "User" }, { "name": "PasswordValidator" }, { "name": "UserNameRecoverer" }, { "name": "Schema" }, { "name": "ServiceProviderConfig" }, { "name": "Organization" }, { "name": "Request" }, { "name": "Group" }, { "name": "PasswordPolicy" }, { "name": "SystemProperty" }, { "name": "NotificationTemplate" }, { "name": "ResourceType" }, { "name": "PasswordResetterWithChallenges" }, { "name": "UserNameValidator" }, { "name": "UserNameGenerator" } ] }
リクエストは、リソース検索の代替方法であるPOST [prefix]/.search
で発行されます。URLでパラメータを渡すかわりに、この項の例に示すように、POST本文でリクエスト・パラメータを渡します。リクエストの内容は次のとおりです。
操作とURI: POST http://
HOST_NAME
:
PORT
/iam/governance/scim/v1/
Users/.search
Content-Type: application/scim+json
認可: Bearer h480djs93hd8
X-Requested-By: <random_value>
本文:
{
"schemas":["urn:ietf:params:scim:api:messages:2.0:SearchRequest"],
"attributes": [ "id", "userName" ],
"filter": "userType eq \"Employee\" and (emails [type eq \"work\" and value co \"HOST_NAME\"] or name.givenName co \"doe\")",
"startIndex":1,
"count":2,
"sortBy": "userName",
"sortOrder": "ascending"
}
SCIMリソースは、カスタムOWSMポリシー、カスタム・リクエスト・ヘッダーおよびCORSホワイトリストを使用して保護されます。
SCIMリソースは、Oracle Identity Managerのインストールまたはアップグレード時にデフォルトで作成されるカスタムOracle Web Services Manager (OWSM)ポリシーoracle/multi_token_rest_service_policy
およびoracle/no_authentication_service_policy
によって保護されます。これらのポリシーは変更できません。
これらのポリシーは、トークンがクライアントから送信されたときに次のいずれかの認証ポリシーを強制するか、トークンが指定されていない場合は匿名を許可します。
HTTP Basic
HTTPヘッダー内のSAML 2.0 Bearerトークン
HTTP OAMセキュリティ
SPNEGO over HTTPセキュリティ
HTTPヘッダー内のJWTトークン
oracle/multi_token_rest_service_policy
およびoracle/no_authentication_service_policy
ポリシーの詳細は、グローバル・ポリシー・アタッチメントの理解を参照してください。
カスタム・リクエスト・ヘッダーを使用して、CSRF攻撃からSCIMリソースを保護できます。
クロスサイト・リクエスト・フォージェリ(CSRF)は、エンド・ユーザーが現在認証されているWebアプリケーション上で、意図しない操作をユーザーに強制的に実行させる攻撃です。CSRF攻撃は特に、状態を変化させるリクエストを対象とし、偽造されたリクエストに対するレスポンスを確認する手段が攻撃者にはないため、データを盗むことが目的ではありません。電子メールやチャットを通じてリンクを送信するといったソーシャル・エンジニアリングを利用することで、攻撃者は、Webアプリケーションのユーザーに攻撃者が選択した操作を巧みに実行させることが可能です。被害者が通常ユーザーである場合、CSRF攻撃が成功すると、送金や電子メール・アドレスの変更など、状態を変化させるリクエストをユーザーに強制的に実行させることができます。被害者が管理アカウントを持っている場合、CSRF攻撃を受けると、Webアプリケーション全体が危険にさらされる可能性があります。
CSRF攻撃は、悪意のあるリクエストを被害者が送信するよう仕向けます。これにより、被害者の識別情報や権限を継承し、被害者が意図していない機能をかわりに実行します。ほとんどのサイトでは、ユーザーのセッションCookie、IPアドレス、Windowsドメイン資格証明など、サイトに関連するあらゆる資格証明がブラウザ・リクエストに自動的に含まれます。そのため、ユーザーが現在、サイトに対して認証されていれば、サイトでは、被害者から送信された偽造リクエストと被害者から送信された正規のリクエストを区別する手段がありません。
シノニム
CSRF攻撃は、XSRF、シー・サーフ、セッション・ライディング、クロスサイト・リファレンス・フォージェリ、ホスタイル・リンキングなど、他の名称で呼ばれることもあります。
Oracle Identity Managerに対するHTTPリクエストにはoimjsessionid CookieまたはSSOトークンが自動的に含まれるため、/Tokens呼出しにはCSRF保護が必要です。/Tokenエンドポイントまたはファサード・トークンWebアプリケーションへのリンクをクリックするよう仕向けられたユーザーが意図せず/Token呼出しに成功する可能性があるため、一部のシナリオではCSRF保護が必要です。特に、Oracle Identity Manager UIに対して認証を行うシナリオは、HTTP Basic認証シナリオのように、CSRF攻撃に対して脆弱です。トークン・サービスでは、クライアントがCSRFを受けやすいかどうかを見分けることができないため、トークン・サービス、ファサード・トークンWebアプリケーションおよび/Tokenサービスへのすべての呼出しをCSRFから保護する必要があります。
Oracle Identity Managerとの間でHTTPセッションが確立される場合、/Token実装でリクエスト内のシンクロナイザ・トークンを強制できます。ただし、このメカニズムをHTTP Basic認証で使用することはできません。
かわりに、Oracle Identity ManagerのSCIMおよびREST APIに対するリクエストが別のオリジンからのものである場合、Originヘッダーを使用してCSRFを強制できます。
CSRF保護を強制するには、Originリクエスト・ヘッダーが必要であり、CORS許可オリジンの計算が使用されます。
CSRFに対する防御策として、有効なユーザーのみがわかるカスタム・リクエスト・ヘッダーを使用する方法があります。使用するカスタム・ヘッダーは次のとおりです。
X-Requested-By: <Random_value>
このアプローチには、通常はUIを変更する必要がないこととサーバー側の状態を使用しないことの2つの利点があり、CORS保護と組み合せることで堅牢なシステムになります。
このヘッダーは、PUT、POST、PATCH、DELETEなど、システムの状態を変更する可能性があるすべてのHTTPコールに必要です。このようなコールでこのヘッダーが指定されていない場合、SCIMサービスは、特にGET以外のHTTPメソッドについて、 HTTP 400
エラー・コードを返します。
オリジン・ホワイトリストを使用して、クロスオリジンHTTPリクエストを制限できます。
あるリソースが、自身が提供されたものとは異なるドメインまたはポートのリソースをリクエストする場合、最初のリソースはクロスオリジンHTTPリクエストを行います。たとえば、http://domain-a.com
から提供されたHTMLページがhttp://domain-b.com/image.jpg
に対して<img> src
リクエストを行う場合などです。Web上の多くのページは、CSSスタイルシート、イメージ、スクリプトなどのリソースを別のドメインからロードします。
セキュリティ上の理由から、ブラウザでは、スクリプト内から開始されたクロスオリジンHTTPリクエストが制限されます。
Cross-Origin Resource Sharing (CORS)メカニズムにより、Webサーバーのクロスドメイン・アクセス制御が実現し、ドメイン間の安全なデータ転送が可能になります。CORSおよびCORSヘッダーの一般情報は、Mozilla Development NetworkのCORSページを参照してください。
Cross-Origin Resource Sharingの規格は、Webブラウザを使用して情報を読み取ることを許可されたオリジンのセットをサーバーで記述するための新しいHTTPヘッダーを追加することにより機能します。ヘッダーのタイプ、認証、キャッシングなど、HTTPヘッダーの詳細は、Mozilla Development NetworkのHTTP headersページを参照してください。
また、サーバーのデータに副次的影響をもたらす可能性があるHTTPリクエスト・メソッドについては(特に、GET以外のHTTPメソッドや、POSTの使用については)、ブラウザでリクエストをプリフライトし、HTTP OPTIONSリクエスト・メソッドを使用して、サポートされているメソッドをサーバーから収集し、サーバーからの承認に基づいて、実際のHTTPリクエスト・メソッドを使用して実際のリクエストを送信することが仕様で規定されています。HTTP OPTIONSメソッドの構文と例は、Mozilla Development NetworkのOPTIONSページを参照してください。
サーバーでは、CookieやHTTP認証データを含む資格証明をリクエストとともに送信する必要があるかどうかをクライアントに通知することもできます。
Oracle Identity Managerデプロイメントとは異なるWeb層からHTML5/JSアプリケーションがロードされた場合、Webブラウザの同一オリジン・ポリシーにより、アプリケーションのJSはOracle Identity ManagerのSCIMおよびRESTリソースにアクセスできません。CORSは、この制限を回避するためのメカニズムです。SCIMおよびJWT用のCORSの実装では、構成可能なAccess-Control-Allow-Origin、具体的には、デプロイメントにあわせて構成可能なホワイトリストがサポートされています。
構成可能なホワイトリストは、Oracle Identity ManagerのXL.AllowedOrigins
システム・プロパティに保持されます。このプロパティで指定したオリジンのみが、SCIMおよびJWTリソースへのアクセスを許可されます。
このホワイトリストには、許可するすべてのオリジンのカンマ区切りリストが含まれている必要があります。MozillaおよびChrome拡張機能は対象外です。
指定するオリジンは、次の形式の有効なURLである必要があります。
<scheme>://<host>.<domain>/<page>
次に例を示します。
http://myhost.example.mydomain.com/index.php
XL.AllowedOrigins
システム・プロパティの値を指定する際のガイドラインは、Oracle Identity Governanceの管理のOracle Identity Governanceのデフォルト以外のシステム・プロパティを参照してください。
Identity Governance RESTサービスは、Oracle RESTカタログを通じてアイデンティティ・セルフ・サービス、トークン・サービス、アプリケーション管理およびデプロイメント・マネージャのAPIを提供します。
Oracle Identity Governance RESTサービスでは、Oracle RESTカタログ内の次のAPIがサポートされています。
セルフ・サービス: ドキュメントについては、Oracle Identity Governance Self Service REST APIを参照してください。
Javaトークン・サービス: ドキュメントについては、Oracle Identity Governance Token Service REST APIを参照してください。
アプリケーション管理: ドキュメントについては、Oracle Identity Governance Application Management REST APIを参照してください。
デプロイメント・マネージャ: ドキュメントについては、Oracle Identity Governance Deployment Manager REST APIを参照してください。