共用方式為

Microsoft Entra 單一登錄 （SSO） 與 Contentful 整合

  • 發行項

在本文中，您將瞭解如何整合 Contentful 與 Microsoft Entra ID。 將 Contentful 與 Microsoft Entra ID 整合後，您可以執行下列動作︰

  • 在 Microsoft Entra ID 中控制可存取 Contentful 的人員。
  • 讓使用者運用其 Microsoft Entra 帳戶自動登入 Contentful。
  • 在一個集中式位置管理您的帳戶。

必要條件

本文中所述的案例假設您已經具備下列必要條件：

  • 已啟用 Contentful 單一登入 (SSO) 的訂用帳戶。

案例描述

在本文中，您會在測試環境中設定及測試 Microsoft Entra SSO。

  • Contentful 支援由 服務供應商 (SP) 和 身分驗證提供者 (IDP) 起始的 SSO。
  • Contentful 支援 Just In Time 使用者佈建。
  • Contentful 支援自動使用者佈建。

注意

此應用程式的識別碼是固定的字串值，因此一個租用戶中只能設定一個執行個體。

若要設定將 Contentful 整合到 Microsoft Entra ID 中，您需要從資源庫將 Contentful 新增到受控 SaaS 應用程式清單。

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
  2. 瀏覽至身份識別>應用程式>企業應用程式>新增應用程式。
  3. 在 從資源庫新增 區段的搜尋方塊中輸入 Contentful。
  4. 在結果中選取 [Contentful]，然後新增應用程式。 請稍候幾秒鍾，以便將應用程式新增至您的租用戶。

或者，您也可以使用企業應用程式組態精靈。 在此精靈中，您可以將應用程式新增至租用戶、將使用者/群組新增至應用程式、指派角色，以及逐步進行 SSO 設定。 深入了解 Microsoft 365 精靈。

設定和測試適用於 Contentful 的 Microsoft Entra SSO

使用名為 B.Simon 的測試使用者，設定和測試與 Contentful 搭配運作的 Microsoft Entra SSO。 若要讓 SSO 能夠運作，您必須建立 Microsoft Entra 使用者與 Contentful 中相關使用者之間的連結關係。

若要設定和測試與 Contentful 搭配運作的 Microsoft Entra SSO，請執行下列步驟：

  1. 設定 Microsoft Entra SSO - 讓使用者能夠使用此功能。
    1. 建立 Microsoft Entra 測試使用者 - 以使用 B.Simon 測試 Microsoft Entra 單一登入。
    2. 指派 Microsoft Entra 測試使用者 - 讓 B.Simon 使用 Microsoft Entra 單一登入。
  2. 設定 Contentful SSO - 在應用程式端設定單一登入設定。
    1. 建立 Contentful 測試使用者：使 Contentful 中 B.Simon 的對應項目連結到該使用者在 Microsoft Entra 中的代表項目。
  3. 測試 SSO - 確認組態是否正常運作。

設定 Microsoft Entra SSO

遵循下列步驟來啟用 Microsoft Entra SSO。

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

  2. 瀏覽至「身分識別」>「應用程式」>「企業應用程式」>「Contentful」>「單一登入」。

  3. 在 [選取單一登入方法] 頁面上，選取 [SAML]。

  4. 在 [以 SAML 設定單一登入] 頁面上，按一下 [基本 SAML 設定] 的鉛筆圖示，以編輯設定。

    編輯基本 SAML 組態

  5. 在 [基本 SAML 組態] 區段上，如果您想要以 IDP 起始模式設定應用程式，請執行下列步驟：

    a. 在 [回覆 URL 文字方塊] 中，從 Contentful 的 SSO 設定頁面複製 ACS (斷言消費者服務) URL。 顯示如下：https://be.contentful.com/sso/<organization_id>/consume。

  6. 如果您想要以 SP 起始的模式設定應用程式，請按一下 [設定其他 URL]，然後執行下列步驟：

    a. 在 [登入 URL] 文字方塊中，複製相同的 ACS (判斷提示取用者服務) URL。 顯示如下：https://be.contentful.com/sso/<organization_id>/login。

    注意

    這些都不是真正的值。 請從 Contentful 的 SSO 設定頁面複製 ACS (Assertion Consumer Service) URL，並使用實際的 Reply URL 和 Sign-On URL 來更新這些值。

  7. Contentful 應用程式需要特定格式的 SAML 斷言，這需要您在 SAML 記號屬性設定中加入自訂屬性對應。 下列螢幕擷取畫面顯示預設屬性的清單。

    image

  8. 除了上述屬性外，Contentful 應用程式還需要在 SAML 回應中多傳回幾個屬性，如下所示。 這些屬性也會預先填入，但您可以根據需求來檢閱這些屬性。

    名稱 來源屬性
    電子郵件 使用者.使用者主名稱 (user.userprincipalname)

  9. 在 [使用 SAML 設定單一登入] 頁面上的 [SAML 簽署憑證] 區段中，尋找 [憑證 (Base64)]，然後選取 [下載] 以下載憑證並儲存在電腦上。

    憑證下載連結

  10. 在 [設定 Contentful] 區段中，複製登入 URL 以設定 Contentful SSO。

