快速入門：使用 cURL 開始使用 API 驅動的輸入布建
介紹
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
}