使用 Graph 總管快速入門 API 驅動輸入布建
本教學課程說明如何使用 Microsoft Graph Explorer 快速測試 API 導向的輸入布建 。
必要條件
- 您已設定 API 驅動輸入布建應用程式。
注意
此布建 API 主要用於應用程式或服務。 租使用者管理員可以設定服務主體或受控識別,以授與執行上傳的許可權。 此 API 沒有個別的使用者可指派 Microsoft Entra 內建目錄角色。 除了具有SynchronizationData-User.Upload
管理員同意許可權的應用程式之外,只有具有全域 管理員 istrator 角色的系統管理員使用者才能叫用 API。 本教學課程說明如何在測試設定中使用全域管理員角色來測試 API。
將用戶數據上傳至輸入布建 API
開啟新的瀏覽器索引標籤或瀏覽器視窗。
啟動 URL https://aka.ms/ge 以存取 Microsoft Graph 總管。
按兩下使用者設定檔圖示以登入。
使用具有全域 管理員 istrator 角色的用戶帳戶完成登入程式。
成功登入時,租使用者信息會顯示您的租用戶名稱。
您現在已準備好叫用 API。
在 [API 要求] 面板中,將 HTTP 要求類型設定為 POST。
複製並貼上從布建應用程式概觀頁面擷取的布建 API 端點。
在 [要求標頭] 面板下,新增 Content-Type = application/scim+json 的新機碼值組。
在 [ 要求本文] 面板底下,使用 SCIM 企業使用者架構複製並貼上 大量要求
按兩下 [ 執行查詢] 按鈕,將要求傳送至布建 API 端點。
如果要求成功傳送,您將會從 API 端點取得
Accepted 202
回應。開啟 [ 回應標頭] 面板,然後複製位置屬性的 URL 值。 這指向您可以查詢的布建記錄 API 端點,以檢查大量要求中存在的使用者布建狀態。
驗證大量要求承載的處理
您可以從 Microsoft Entra 系統管理中心或使用 Graph 總管來驗證處理。
驗證 Microsoft Entra 系統管理中心的處理
使用至少應用程式 管理員 istrator 登入認證登入 Microsoft Entra 系統管理中心。
流覽至 Microsoft Entra ID -> Applications -> Enterprise 應用程式。
在所有應用程式下,使用 [搜尋篩選] 文本框來尋找並開啟您的 API 驅動布建應用程式。
開啟 [布建] 刀鋒視窗。 登陸頁面會顯示上次執行的狀態。
按兩下 [ 檢視布建記錄 ] 以開啟 [布建記錄] 刀鋒視窗。 或者,您也可以按單選項 [監視 -> 布建記錄]。
按兩下布建記錄中的任何記錄,以檢視其他處理詳細數據。
布建記錄詳細數據畫面會顯示為特定用戶執行的所有步驟。
- 在 [ 從 API 匯入] 步驟底下,查看從大量要求擷取的用戶數據詳細數據。
- [比對使用者] 步驟會根據比對標識符顯示任何使用者比對的詳細數據。 如果使用者相符,布建服務就會執行更新作業。 如果沒有使用者相符專案,則布建服務會執行建立作業。
- 判斷 使用者是否在範圍 步驟中會顯示範圍篩選評估的詳細數據。 根據預設,所有用戶都會進行處理。 如果您已設定範圍篩選條件(例如,僅處理屬於銷售部門的使用者),範圍篩選的評估詳細數據會顯示在此步驟中。
- 布 建使用者 步驟會呼叫最後的處理步驟,以及套用至用戶帳戶的變更。
- 使用 [ 修改的屬性] 索引 標籤來檢視屬性更新。
在 Graph 總管中使用布建記錄 API 驗證處理
您可以使用布建記錄 API URL,在布建 API 呼叫中作為位置回應標頭的一部分來檢查處理。
- 在 [圖形總管] 中, [要求 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'
附錄
使用 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
}