本教學教程說明如何快速地使用 Microsoft Graph Explorer 測試 以 API 驅動的內部提供。
Prerequisite
- 您已設定 以 API 為驅動的入站布建應用程式。
Note
此佈建 API 主要用於在應用程式或服務中使用。 租戶管理員可以設定服務主體名稱或受管理的身分，以授予上傳權限。 此 API 沒有可供使用者個別指派的 Microsoft Entra 內建目錄角色。 除了取得管理員同意許可權的應用程式 SynchronizationData-User.Upload 之外，具有 用戶系統管理員 角色的系統管理員使用者可以叫用 API。 本教學課程說明如何在測試設定中使用用戶系統管理員角色來測試 API。
上傳使用者資料到入站佈建 API
開啟新的瀏覽器索引標籤或瀏覽器視窗。
啟動 URL https://aka.ms/ge 以存取 Microsoft Graph 資源管理器。
請選擇使用者圖示以登入。
使用具有 使用者管理員 角色存取權的用戶帳戶完成登入程式。
成功登入時，租用戶資訊會顯示您的租用戶名稱。
您現在可開始叫用 API。
在 [API 要求] 面板中，將 HTTP 要求類型設定為 POST。
複製並貼上從佈建應用程式概觀頁面擷取的佈建 API 端點。
在 [要求標頭] 面板下，新增一個新的鍵值組 Content-Type = application/scim+json。
在 要求本文 面板底下，將 符合 SCIM 企業使用者架構的大量要求進行複製和貼上。
選取 [ 執行查詢] 按鈕，將要求傳送至布建 API 端點。
如果要求成功傳送，您將從 API 端點取得
Accepted 202回應。開啟 [回應標頭] 面板，並複製位置屬性的 URL 值。 這指向佈建日誌的 API 端點，您可以查詢該端點以檢查大量要求中使用者的佈建狀態。
驗證批量請求載荷的處理
您可以從 Microsoft Entra 系統管理中心或使用 Graph Explorer 驗證處理。
在 Microsoft Entra 系統管理中心驗證處理過程
以至少應用程式管理員登入認證登入Microsoft Entra 系統管理中心。
流覽至 Entra ID>企業應用程式。
在所有應用程式下，使用 [搜尋篩選] 文字輸入框來尋找並開啟您的 API 驅動佈建應用程式。
開啟 [配置] 窗格。 登陸頁面會顯示上次執行的狀態。
選取 檢視布建記錄 以開啟布建記錄刀鋒視窗。 或者，您可以選取 [ 監視>布建記錄] 功能表選項。
選取布建記錄中的任何記錄，以檢視其他處理詳細數據。
佈建記錄詳細資料畫面會顯示為特定用戶執行的所有步驟。
- 在 [從 API 匯入] 步驟底下，請參閱從大量要求擷取的使用者資料詳細資料。
- [比對使用者] 步驟會根據比對標識符顯示任何使用者比對的詳細數據。 如果使用者相符，佈建服務就會執行更新作業。 如果沒有匹配的使用者，則設定服務會執行建立作業。
- 判斷使用者是否在範圍步驟中會顯示範圍篩選評估的詳細數據。 預設情況下，所有使用者都會被處理。 如果您設定範圍篩選條件（例如，只處理屬於銷售部門的使用者），則範圍篩選條件的評估詳細數據會顯示在此步驟中。
- 配置使用者步驟會指出最終的處理步驟，以及套用至使用者帳號的變更。
- 使用 [修改的屬性] 索引標籤來檢視屬性更新內容。
在 Graph Explorer 中使用配置日誌 API 驗證處理
您可以使用位置回應標頭中提供的設定記錄 API URL，檢查處理程序在設定 API 呼叫中的過程。
- 在 Graph Explorer 瀏覽器中，於 [要求 URL] 文字方塊中複製並貼上佈建 API 端點返回的位置 URL，或者您可以使用以下格式自行建構：
https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>'您可以從佈建應用程式概覽頁面中擷取jobId。 - 使用 GET 方法，然後選取 [ 執行查詢 ] 以擷取布建記錄。 根據預設，傳回的回應會包含所有記錄檔的記錄內容。
- 您可以設定更多篩選條件，只擷取特定時間範圍或具有特定狀態值的資料。
https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34Z您也可以透過來源系統中所使用的externalId值來檢查使用者的狀態，該值會作為來源錨點/聯結屬性。https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'
Appendix
使用 SCIM 企業使用者結構描述的大量請求
後續的大量要求會使用 SCIM 標準核心用戶和企業用戶架構。
Request body
{
"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
}