建立 Microsoft Entra 測試使用者

在本節中，您將建立名為 B.Simon 的測試使用者。

  1. 以至少是使用者管理員的身分登入 Microsoft Entra 系統管理中心。
  2. 瀏覽至 [身分識別]>[使用者]>[所有使用者]。
  3. 在畫面頂端選取 [新增使用者]>[建立新使用者]。
  4. 在 [使用者] 屬性中，執行下列步驟：
    1. 在 [顯示名稱] 欄位中輸入 B.Simon。
    2. 在 [使用者主體名稱] 欄位中輸入 username@companydomain.extension。 例如： B.Simon@contoso.com 。
    3. 選取 [顯示密碼] 核取方塊，然後記下 [密碼] 方塊中顯示的值。
    4. 按一下檢閱 + 建立。
  5. 選擇建立。

指派 Microsoft Entra 測試使用者

在本節中，您將授予 B.Simon 存取 Contentful 的權限，使其能夠使用單一登入。

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
  2. 瀏覽至「身分識別」>「應用程式」>「企業應用程式」>「Contentful」。
  3. 在應用程式概觀頁中，選取 [使用者和群組]。
  4. 選取 [新增使用者/群組]，然後在 [新增指派] 對話方塊中選取 [使用者和群組]。
    1. 在 [使用者和群組] 對話方塊中，從 [使用者] 列表中選取 [B.Simon]，然後按一下畫面底部的 [選取] 按鈕。
    2. 如果您預期將角色指派給使用者，則可以從 [選取角色] 下拉式清單中選取該角色。 如果未為此應用程式設定任何角色，您會看到已選取 [預設存取權] 角色。
    3. 在 [新增指派] 對話方塊中，按一下 [指派] 按鈕。

設定 Contentful SSO

請遵循下列步驟，在 Contentful 端設定單一登入。

  1. 在 Contentful 中，瀏覽至 [組織設定] 中的 [SSO 設定] 頁面。
  2. 按一下 [設定 SSO]。
  3. 從 Microsoft Entra ID 的「設定 Contentful」區段複製登入 URL 並貼上。
  4. 從您自 Microsoft Entra ID 下載的 Base64 憑證檔案複製憑證並貼上。
  5. 設定 SP 起始登入的 SSO 名稱。
  6. 按一下 [啟用 SSO]。

如果無法解決問題，請聯絡 Contentful 支援小組。

建立 Contentful 測試使用者

本節會在 Contentful 中建立名為 B.Simon 的使用者。 Contentful 支援即時使用者佈建功能，此功能預設為啟用狀態。 本節中沒有適用於您的動作項目。 如果 Contentful 中還沒有任何使用者存在，在驗證之後就會建立新的使用者。

Contentful 也支援自動使用者佈建，您可以在這裡找到關於如何設定自動使用者佈建的更多詳細資料。

測試 SSO

在本節中，您會使用下列選項來測試您的 Microsoft Entra 單一登入設定。

SP 啟動：

  • 按一下 [測試此應用程式]，這將會重新導向至 Contentful 單一登入 URL，您可在此起始登入流程。

  • 直接移至 Contentful 登入 URL，然後從該處起始登入流程。

IDP 起始：

  • 按一下 [測試此應用程式]，且您應該會自動登入已設定 SSO 的 Contentful。

您也可以使用 Microsoft「我的應用程式」，以任何模式測試應用程式。 當您按一下「我的應用程式」中的「Contentful」圖格時，如果是在 SP 模式中設定，即會重新導向至「應用程式登入」頁面以起始登入流程，如果在 IDP 模式中設定，則應該會自動登入已設定 SSO 的 Contentful。 如需「我的應用程式」的詳細資訊，請參閱我的應用程式簡介。

相關內容

設定 Contentful 後，您可以強制執行工作階段控制項，以即時防止組織的敏感資料遭到外洩和滲透。 「工作階段控制從條件式存取擴展而來。」 了解如何使用 Microsoft Defender for Cloud Apps 強化會話控制。