教學課程：設定 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 Cloud 環境使用。 您可以在 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. 以至少雲端 應用程式管理員istrator 身分登入 Microsoft Entra 系統管理中心 。

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

    Enterprise applications blade

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

    The Slack link in the Applications list

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

    Screenshot of the Manage options with the Provisioning option called out.

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

    Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.

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

    Screenshot shows the Authorize Admin Credentials button.

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

    Authorization Dialog

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

  9. 在 [ 通知電子郵件 ] 欄位中，輸入應接收布建錯誤通知的人員或群組的電子郵件地址，然後選取 [失敗發生 時傳送電子郵件通知] 核取方塊。

    Notification Email

  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 布建服務，請將 [設定 ] 區段中的 [布建狀態 ] 變更為 [開啟 ]

    Provisioning Status Toggled On

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

    Provisioning Scope

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

    Saving Provisioning Configuration

此作業會啟動 設定 區段中範圍 中 定義之所有使用者和群組的初始同步處理週期。 初始週期的執行時間比後續迴圈還要長，只要 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 屬性只會在新使用者建立期間更新。

其他資源

下一步