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

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

支援的功能

  • 在 Coda 中建立使用者
  • 當 Coda 不再需要存取權時,請移除 Coda 中的使用者
  • 讓 Microsoft Entra ID 與 Coda 之間的使用者屬性保持同步
  • 對 Coda 的單一登入 (建議)

必要條件

本教學課程中所述的案例假設您已經具備下列必要條件:

步驟 1:規劃布建部署

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

步驟 2:設定 Coda 以支援使用 Microsoft Entra ID 進行佈建

  1. 選取 [組織 設定] 底下的 [組織 管理員 控制台],以開啟您的組織 管理員 控制台。工作區下方的功能表。

    Coda Enterprise Organization SCIM Settings

  2. 確定已啟用 [使用 SCIM 布建]。

  3. 記下 SCIM 基底 URL 和 SCIM 持有人令牌。 如果沒有持有人令牌,請按兩下 [產生新令牌]。

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

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

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

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

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

步驟 5:設定對 Coda 的自動使用者布建

本節會引導您完成設定 Microsoft Entra 布建服務的步驟,以根據 Microsoft Entra ID 中的使用者指派,在 TestApp 中建立、更新和停用使用者。

若要在 Microsoft Entra ID 中為 Coda 設定自動使用者布建:

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

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

    Enterprise applications blade

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

    The Coda 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. [管理員 認證] 區段底下,輸入您在步驟 2 稍早擷取的 Coda 租使用者 URL 和秘密令牌。 按兩下 [測試 連線,以確保 Microsoft Entra ID 可以連線到 Coda。 如果連線失敗,請確定您的 Coda 帳戶具有 管理員 許可權,然後再試一次。

    Screenshot shows the Admin Credentials dialog box, where you can enter your Tenant U R L and Secret Token.

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

    Notification Email

  8. 選取 [儲存]。

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

  10. 在 [屬性對應] 區段中,檢閱從 Microsoft Entra ID 同步處理至 Coda 的用戶屬性。 選取為 [比對 ] 屬性的屬性可用來比對 Coda 中的使用者帳戶以進行更新作業。 如果您選擇變更比對 目標屬性,您必須確定 Coda API 支援根據該屬性篩選使用者。 選取 [儲存 ] 按鈕以認可任何變更。

    屬性 類型
    userName String
    作用中 布林值
    name.givenName String
    name.familyName String
  11. 若要設定範圍篩選,請參閱範圍篩選教學課程中提供的下列指示。

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

    Provisioning Status Toggled On

  13. 在 [設定] 區段中,選擇 [範圍] 中的所需值,以定義您想要布建至 Coda 的使用者。

    Provisioning Scope

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

    Saving Provisioning Configuration

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

步驟 6:監視您的部署

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

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

其他資源

下一步