教學課程:設定 Slack 來自動布建使用者
本教學課程旨在說明您需要在 Slack 和 Microsoft Entra ID 中執行的步驟,以將使用者帳戶從 Microsoft Entra ID 自動布建和取消布建至 Slack。 如需此服務執行方式、運作方式和常見問題的重要詳細數據,請參閱 使用 Microsoft Entra ID 將使用者布建和取消布建至 SaaS 應用程式。
支援的功能
- 在 Slack 中建立使用者
- 當使用者不再需要存取權時,請移除 Slack 中的使用者
- 讓用戶屬性在 Microsoft Entra ID 與 Slack 之間保持同步
- 在 Slack 中布建群組和群組成員資格
- 單一登入 Slack (建議 )
必要條件
本教學課程中所述的案例假設您已經有下列專案:
- Microsoft Entra 租使用者。
- 下列其中一個角色:應用程式 管理員 istrator、Cloud Application 管理員 istrator 或應用程式擁有者。
- 已啟用 Plus 方案或更高許可權的 Slack 租使用者。
- Slack 中具有 Team 管理員 許可權的用戶帳戶。
注意
此整合也可從 Microsoft Entra US Government 雲端環境使用。 您可以在 Microsoft Entra US Government 雲端應用程式資源庫中找到此應用程式,並以您從公用雲端所做的相同方式進行設定。
步驟 1:規劃布建部署
步驟 2:從 Microsoft Entra 應用連結庫新增 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 的自動使用者帳戶布建:
至少需以雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
流覽至 [身分>識別應用程式企業應用程式]>
在應用程式清單中,選取 [Slack]。
選取 [ 布建] 索引 標籤。
將 [布 建模式 ] 設定為 [ 自動]。
在 [管理員 認證] 區段底下,按兩下 [授權]。 這會在新瀏覽器視窗中開啟 Slack 授權對話方塊。
在新視窗中,使用您的 Team 管理員 帳戶登入 Slack。 在產生的授權對話框中,選取您要啟用布建的 Slack 小組,然後選取 [ 授權]。 完成後,返回 Azure 入口網站 完成布建組態。
選取 [測試 連線],以確保 Microsoft Entra ID 可以連線到您的 Slack 應用程式。 如果連線失敗,請確定您的 Slack 帳戶具有 Team 管理員 許可權,然後再試一次「授權」步驟。
在 [ 通知電子郵件 ] 字段中,輸入應接收布建錯誤通知的人員或群組的電子郵件地址,然後選取 [失敗發生 時傳送電子郵件通知] 複選框。
選取 [儲存]。
在 [對應] 區段底下,選取 [ 將 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 |
昵稱 | 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 的使用者和/或群組。
當您準備好布建時,請按兩下 [ 儲存]。
此作業會啟動 設定 區段中範圍中定義之所有使用者和群組的初始同步處理週期。 初始週期的執行時間比後續迴圈還要長,只要 Microsoft Entra 布建服務正在執行,大約每 40 分鐘就會發生一次。
步驟 5:監視您的部署
設定布建之後,請使用下列資源來監視您的部署:
疑難排解秘訣
設定 Slack 的 displayName 屬性時,請注意下列行為:
值並不完全是唯一的(例如 2 個使用者可以有相同的顯示名稱)
支援非英文字元、空格、大寫。
允許的標點符號包括句點、底線、連字元、單引號、方括弧(例如(例如 [ { } ] )和分隔符(例如 , / ;)。
displayName 屬性不能有 '@' 字元。 如果包含 『@』 ,您可能會在布建記錄中找到略過的事件,其描述為 “AttributeValidationFailed”。
只有在 Slack 工作場所 /組織中設定這兩個設定時,才會更新 - 已啟用 設定檔同步處理,且 使用者無法變更其顯示名稱。
Slack 的 userName 屬性必須低於 21 個字元,且具有唯一值。
Slack 只允許比對屬性 userName 和 電子郵件。
常見的錯誤碼記載於官方 Slack 檔中 - https://api.slack.com/scim#errors
變更記錄檔
- 06/16/2020 - 修改後的 DisplayName 屬性只會在新使用者建立期間更新。