教學課程︰設定 Zendesk 來自動佈建使用者

發行項
11/23/2024

此教學課程說明您在 Zendesk 與 Microsoft Entra ID 中設定自動佈建使用者所需執行的步驟。設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，自動佈建和取消佈建使用者和群組至 Zendesk。如需此服務的用途、運作方式和常見問題等重要詳細資訊，請參閱使用 Microsoft Entra ID 自動佈建及取消佈建使用者至 SaaS 應用程式。

支援的功能

在 Zendesk 中建立使用者。
當使用者不再需要存取權之後，將他們從 Zendesk 中移除。
讓 Microsoft Entra ID 與 Zendesk 之間的使用者屬性保持同步。
在 Zendesk 中佈建群組和群組成員資格。
單一登入至 Zendesk (建議)

必要條件

本教學課程中概述的案例假設您已經具有下列必要條件：

Microsoft Entra 租用戶。
下列角色其中之一：應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
Zendesk 中具有管理員權限的使用者帳戶。
已啟用 Professional 方案或更好方案的 Zendesk 租用戶。

步驟 1：規劃佈建部署

了解佈建服務的運作方式 \(部分機器翻譯\)。
判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
判斷要在 Microsoft Entra ID 與 Zendesk 之間對應哪些資料。

步驟 2：設定 Zendesk 以支援使用 Microsoft Entra ID 進行佈建

登入 [Zendesk 系統管理中心]。
瀏覽至 [應用程式和整合]>[API]>[Zendesk API]。
按下 [設定] 索引標籤，然後確定 [已啟用] 權杖存取。
按下 [作用中 API 權杖] 右邊的 [新增 API 權杖] 按鈕。隨即會產生並顯示權杖。
輸入 API 權杖描述。
複製權杖，並將其貼到安全的地方。關閉此視窗之後，將不會再次顯示完整權杖。
按下 [儲存] 以返回 API 頁面。如果您按下權杖以重新開啟，隨即會顯示已截斷的權杖版本。

步驟 3：從 Microsoft Entra 應用程式資源庫新增 Zendesk

從 Microsoft Entra 應用程式資源庫新增 Zendesk，以開始管理 Zendesk 的佈建。如果您先前已針對 SSO 設定 Zendesk，則可使用相同的應用程式。不過，建議您在一開始測試整合時，建立個別的應用程式。在此深入了解從資源庫新增應用程式。

步驟 4：定義佈建範圍內的人員

Microsoft Entra 佈建服務可讓您根據指派給應用程式，或根據使用者/群組的屬性來設定佈建的人員範圍。如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者和群組指派給應用程式。如果選擇僅根據使用者或群組屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。

從小規模開始。在推出給所有人之前，先使用一小部分的使用者和群組進行測試。當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。
如需其他角色，可以更新應用程式資訊清單以新增角色。

步驟 5：為 Zendesk 設定自動使用者佈建

本節會引導您逐步設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者和/或群組指派，在 Zendesk 中建立、更新和停用使用者和/或群組。

將使用者指派給 Zendesk 的重要秘訣

目前，Zendesk 角色會在 Azure 入口網站 UI 中自動且動態地填入。在將 Zendesk 角色指派給使用者之前，請確保已針對 Zendesk 完成初始同步，以擷取您 Zendesk 租用戶中的最新角色。
建議將單一 Microsoft Entra 使用者指派至 Zendesk，以測試您的初始自動使用者佈建設定。您可以稍後於測試成功之後指派更多使用者或群組。
將使用者指派至 Zendesk 時，請在 [指派] 對話方塊中選取任何有效的應用程式特有角色 (如果有的話)。具有預設存取角色的使用者會從佈建中排除。

在 Microsoft Entra ID 中設定 Zendesk 自動佈建使用者

以至少雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別] > [應用程式] > [企業應用程式]
在應用程式清單中，選取 [Zendesk]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員認證] 區段下，輸入 Zendesk 帳戶的 [管理員使用者名稱]、[祕密權杖] 和 [網域]。這些值的範例如下：
- 在 [管理員使用者名稱] 方塊中，填入 Zendesk 租用戶中管理帳戶的使用者名稱。例如 admin@contoso.com。
- 在 [祕密權杖] 方塊中填入祕密權杖，如步驟 6 所述。
- 在 [網域] 方塊中，填入您的 Zendesk 租用戶子網域。範例：針對租用戶 URL 為 https://my-tenant.zendesk.com 的帳戶，您的子網域會是 my-tenant。
您可以依照上述步驟 2 中所述的步驟，來產生 Zendesk 帳戶的祕密權杖。
填入步驟 5 所顯示的方塊之後，請選取 [測試連線] 以確認 Microsoft Entra ID 可以連線至 Zendesk。如果連線失敗，請確定您的 Zendesk 帳戶具有管理員權限並再試一次。
在 [通知電子郵件] 方塊中，輸入應收到佈建錯誤通知之個人或群組的電子郵件地址。選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取儲存。
在 [對應] 區段底下，選取 [將 Microsoft Entra 使用者同步處理至 Zendesk]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Zendesk 的使用者屬性。選取為 [比對] 屬性的屬性會用來比對 Zendesk 中的使用者帳戶以進行更新作業。若要儲存任何變更，請選取 [儲存]。
在 [對應] 區段下，選取 [將 Microsoft Entra 群組同步處理至 Zendesk]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Zendesk 的群組屬性。選取為 [比對] 屬性的屬性會用來比對 Zendesk 中的群組以進行更新作業。若要儲存任何變更，請選取 [儲存]。
若要設定範圍篩選條件，請遵循範圍篩選條件教學課程中的指示。
若要啟用 Zendesk 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。
定義您想要佈建到 Zendesk 的使用者或群組。在 [設定] 區段的 [範圍] 中，選取您想要的值。
準備好要佈建時，請選取 [儲存]。

針對 [設定] 區段的 [範圍] 中定義的所有使用者或群組，此作業會啟動首次同步處理。首次同步處理所花的時間比後續同步處理更久。只要 Microsoft Entra 佈建服務仍在執行，大約每 40 分鐘就會發生一次。

您可以使用 [同步處理詳細資料] 區段來監視進度，並循著連結取得佈建活動報告。此報告描述 Zendesk 上 Microsoft Entra 佈建服務執行的所有動作。

如需如何讀取 Microsoft Entra 佈建記錄的相關資訊，請參閱自動佈建使用者帳戶報告。

連接器限制

Zendesk 僅支援對具有代理程式角色的使用者使用群組。如需詳細資訊，請參閱 Zendesk 文件。
將自訂角色指派給使用者或群組時，Microsoft Entra 自動佈建使用者服務還會指派預設角色代理程式。只有代理程式才能指派自訂角色。如需詳細資訊，請參閱 Zendesk API 文件。
如果任何自訂角色具有類似於 "agent" 或 "end-user" 內建角色的顯示名稱，則匯入所有角色將會失敗。若要避免這種情況，請確定匯入的任何自訂角色沒有上述顯示名稱。

下一步

瞭解如何針對佈建活動檢閱記錄和取得報告

共用方式為