教學課程:設定 Slack 來自動布建使用者
本教學課程旨在說明您需要在 Slack 和 Microsoft Entra ID 中執行的步驟,以將使用者帳戶從 Microsoft Entra ID 自動布建和取消布建至 Slack。 如需此服務執行方式、運作方式和常見問題的重要詳細資料,請參閱 使用 Microsoft Entra ID 將使用者布建和取消布建至 SaaS 應用程式。
支援的功能
- 在 Slack 中建立使用者
- 當使用者不再需要存取權時,請移除 Slack 中的使用者
- 讓使用者屬性在 Microsoft Entra ID 與 Slack 之間保持同步
- 在 Slack 中布建群組和群組成員資格
- 單一登入 Slack (建議)
必要條件
本教學課程中所述的案例假設您已經有下列專案:
- Microsoft Entra 租使用者 。
- 具有設定布建許可權 的 Microsoft Entra 識別碼 使用者帳戶(例如,應用程式管理員istrator、雲端應用程式管理員、應用程式擁有者或全域管理員istrator)。
- 已啟用 Plus 方案 或更高許可權的 Slack 租使用者。
- Slack 中具有 Team 管理員 許可權的使用者帳戶。
注意
此整合也可從 Microsoft Entra US Government Cloud 環境使用。 您可以在 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 的自動使用者帳戶布建:
以至少雲端 應用程式管理員istrator 身分登入 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 屬性只會在新使用者建立期間更新。