共用方式為

教學課程︰設定 Clarizen One 來自動佈建使用者

  • 發行項

此教學課程說明您在 Clarizen One 與 Microsoft Entra ID 中設定自動使用者佈建所需執行的步驟。 設定後 Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，將使用者和群組自動佈建和取消佈建至 Clarizen One。 如需此服務的用途、運作方式和常見問題集的詳細資訊，請參閱使用 Microsoft Entra ID 對軟體即服務 (SaaS) 應用程式自動佈建和取消佈建使用者。

支援的功能

  • 在 Clarizen One 中建立使用者。
  • 當使用者不再需要存取時，將其從 Clarizen One 中移除。
  • 讓 Microsoft Entra ID 與 Clarizen One 之間的使用者屬性保持同步。
  • 在 Clarizen One 中佈建群組和群組成員資格。
  • 建議單一登入 (SSO) 至 Clarizen One。

必要條件

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

步驟 1：規劃佈建部署

  1. 了解佈建服務的運作方式 \(部分機器翻譯\)。
  2. 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
  3. 判斷要在 Microsoft Entra ID 與 Clarizen One 之間對應哪些資料。

步驟 2：將 Clarizen One 設定為支援使用 Microsoft Entra ID 進行佈建

  1. 根據您的 Clarizen One 環境和資料中心，選取下列四個租用戶 URL 之一：

  2. 產生 API 金鑰。 此值會輸入至 Clarizen One 應用程式的 [佈建] 索引標籤上的 [秘密權杖] 方塊中。

從 Microsoft Entra 應用程式庫新增 Clarizen One，即可開始管理對 Clarizen One 的佈建。 如果您先前已針對 SSO 設定 Clarizen One，則可使用相同的應用程式。 當您最初測試整合時，請建立個別的應用程式。 若要深入了解如何從資源庫新增應用程式，請參閱將應用程式新增至 Microsoft Entra 租用戶。

步驟 4：定義佈建範圍內的人員

透過 Microsoft Entra 佈建服務，您可以根據對應用程式的指派，或根據使用者或群組的屬性，界定將要佈建的人員。 若選擇根據指派界定要佈建至應用程式的人員，請依照在 Microsoft Entra ID 中管理應用程式的使用者指派中的步驟，將使用者和群組指派給應用程式。 如果您選擇僅根據使用者或群組的屬性來界定要佈建的人員，請使用範圍篩選器，如使用範圍篩選器的屬性型應用程式佈建所說明。

  • 將使用者和群組指派給 Clarizen One 時，您必須選取 [預設存取] 以外的角色。 具有預設存取角色的使用者會從佈建中排除，且會在佈建記錄中標示為不具有效授權。 如果應用程式上唯一可用的角色是預設存取角色，您可以更新應用程式資訊清單以新增更多角色。
  • 從小規模開始。 在推出給所有人之前，先使用一小部分的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式加以控制。 當範圍設為所有使用者和群組時，您可以指定屬性型範圍篩選器。

步驟 5：設定將使用者自動佈建至 Clarizen One

本節將引導逐步設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者或群組指派，在 TestApp 中建立、更新和停用使用者或群組。

在 Microsoft Entra ID 中為 Clarizen One 設定自動使用者佈建

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

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

    顯示 [企業應用程式] 窗格的螢幕擷取畫面。

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

    在應用程式清單中顯示 Clarizen One 連結的螢幕擷取畫面。

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

    顯示 [佈建] 索引標籤的螢幕擷取畫面。

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

    顯示 [佈建] 索引標籤 [自動] 選項的螢幕擷取畫面。

  6. 在 [管理員認證] 區段底下，輸入您的 Clarizen One [租用戶 URL] 和 [秘密權杖]。 選取 [測試連線]，以確定 Microsoft Entra ID 可以連線至 Clarizen One。 如果連線失敗，請確定您的 Clarizen One 帳戶具有管理員權限，然後再試一次。

    顯示 [秘密權杖] 方塊的螢幕擷取畫面。

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

    顯示 [通知電子郵件] 方塊的螢幕擷取畫面。

  8. 選取 [儲存]。

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

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

    屬性 類型
    userName String
    displayName String
    作用中 布林值
    title String
    emails[type eq "work"].value String
    emails[type eq "home"].value String
    emails[type eq "other"].value String
    preferredLanguage String
    name.givenName String
    name.familyName String
    name.formatted String
    name.honorificPrefix String
    name.honorificSuffix String
    addresses[type eq "other"].formatted String
    addresses[type eq "work"].formatted String
    addresses[type eq "work"].country String
    addresses[type eq "work"].region String
    addresses[type eq "work"].locality String
    addresses[type eq "work"].postalCode String
    addresses[type eq "work"].streetAddress String
    phoneNumbers[type eq "work"].value String
    phoneNumbers[type eq "mobile"].value String
    phoneNumbers[type eq "fax"].value String
    phoneNumbers[type eq "home"].value String
    phoneNumbers[type eq "other"].value String
    phoneNumbers[type eq "pager"].value String
    externalId String
    nickName String
    地區設定 String
    roles[primary eq "True".type] String
    roles[primary eq "True".value] String
    timezone String
    userType String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager 參考
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String

  11. 在 [對應] 區段底下，選取 [同步處理 Microsoft Entra 群組至 Clarizen One]。

  12. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理到 Clarizen One 的群組屬性。 選取為 [比對] 屬性的屬性會用來比對 Clarizen One 中的群組以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型
    displayName String
    externalId String
    成員 參考

  13. 若要設定範圍篩選條件，請參閱範圍篩選器教學課程中的指示。

  14. 若要為 Clarizen One 啟用 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。

    顯示將 [佈建狀態] 切換為 [開啟] 的螢幕擷取畫面。

  15. 藉由在 [設定] 區段的 [範圍] 中選取所需的值，定義要佈建至 Clarizen One 的使用者或群組。

    顯示佈建範圍的螢幕擷取畫面。

  16. 準備好要佈建時，請選取 [儲存]。

    顯示儲存佈建設定的螢幕擷取畫面。

此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期的執行時間比後續迴圈要長，只要 Microsoft Entra 佈建服務仍在執行，大約每 40 分鐘就會發生一次。

步驟 6：監視您的部署

設定佈建後，請使用下列資源來監視部署。

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

疑難排解秘訣

當您將使用者指派給 Clarizen One 資源庫應用程式時，請選取 [使用者] 角色即可。 下列角色無效：

  • 系統管理員 (管理員)
  • 電子郵件報告使用者
  • 外部使用者
  • 金融使用者
  • 社交使用者
  • 超級使用者
  • 時間和費用使用者

其他資源

下一步