教學課程：設定自動使用者佈建的 Freshservice Provisioning
此教學課程說明您在 Freshservice Provisioning 與 Microsoft Entra ID 中設定自動使用者佈建所需執行的步驟。 設定時，Microsoft Entra ID 會自動使用 Microsoft Entra 佈建服務將使用者佈建到 Freshservice Provisioning 或取消佈建。 如需此服務的用途、運作方式和常見問題等重要詳細資訊，請參閱使用 Microsoft Entra ID 自動對 SaaS 應用程式進行使用者佈建和取消佈建。
支援的功能
- 在 Freshservice Provisioning 中建立使用者
- 當使用者不再需要存取權時，請移除 Freshservice Provisioning 中的使用者
- 讓 Microsoft Entra ID 與 Freshservice Provisioning 之間的使用者屬性保持同步
必要條件
本教學課程中概述的案例假設您已經具有下列必要條件：
- Microsoft Entra 租用戶
- 下列其中一個角色：應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
- 具有組織系統管理員許可權的 Freshservice 帳戶。
步驟 1：規劃佈建部署
- 了解佈建服務的運作方式 \(部分機器翻譯\)。
- 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
- 判斷哪些資料要在 Microsoft Entra ID 與 Freshservice Provisioning 之間對應。
步驟 2：設定 Freshservice Provisioning 以支援 Microsoft Entra ID 的佈建
- 在您的 Freshservice 帳戶上，瀏覽至 Freshservice 管理>應用程式>取得應用程式，以從商店安裝 Azure Provisioning (SCIM) 應用程式。
- 在設定畫面中，提供您的 Freshservice 網域 (例如
acme.freshservice.com) 和組織管理員 API 金鑰。 - 按一下繼續。
- 反白並複製持有人權杖。 此值會輸入到 Freshservice Provisioning 應用程式 [佈建] 索引標籤中的 [祕密權杖] 欄位。
- 按一下 [安裝] 來完成安裝程序。
- 租用戶 URL 為
https://scim.freshservice.com/scim/v2。 此值會輸入到 Freshservice Provisioning 應用程式 [佈建] 索引標籤中的 [租用戶 URL] 欄位。
步驟 3：從 Microsoft Entra 應用程式庫新增 Freshservice Provisioning
從 Microsoft Entra 應用程式資源庫新增 Freshservice Provisioning，以開始管理至 Freshservice Provisioning 的佈建。 在此深入了解從資源庫新增應用程式。
步驟 4：定義佈建範圍內的人員
Microsoft Entra 佈建服務可讓您根據對應用程式的指派，和/或根據使用者屬性，界定將要佈建的人員。 如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者指派給應用程式。 如果選擇僅根據使用者屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。
從小規模開始。 在推出給所有人之前，先使用一小部分的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。
從小規模開始。 在推出給所有人之前，先使用一小部分的使用者進行測試。 當佈建範圍設為已指派的使用者時，您可將一或兩個使用者指派給應用程式來控制這點。 當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。
步驟 5：設定自動使用者佈建至 Freshservice Provisioning
本節會引導您逐步設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者指派，在 Freshservice Provisioning 中建立、更新和停用使用者。
在 Microsoft Entra ID 中設定 Freshservice Provisioning 的自動使用者佈建
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中，選取 Freshservice Provisioning。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
![佈建索引標籤 [自動]](common/provisioning-automatic.png)
在 [管理員認證] 區段下，輸入您的 Freshservice Provisioning 租用戶 URL 和祕密權杖。 按一下 [測試連線] 以確保 Microsoft Entra ID 可以連線至 Freshservice Provisioning。 如果連線失敗，請確定您的 Freshservice Provisioning 帳戶具有管理員權限，然後再試一次。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段下方，選取 [將 Microsoft Entra 使用者同步處理至 Freshservice Provisioning]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Freshservice Provisioning 的使用者屬性。 選取為 [比對] 屬性的屬性會用來比對 Freshservice Provisioning 中的使用者帳戶，以進行更新作業。 如果您選擇變更比對目標屬性，則必須確保 Freshservice Provisioning API 支援根據該屬性來篩選使用者。 選取 [儲存] 按鈕以認可所有變更。
屬性 類型 支援篩選 userName String ✓ 作用中 布林值 emails[type eq "work"].value String displayName String name.givenName String name.familyName String phoneNumbers[type eq "work"].value String phoneNumbers[type eq "mobile"].value String addresses[type eq "work"].formatted String 地區設定 String title String timezone String externalId String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager 參考 urn:ietf:params:scim:schemas:extension:freshservice:2.0:User:isAgent String
注意
您可以遵循下列步驟，將自訂延伸模組屬性新增至您的結構描述，以符合您應用程式的需求：
- 在 [對應] 下，選取 [佈建 Microsoft Entra 使用者]。
- 在頁面底部，選取 [顯示進階選項]。
- 選取 [編輯 Freshservice 的屬性清單]。
- 在屬性清單的底部，將自訂屬性的相關資訊輸入到提供的欄位中。 自訂屬性 urn 命名空間必須遵循下列範例所示的模式。 您可以根據應用程式的需求來自訂 CustomAttribute，例如：urn:ietf:params:scim:schemas:extension:freshservice:2.0:User:isAgent.。
- 您必須為自訂屬性選取適當的資料類型，然後按一下 [儲存]。
- 瀏覽回預設對應畫面，然後按一下 [新增對應]。 自訂屬性會顯示在 [目標屬性] 下拉式清單中。
若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
若要啟用 Freshservice Provisioning 的 Microsoft Entra 佈建服務，在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。
透過在 [設定] 區段的 [範圍] 中選擇需要的值，可定義要佈建到 Freshservice Provisioning 的使用者。
當您準備好要佈建時，按一下 [儲存]。
針對 [設定] 區段的 [範圍] 中定義的所有使用者，此作業會啟動首次同步週期。 初始週期會比後續週期花費更多時間執行，只要 Microsoft Entra 佈建服務正在執行，這大約每 40 分鐘便會進行一次。
步驟 6：監視您的部署
設定佈建後，請使用下列資源來監視部署：
- 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
- 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度
- 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。