クイック・スタート

次のタスクを実行することにより、環境を設定し、Oracle Unified Directory SCIM REST APIを使用して最初のAPIを作成します。

前提条件

前提条件	詳細情報
cURLのインストール	「cURLの使用」
認証の設定	「認証」
OUDのインストール	『Oracle Fusion Middleware Oracle Unified Directoryのインストール』を参照してください
OUDユーザー・アカウントおよびアクセス制御命令(ACI)が追加されていること。	Oracle Unified Directory SCIM REST APIインタフェースでは、OUDで構成されたACIがサポートされています。OUDでは、セキュリティ上の理由からデフォルトでACIが制限されています。ユースケース用に設計されたデータ・アクセス要件に従って、ACIを更新または構成する必要があります。 Oracle Fusion Middleware Oracle Unified Directory管理者ガイドのデータへのアクセスの制御に関する項を参照してください
接続ハンドラが構成されていること。	SCIM REST APIに対してHTTPベースの通信をサポートするように接続ハンドラを構成する必要があります。 dsconfigコマンドを実行して、HTTP/HTTPS接続ハンドラを構成します。Oracle Fusion Middleware Oracle Unified Directory管理者ガイドのSCIM REST APIに関する項を参照してください。
JKSキーストアとJKS信頼マネージャ・プロバイダが構成されていること	LDAPS接続ハンドラがOUDインスタンスに対して設定されていない場合、HTTPS接続ハンドラを設定する前に、cn=JKS,cn=Key Manager Providers,cn=configおよびcn=JKS,cn=Trust Manager Providers,cn=configを構成する必要があります cn=JKS,cn=Key Manager Providers,cn=configを構成するには、Oracle Fusion Middleware Oracle Unified Directory管理者ガイドのJKSキー・マネージャ・プロバイダの使用に関する項を参照してください。 cn=JKS,cn=Trust Manager Providers,cn=configを構成するには、Oracle Fusion Middleware Oracle Unified Directory管理者ガイドの信頼マネージャ・プロバイダの構成に関する項を参照してください。

タスク1: アカウント情報の取得

アカウント管理者から、タスクを実行できる適切なアカウント資格証明を取得します。具体的には、次のものが必要となります:

• ユーザー名とパスワード

• ホストおよびポート

• HTTP URI:/iam/directory/oud/scim/v1/

タスク2: リクエストの送信

RESTクライアントを設定した後、HTTPリクエストを送信して接続が成功することを確認できます。たとえば、エントリを作成する場合は、POSTメソッドおよび次のペイロードを使用して、HTTPリクエストをURI /iam/directory/oud/scim/v1/Usersに送信します:

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
  ],
  "name": [
    {
      "formatted": "First name Last name",
      "givenName": " First name ",
      "familyName": " Last name "
    }
  ],
   "password": [
    {
      "value": "password"
    }
  ],
"urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:User": {
    "employeenumber": "727",
    "objectClass": [
      {
        "value": "top"
      }
    ],
    "mobile": [
      {
        "value": "[phone]"
      }
    ],
    "departmentnumber": [
      {
        "value": "1"
      }
    ]
  },
  "emails": [
    {
      "value": "First [e-mail]"
    }
  ],
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "department": [
      {
        "value": "1"
      }
    ],
    "employeeNumber": [
      {
        "value": "727"
      }
    ]
  },
  "userName": [
    {
      "value": "First name"
    }
  ]
}

リクエストが成功すると、次のような本文とともに200レスポンスが返されます:

{
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:User",
        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
    ],
    "name": [
        {
            "formatted": "First name Last name",
            "givenName": " First name ",
            "familyName": " Last name "
        }
    ],
    "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:User": {
        "objectClass": [
            {
                "value": "top"
            },
            {
                "value": "organizationalPerson"
            },
            {
                "value": "person"
            },
            {
                "value": "inetOrgPerson"
            }
        ],
        "mobile": [
            {
                "value": "[phone]"
            }
        ]
    },
    "meta": {
        "location": "http://localhost:9080/iam/directory/oud/scim/v1/Users/6e5b9799-39e6-49e7-9e11-c9ceac49e27c",
        "resourceType": "User"
    },
    "emails": [
        {
            "value": "First [e-mail]"
        }
    ],
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
        "department": [
            {
                "value": "1"
            }
        ],
        "employeeNumber": [
            {
                "value": "727"
            }
        ]
    },
    "userName": [
        {
            "value": "First name"
        }
    ],
    "id": "6e5b9799-39e6-49e7-9e11-c9ceac49e27c"
}