教學課程：設定 Contentful 來自動佈建使用者

發行項
06/24/2024

本文說明您在 Contentful 和 Microsoft Entra ID 中完成以設定自動使用者佈建所需的步驟。設定後 Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，將使用者和群組自動佈建和取消佈建至 Contentful。如需有關此服務如何進行和運作的重要詳細資料以及常見問題，請參閱使用 Microsoft Entra ID 將使用者佈建和取消佈建至 SaaS 應用程式。

支援的功能

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

必要條件

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

Microsoft Entra 租用戶。
下列其中一個角色：應用程式管理員、雲端應用程式管理員或應用程式擁有者。
具有訂用帳戶的 Contentful 組織帳戶，可支援跨網域身分識別管理系統 (SCIM) 佈建。如果您有關於組織訂用帳戶的問題，請連絡 Contentful 支援人員。

規劃佈建部署

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

設定 Contentful 以支援使用 Microsoft Entra ID 進行佈建

在 Contentful 中，建立服務使用者帳戶。 Azure 的所有佈建權限都可以透過此帳戶提供。我們建議您選擇擁有者作為此帳戶的組織角色。
以服務使用者的身份登入 Contentful。
在左側功能表中，選取 [組織設定]>[存取工具]>[使用者佈建]。
複製並儲存 SCIM URL。您會在 Azure 入口網站中輸入此值，其位置在 Contentful 應用程式的 [佈建] 索引標籤上。
選取 [產生個人存取權杖]。
在 [模式] 視窗中，輸入您個人存取權杖的名稱，然後選取 [產生]。
系統會產生 SCIM URL 和祕密權杖。複製並儲存這些值。您將在 Contentful 應用程式的「佈建」索引標籤輸入這些值。

如果您在 Contentful 管理主控台中設定佈建時遇到問題，請連絡 Contentful 支援人員。

從 Microsoft Entra 應用程式資訊庫新增 Contentful

若要管理 Contentful 的佈建，請從 Microsoft Entra 應用程式資源庫新增 Contentful。如果您先前已設定 Contentful 的單一登入，則可以使用相同的應用程式。不過，我們建議您在剛開始測試整合時，先建立個別的應用程式。了解如何在資源庫中新增應用程式。

定義將在佈建範圍內的人員

您可以使用 Microsoft Entra 佈建服務，根據應用程式的指派或是使用者或群組的屬性，定義所要佈建的人員。

如果選擇根據指派來界定將佈建至應用程式的人員，請完成將使用者和群組指派給應用程式的步驟。

如果您選擇僅根據使用者或群組的屬性來界定要佈建的人員，請使用範圍篩選條件來定義佈建使用者帳戶的條件式規則。

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

設定將使用者自動佈建至 Contentful

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

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

以至少雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至「身分識別」>「應用程式」>「企業應用程式」。
在應用程式清單中，選取 [Contentful]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員認證] 區段中，輸入您的 Contentful 租用戶 URL 和祕密權杖。若要確保 Microsoft Entra ID 可以連線到 Contentful，請選取 [測試連線]。如果連線失敗，請確定您的 Contentful 帳戶具有管理員權限，然後再試一次。
在 [通知電子郵件] 中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在「對應」區段中，選取 [同步處理 Microsoft Entra 使用者與 Contentful]。
在「屬性對應」區段中，檢閱從 Microsoft Entra ID 與 Contentful 同步的使用者屬性。選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Contentful 中的使用者帳戶，以進行更新作業。如果您選擇變更比對目標屬性，則必須確保 Contentful API 支援根據該屬性來篩選使用者。選取 [儲存] 按鈕以認可所有變更。

屬性類型支援篩選

userName String ✓

name.givenName String

name.familyName String
在「對應」區段中，選取「同步處理 Microsoft 專案群組與 Contentful」。
在「屬性對應」區段中，檢閱從 Microsoft Entra ID 與 Contentful 同步的群組屬性。選取為 [比對] 屬性 (Property) 的屬性 (Attribute)，會用來比對 Contentful 中的群組以進行更新作業。選取 [儲存] 按鈕以認可所有變更。

屬性類型支援篩選

displayName String ✓

成員參考
若要設定範圍篩選條件，請完成範圍篩選教學課程中所述的步驟。
若要為 Contentful 啟用 Microsoft Entra 佈建服務，請在「設定」區段中，針對「佈建狀態」選擇「開啟」。
若要定義您想要佈建到 Contentful 的使用者或群組，請在 [設定] 區段的 [範圍] 中選取相關選項。
準備好要佈建時，請選取 [儲存]。