使用 cURL 快速入門 API 驅動輸入佈建

發行項
07/05/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 已接受回應碼。
佈建服務會立即開始處理大量要求承載，您可以存取輸入佈建應用程式的佈建記錄來查看佈建詳細資料。

驗證大量要求承載的處理

以至少應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 Microsoft Entra ID -> 企業應用程式 -> 企業應用程式。
在所有應用程式下，使用 [搜尋篩選] 文字輸入框來尋找並開啟您的 API 驅動佈建應用程式。
開啟 [佈建] 刀鋒視窗。登陸頁面會顯示上次執行的狀態。
按一下 [檢視佈建記錄] 以開啟 [佈建記錄] 刀鋒視窗。或者，您可以按一下功能表選項 [監視] - >[佈建記錄]。
按一下佈建記錄中的任何記錄，以檢視其他處理詳細資料。
佈建記錄詳細資料畫面會顯示為特定用戶執行的所有步驟。
- 在 [從 API 匯入] 步驟底下，請參閱從大量要求擷取的使用者資料詳細資料。
- 比對使用者 步驟會根據比對識別碼顯示任何使用者比對的詳細資料。如果使用者相符，佈建服務就會執行更新作業。如果使用者不相符，佈建服務就會執行建立作業。
- 判斷使用者是否在範圍 步驟顯示範圍篩選評估的詳細資料。根據預設，所有使用者都為已處理狀態。如果您已設定範圍篩選條件 (例如，僅處理屬於銷售部門的使用者)，範圍篩選的評估詳細資料會顯示在此步驟中。
- 佈建使用者 步驟會呼叫最後的處理步驟，以及套用至使用者帳戶的變更內容。
- 使用 [修改的屬性] 索引標籤來檢視屬性更新內容。

附錄

如需有 SCIM 企業使用者結構描述的大量要求資訊，請檢視本節。

有 SCIM 企業使用者結構描述的大量要求

如下所示有 SCIM 標準核心使用者和企業使用者結構描述的大量要求。

要求本文

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "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": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "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 企業使用者結構描述的大量要求

下一步

意見反應

其他資源