教學課程:設定 Slack 來自動布建使用者

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

支援的功能

  • 在 Slack 中建立使用者
  • 當使用者不再需要存取權時,請移除 Slack 中的使用者
  • 讓用戶屬性在 Microsoft Entra ID 與 Slack 之間保持同步
  • 在 Slack 中布建群組和群組成員資格
  • 單一登入 Slack (建議 )

必要條件

本教學課程中所述的案例假設您已經有下列專案:

注意

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

步驟 1:規劃布建部署

  1. 瞭解 布建服務的運作方式。
  2. 判斷誰將在 布建範圍內。
  3. 判斷在 Microsoft Entra ID 與 Slack 之間對應的數據。

從 Microsoft Entra 應用連結庫新增 Slack,以開始管理對 Slack 的布建。 如果您先前已設定 Slack for SSO,您可以使用相同的應用程式。 不過,建議您在一開始測試整合時建立個別的應用程式。 在這裡深入瞭解如何從資源庫新增應用程式。

步驟 3:定義將在布建範圍內的人員

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

  • 從小規模開始。 在向所有人推出之前,先使用一組小型的使用者和群組進行測試。 當布建範圍設定為指派的使用者和群組時,您可以將一或兩個使用者或群組指派給應用程式來控制此設定。 當範圍設定為所有使用者和群組時,您可以指定 以屬性為基礎的範圍篩選

  • 如果您需要其他角色,您可以 更新應用程式指令清單 以新增角色。

步驟 4:設定對 Slack 的自動使用者布建

本節會引導您將 Microsoft Entra ID 連線到 Slack 的使用者帳戶布建 API,並設定布建服務,以根據 Microsoft Entra ID 中的使用者和群組指派,在 Slack 中建立、更新和停用指派的用戶帳戶。

若要在 Microsoft Entra ID 中設定對 Slack 的自動使用者帳戶布建:

  1. 至少需以雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心

  2. 流覽至 [身分>識別應用程式企業應用程式]>

    企業應用程式刀鋒視窗

  3. 在應用程式清單中,選取 [Slack]。

    應用程式清單中的 Slack 連結

  4. 選取 [ 布建] 索引 標籤。

    [管理] 選項的螢幕快照,其中已指出 [布建] 選項。

  5. 將 [布 建模式 ] 設定為 [ 自動]。

    [布建模式] 下拉式清單的螢幕快照,其中已指出 [自動] 選項。

  6. 在 [管理員 認證] 區段底下,按兩下 [授權]。 這會在新瀏覽器視窗中開啟 Slack 授權對話方塊。

    顯示 [授權 管理員 認證] 按鈕的螢幕快照。

  7. 在新視窗中,使用您的 Team 管理員 帳戶登入 Slack。 在產生的授權對話框中,選取您要啟用布建的 Slack 小組,然後選取 [ 授權]。 完成後,返回 Azure 入口網站 完成布建組態。

    授權對話框

  8. 選取 [測試 連線],以確保 Microsoft Entra ID 可以連線到您的 Slack 應用程式。 如果連線失敗,請確定您的 Slack 帳戶具有 Team 管理員 許可權,然後再試一次「授權」步驟。

  9. 在 [ 通知電子郵件 ] 字段中,輸入應接收布建錯誤通知的人員或群組的電子郵件地址,然後選取 [失敗發生 時傳送電子郵件通知] 複選框。

    通知電子郵件

  10. 選取 [儲存]。

  11. 在 [對應] 區段底下,選取 [ 將 Microsoft Entra 使用者同步處理至 Slack]。

  12. 在 [ 屬性對應 ] 區段中,檢閱將從 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
昵稱 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
  1. 在 [ 對應] 區段底下,選取 [ 同步處理 Microsoft Entra 群組至 Slack]。

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

    屬性 類型
    displayName String
    成員 參考
  3. 若要設定範圍篩選,請參閱範圍篩選教學課程中提供的下列指示。

  4. 若要啟用 Slack 的 Microsoft Entra 布建服務,請將 [設定] 區段中的 [布建狀態] 變更為 [開啟]

    已開啟布建狀態

  5. 在 [設定] 區段中,選擇 [範圍] 中所需的值,以定義您想要布建給 Slack 的使用者和/或群組。

    布建範圍

  6. 當您準備好布建時,請按兩下 [ 儲存]。

    儲存布建組態

此作業會啟動 設定 區段中範圍定義之所有使用者和群組的初始同步處理週期。 初始週期的執行時間比後續迴圈還要長,只要 Microsoft Entra 布建服務正在執行,大約每 40 分鐘就會發生一次。

步驟 5:監視您的部署

設定布建之後,請使用下列資源來監視您的部署:

  1. 使用布 建記錄 來判斷哪些使用者已成功或未成功布建
  2. 檢查進度列以查看布建周期的狀態,以及完成程度
  3. 如果布建組態似乎處於狀況不良狀態,應用程式將會進入隔離狀態。 在這裡深入瞭解隔離狀態

疑難排解秘訣

  • 設定 Slack 的 displayName 屬性時,請注意下列行為:

    • 值並不完全是唯一的(例如 2 個使用者可以有相同的顯示名稱)

    • 支援非英文字元、空格、大寫。

    • 允許的標點符號包括句點、底線、連字元、單引號、方括弧(例如(例如 [ { } ] )和分隔符(例如 , / ;)。

    • displayName 屬性不能有 '@' 字元。 如果包含 『@』 ,您可能會在布建記錄中找到略過的事件,其描述為 “AttributeValidationFailed”。

    • 只有在 Slack 工作場所 /組織中設定這兩個設定時,才會更新 - 已啟用 設定檔同步處理,且 使用者無法變更其顯示名稱

  • Slack 的 userName 屬性必須低於 21 個字元,且具有唯一值。

  • Slack 只允許比對屬性 userName電子郵件

  • 常見的錯誤碼記載於官方 Slack 檔中 - https://api.slack.com/scim#errors

變更記錄檔

  • 06/16/2020 - 修改後的 DisplayName 屬性只會在新使用者建立期間更新。

其他資源

下一步