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

文章
07/17/2024

注意

不支援與 Slack 與自訂/BYOA 應用程式整合。支援使用此教學課程中所述的資源庫應用程式。資源庫應用程式已經過自訂，可搭配 Slack 的 SCIM v1 伺服器使用。

本教學課程旨在說明您需要在 Slack 和 Microsoft Entra ID 中執行的步驟，以從 Microsoft Entra ID 自動佈建和取消佈建使用者帳戶至 Slack。如需此服務執行方式、運作方式和常見問題的重要詳細資料，請參閱使用 Microsoft Entra ID 將使用者佈建和取消佈建至 SaaS 應用程式。

支援的功能

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

必要條件

本教學課程中說明的案例假設您已經具有下列項目：

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

注意

此整合也可從 Microsoft Entra US Government 雲端環境使用。您可以在 Microsoft Entra US Government 雲端應用程式資源庫中找到此應用程式，並以您從公用雲端所做的相同方式進行設定。

步驟 1：規劃佈建部署

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

步驟 2：從 Microsoft Entra 應用程式資源庫新增 Slack

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

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

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

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

步驟 4：設定使用者自動佈建至 Slack

本節將逐步引導您將 Microsoft Entra ID 連接至 Slack 的使用者帳戶佈建 API，以及根據 Microsoft Entra ID 中的使用者和群組指派，設定佈建服務以在 Slack 中建立、更新和停用指派的使用者帳戶。

若要在 Microsoft Entra ID 中設定將使用者帳戶自動佈建至 Slack：

以至少雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中，選取 [Slack]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [系統管理員認證] 區段下，按一下 [授權]。這會在新的瀏覽器視窗中開啟 Slack 授權對話方塊。
在新視窗中，使用您的小組系統管理帳戶登入 Slack。在產生的授權對話方塊中，選取您想要啟用佈建的 Slack 小組，然後選取 [授權]。一旦完成後，回到 Azure 入口網站以完成佈建組態。
選取 [測試連線]，以確定 Microsoft Entra ID 可以連線至您的 Slack 應用程式。如果連接失敗，請確定您的 Slack 帳戶具有小組系統管理員權限，並再試一次「授權」步驟。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段底下，選取 [將 Microsoft Entra 使用者同步至 Slack]。
在 [屬性對應] 區段中，檢視從 Microsoft Entra ID 同步處理至 Slack 的使用者屬性。請注意，選取為 [比對] 屬性的屬性會用來比對 Slack 中的使用者帳戶以進行更新作業。選取 [儲存] 按鈕以認可任何變更。

屬性	類型
作用中	布林值
externalId	String
displayName	String
name.familyName	String
name.givenName	String
title	String
emails[type eq "work"].value	String
userName	String
nickName	String
addresses[type eq "untyped"].streetAddress	String
addresses[type eq "untyped"].locality	String
addresses[type eq "untyped"].region	String
addresses[type eq "untyped"].postalCode	String
addresses[type eq "untyped"].country	String
phoneNumbers[type eq "mobile"].value	String
phoneNumbers[type eq "work"].value	String
roles[primary eq "True"].value	String
地區設定	String
name.honorificPrefix	String
photos[type eq "photo"].value	String
profileUrl	String
timezone	String
userType	String
preferredLanguage	String
urn:scim:schemas:extension:enterprise:1.0.department	String
urn:scim:schemas:extension:enterprise:1.0.manager	參考
urn:scim:schemas:extension:enterprise:1.0.employeeNumber	String
urn:scim:schemas:extension:enterprise:1.0.costCenter	String
urn:scim:schemas:extension:enterprise:1.0.organization	String
urn:scim:schemas:extension:enterprise:1.0.division	String

在 [對應] 區段下，選取 [將 Microsoft Entra 群組同步處理至 Slack]。
在 [屬性對應] 區段中，檢視從 Microsoft Entra ID 同步處理至 Slack 的群組屬性。請注意，選取為 [比對] 屬性的屬性會用來比對 Slack 中的群組以進行更新作業。選取 [儲存] 按鈕以認可任何變更。

屬性類型

displayName String

成員參考
若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
如要啟用 Slack 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]
透過在 [設定] 區段的 [範圍] 中選擇需要的值，可定義要佈建到 Slack 的使用者和/或群組。
當您準備好要佈建時，按一下 [儲存]。

屬性	類型
displayName	String
成員	參考

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

步驟 5：監視您的部署

設定佈建後，請使用下列資源來監視部署：

使用佈建記錄來判斷哪些使用者已佈建成功或失敗
檢查進度列來查看佈建週期的狀態，以及其接近完成的程度
如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。在此 \(部分機器翻譯\) 深入了解隔離狀態。

疑難排解秘訣

設定 Slack 的 displayName 屬性時，請留意下列行為：
- 值並非完全唯一 (例如，2 位使用者可以具有相同的顯示名稱)
- 支援非英文的字元、空格、大小寫。
- 允許的標點符號包括句號、底線、連字號、所有格號、括弧 (例如 ( [ { } ] )) 和分隔符號 (例如 , / ;)。
- displayName 屬性不能含有 '\@' 字元。如果包含 '\@'，您可能會在佈建記錄中找到具有 "AttributeValidationFailed" 說明的已略過事件。
- 只有在 Slack 的工作場所/組織中設定了下列這兩個設定時才會更新：已啟用設定檔同步處理及使用者無法變更其顯示名稱。
Slack 的 userName 屬性必須少於 21 個字元且具備唯一值。
Slack 只能與 userName 和 email 屬性相符。
常見的錯誤碼記載於官方的 Slack 文件中 - https://api.slack.com/scim#errors

變更記錄檔

2020/06/16 - 已將 DisplayName 屬性修改為只會在新使用者建立期間進行更新。

其他資源

下一步

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

分享方式：