cURL を使用した API 駆動インバウンドプロビジョニングのクイックスタート

[アーティクル]
02/28/2024

はじめに

cURL は、API 開発者によって使用される一般的で無料のオープンソースのコマンドラインツールであり、Windows 10/11 で既定で使用できます。このチュートリアルでは、cURL を使用した API 駆動インバウンドプロビジョニングをすばやくテストする方法について説明します。

前提条件

API 駆動インバウンドプロビジョニングアプリの構成を完了している。
サービスプリンシパルの構成を完了していて、プリンシパルがインバウンドプロビジョニング API にアクセスできる。このチュートリアルで使用するサービスプリンシパルアプリの ClientId と ClientSecret を書き留めておいてください。

ユーザーデータを受信プロビジョニング API にアップロードする

インバウンドプロビジョニング API にアクセスできるサービスプリンシパルの client_id と client_secret を取得します。
OAuth client_credentials 許可フローを使用してアクセストークンを取得します。変数 [yourClientId]、[yourClientSecret]、[yourTenantId] を自分の設定に適用できる値で置き換え、次の cURL コマンドを実行します。生成されたアクセストークン値をコピーします
```
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=[yourClientId]&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default&client_secret=[yourClientSecret]&grant_type=client_credentials" "https://login.microsoftonline.com/[yourTenantId]/oauth2/v2.0/token"
```
SCIM エンタープライズユーザースキーマによる一括要求をコピーし、その内容を scim-bulk-upload-users.json というファイルに保存します。
変数 [InboundProvisioningAPIEndpoint] を、プロビジョニングアプリに関連付けられているプロビジョニング API エンドポイントで置き換えます。前の手順の [AccessToken] 値を使用し、次の curl コマンドを実行して、一括要求をプロビジョニング API エンドポイントにアップロードします。
```
curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
```
アップロードが成功すると、HTTP 202 Accepted 応答コードを受け取ります。
プロビジョニングサービスは一括要求ペイロードの処理を直ちに開始し、インバウンドプロビジョニングアプリのプロビジョニングログにアクセスすることでプロビジョニングの詳細を確認できます。

一括要求ペイロードの処理を確認する

少なくともアプリケーション管理者として Microsoft Entra 管理センターにログインしてください。
[Microsoft Entra ID] ->[アプリケーション] - >[エンタープライズアプリケーション] の順に移動します。
すべてのアプリケーションで、検索フィルターテキストボックスを使用して、API 駆動プロビジョニングアプリケーションを見つけて開きます。
[プロビジョニング] ブレードを開きます。ランディングページに最後の実行の状態が表示されます。
[プロビジョニングログの表示] をクリックして、プロビジョニングログブレードを開きます。または、メニューオプションの [監視] -> [プロビジョニングログ] をクリックすることもできます。
プロビジョニングログ内の任意のレコードをクリックして、追加の処理の詳細を表示します。
プロビジョニングログの詳細画面に、特定のユーザーに対して実行されたすべての手順が表示されます。
- [API からインポート] ステップで、一括要求から抽出されたユーザーデータの詳細を確認します。
- [ユーザーのマッチ] ステップには、マッチする識別子に基づいて、すべてのユーザーマッチの詳細が表示されます。ユーザーマッチが発生した場合、プロビジョニングサービスは更新操作を実行します。ユーザーマッチがない場合、プロビジョニングサービスは作成操作を実行します。
- [ユーザーがスコープ内にいるかの確認] ステップには、スコープフィルター評価の詳細が表示されます。既定では、すべてのユーザーが処理されます。スコープフィルターを設定した場合 (たとえば、販売部門に属するユーザーのみを処理するなど)、このステップにはスコープフィルターの評価の詳細が表示されます。
- [ユーザーのプロビジョニング] ステップでは、最終的な処理ステップと、ユーザーアカウントに適用された変更が呼び出されます。
- [変更されたプロパティ] タブを使用して、属性の更新を表示します。

付録

SCIM エンタープライズユーザースキーマを使用した一括要求の詳細については、このセクションを参照してください。

SCIM エンタープライズユーザースキーマによる一括要求

下に示す一括要求では、SCIM 標準コアユーザースキーマとエンタープライズユーザースキーマを使用しています。

要求本文

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "897401c2-2de4-4b87-a97f-c02de3bcfc61",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701984",
            "userName": "bjensen@example.com",
            "name": {
                "formatted": "Ms. Barbara J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Barbara",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Babs Jensen",
            "nickName": "Babs",
            "emails": [
            {
              "value": "bjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "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",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5555",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Guide",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701984",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "89607",
                     "displayName": "John Smith"
                 }
            }
        }
    },
    {
        "method": "POST",
        "bulkId": "897401c2-2de4-4b87-a97f-c02de3bcfc61",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701985",
            "userName": "Kjensen@example.com",
            "name": {
                "formatted": "Ms. Kathy J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Kathy",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Kathy Jensen",
            "nickName": "Kathy",
            "emails": [
            {
              "value": "kjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Oracle City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91618",
              "country": "USA",
              "formatted": "100 Oracle City Plaza\nHollywood, CA 91618 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5545",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Lead",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701985",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "701984",
                     "displayName": "Barbara Jensen"
                 }
            }
        }
    }
],
    "failOnErrors": null
}

cURL を使用した API 駆動インバウンドプロビジョニングのクイックスタート

はじめに

前提条件

ユーザーデータを受信プロビジョニング API にアップロードする

一括要求ペイロードの処理を確認する

付録

SCIM エンタープライズユーザースキーマによる一括要求

次のステップ

その他のリソース

cURL を使用した API 駆動インバウンド プロビジョニングのクイックスタート

はじめに

前提条件

ユーザー データを受信プロビジョニング API にアップロードする

一括要求ペイロードの処理を確認する

付録

SCIM エンタープライズ ユーザー スキーマによる一括要求

次のステップ

その他のリソース

cURL を使用した API 駆動インバウンドプロビジョニングのクイックスタート

ユーザーデータを受信プロビジョニング API にアップロードする

SCIM エンタープライズユーザースキーマによる一括要求