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

此教學課程說明您在 Coda 與 Azure Active Directory (Azure AD) 中設定自動使用者佈建所需的步驟。 設定後,Azure AD 就會使用 Azure AD 佈建服務,自動對 Coda 佈建及取消佈建使用者。 如需此服務的用途、運作方式和常見問題等重要詳細資訊,請參閱使用 Azure Active Directory 對 SaaS 應用程式自動佈建和取消佈建使用者

支援的功能

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

必要條件

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

  • Azure AD 租用戶
  • Azure AD 中具有設定佈建權限的使用者帳戶 (例如,應用程式管理員、雲端應用程式管理員、應用程式擁有者或全域管理員)。
  • Coda 企業系統管理員帳戶。

步驟 1: 規劃您的佈建部署

  1. 了解佈建服務的運作方式
  2. 判斷誰會在佈建範圍內。
  3. 判斷哪些資料要在 Azure AD 與 Coda 之間對應

步驟 2: 設定 Coda 以支援使用 Azure AD 進行佈建

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

    Coda 企業組織 SCIM 設定

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

  3. 記下 SCIM 基底 URL 和 SCIM 持有人權杖。 如果沒有持有人權杖,請按一下 [產生新的權杖]。

從 Azure AD 應用程式庫新增 Coda,以開始管理對 Coda 的佈建。 如果您先前已針對 SSO 設定 Coda,則可使用相同的應用程式。 不過,建議您在一開始測試整合時,建立個別的應用程式。 在此深入了解從資源庫新增應用程式。

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

Azure AD 佈建服務可讓您根據對應用程式的指派,和/或根據使用者屬性,界定將要佈建的人員。 如果選擇根據指派來界定將佈建至應用程式的人員,則可使用下列步驟將使用者指派給應用程式。 如果選擇僅根據使用者屬性來界定將要佈建的人員,即可使用如這裡所述的範圍篩選條件。

  • 將使用者指派給 Coda 時,您必須選取 [預設存取] 以外的角色。 具有預設存取角色的使用者會從佈建中排除,而且會在佈建記錄中被標示為沒有效率。 如果應用程式上唯一可用的角色是預設存取角色,您可更新應用程式資訊清單以新增其他角色。

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

步驟 5。 對 Coda 設定自動使用者佈建

本節將引導您逐步設定 Azure AD 佈建服務,以根據 Azure AD 中的使用者指派,在 TestApp 中建立、更新及停用使用者。

在 Azure AD 中為 Coda 設定自動使用者佈建:

  1. 登入 Azure 入口網站。 選取 [企業應用程式],然後選取 [所有應用程式]。

    企業應用程式刀鋒視窗

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

    應用程式清單中的 Coda 連結

  3. 選取 [佈建] 索引標籤。

    [管理] 選項的螢幕擷取畫面,並已指出 [佈建] 選項。

  4. 將 [佈建模式] 設定為 [自動]。

    [佈建模式] 下拉式清單的螢幕擷取畫面,並已指出 [自動] 選項。

  5. 在 [管理員認證] 區段底下,輸入您稍早在步驟 2 中擷取的 Coda 租用戶 URL 和祕密權杖。 按一下 [測試連線],以確保 Azure AD 可以連線至 Coda。 如果連線失敗,請確定您的 Coda 帳戶具有管理員權限並再試一次。

    顯示 [管理員認證] 對話方塊的螢幕擷取畫面,您可以在其中輸入您的租用戶 URL 和祕密權杖。

  6. 在 [通知電子郵件] 欄位中,輸入應該收到佈建錯誤通知的個人或群組電子郵件地址,然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。

    通知電子郵件

  7. 選取 [儲存]。

  8. 在 [對應] 區段中,選取 [將 Azure Active Directory 使用者同步至 Coda]。

  9. 在 [屬性對應] 區段中,檢閱從 Azure AD 同步至 Coda 的使用者屬性。 選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Coda 中的使用者帳戶以進行更新作業。 如果您選擇變更比對目標屬性,則必須確保 Coda API 支援根據該屬性來篩選使用者。 選取 [儲存] 按鈕以認可所有變更。

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

  11. 若要啟用 Coda 的 Azure AD 佈建服務,請在 [設定] 區段中,將 [佈建狀態] 變更為 [開啟]。

    佈建狀態已切換為開啟

  12. 透過在 [設定] 區段的 [範圍] 中選擇需要的值,可定義要佈建到 Coda 的使用者。

    佈建範圍

  13. 當您準備好要佈建時,按一下 [儲存]。

    儲存雲端佈建設定

針對 [設定] 區段的 [範圍] 中定義的所有使用者,此作業會啟動首次同步週期。 初始週期會比後續週期花費更多時間執行,只要 Azure AD 佈建服務正在執行,這大約每 40 分鐘便會發生一次。

步驟 6. 監視您的部署

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

  1. 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
  2. 檢查進度列來查看佈建週期的狀態,以及其接近完成的程度
  3. 如果佈建設定似乎處於狀況不良的狀態,應用程式將會進入隔離狀態。 在此深入了解隔離狀態。

其他資源

後續步驟