Microsoft Entra SSO 與 Contentstack 整合

在本教學課程中，您將瞭解如何整合 Contentstack 與 Microsoft Entra ID。 在整合 Contentstack 與 Microsoft Entra ID 時，您可以.

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

必要條件

若要整合 Microsoft Entra ID 與 Contentstack，您需要：

• Microsoft Entra 訂用帳戶。 如果您沒有訂用帳戶，可以取得免費帳戶。
• 已啟用 Contentstack 單一登入 （SSO） 的訂用帳戶。

案例描述

在本教學課程中，您會在測試環境中設定及測試 Microsoft Entra SSO。

• Contentstack 同時 支援由SP和IDP 起始的 SSO。
• Contentstack 支援 Just In Time 使用者布建。

從資源庫新增 Contentstack

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

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

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

設定及測試 Contentstack 的 Microsoft Entra SSO

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

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

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

設定 Microsoft Entra SSO

請遵循下列步驟，在 Microsoft Entra 系統管理中心啟用 Microsoft Entra SSO。

1. 以雲端應用程式 管理員 istrator 身分登入 Microsoft Entra 系統管理中心，並流覽至 [身分>識別應用程式>企業應用程式]。

2. 現在按兩下 [ + 新增應用程式 ]，然後搜尋Contentstack，然後按兩下 [ 建立]。 建立之後，現在請移至 [ 設定單一登錄 ]，或按下左側功能表中的 [單一登錄 ] 連結。

   

3. 接下來，在 [ 選取單一登錄方法] 頁面上，選取 [SAML]。

   

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

   

5. 在 [ 基本 SAML 組態 ] 區段中，您需要執行幾個步驟。 若要取得這些步驟所需的資訊，您必須先移至 Contentstack 應用程式，然後以下列方式建立 SSO 名稱和ACS URL ：

   a. 登入您的 Contentstack 帳戶，移至 [組織 設定] 頁面，然後按兩下 [單一登錄] 索引標籤。

   

   b. 輸入您選擇的 SSO 名稱，然後按下 [建立]。

   

   注意

   例如，如果您的公司名稱是 “Acme， Inc.” 在這裡輸入 「acme」。 登入時，組織使用者會使用此名稱作為其中一個登入認證。 SSO 名稱只能包含字母（小寫）、數位（0-9）和/或連字元 （-）。

   c. 當您按兩下 [ 建立] 時，這會產生判斷 提示取用者服務URL或ACS URL ，以及其他詳細數據，例如 實體識別碼、 屬性和 NameID格式。

   

6. 回到 [基本 SAML 組態] 區段，針對 [標識符] 和 [實體標識符] 和 [回復 URL] 區段，分別貼上上述步驟集所產生的實體標識碼和 ACS URL，然後儲存專案。

   1. 在 [ 標識符 ] 文本框中，貼上 您從 Contentstack 複製的 [實體識別符 ] 值。

      

   2. 在 [ 回復 URL] 文本框中，貼上 您從 Contentstack 複製的 ACS URL。

      

7. 這是選擇性步驟。 如果您要以 SP 起始模式設定應用程式，請針對 [登入 URL] 區段輸入登入 URL：

   

   注意

   當您完成設定 Contentstack SSO 時，您會發現 SSO 單鍵 URL （亦即登入 URL）。

8. Contentstack 應用程式需要特定格式的 SAML 判斷提示，因此您必須將自定義屬性對應新增至 SAML 令牌屬性組態。 下列螢幕擷取畫面顯示預設屬性的清單。

   

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

   名稱	來源屬性
   roles	user.assignedroles

   注意

   請按下 這裡 ，瞭解如何在 Microsoft Entra ID 中設定角色。

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

    

11. 在 [ 設定 Contentstack ] 區段上，根據您的需求複製適當的 URL。

    

建立 Microsoft Entra 測試使用者

在本節中，您將在名為 B.Simon 的 Microsoft Entra 系統管理中心建立測試使用者。

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

指派 Microsoft Entra 測試使用者

在本節中，您會將 Contentstack 的存取權授與 B.Simon，讓其能夠使用 Microsoft Entra 單一登錄。

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

設定 Contentstack SSO

1. 以系統管理員身分登入您的 Contentstack 公司網站。

2. 移至 [組織 設定] 頁面，然後按下左側功能表上的 [單一登錄] 索引標籤。

3. 在 [ 單一登錄 ] 頁面中，流覽至 [SSO 組態 ] 區段，然後執行下列步驟：

   1. 輸入您選擇的有效 SSO 名稱 ，然後按下 [ 建立]。

      

      注意

      例如，如果您的公司名稱是 “Acme， Inc.” 在這裡輸入 「acme」。 登入時，組織使用者會使用此名稱作為其中一個登入認證。 SSO 名稱只能包含字母（小寫）、數位（0-9）和/或連字元 （-）。

   2. 當您按下 [ 建立] 時，這會產生判斷 提示取用者服務 URL 或 ACS URL ，以及其他詳細數據，例如 實體識別碼、 屬性和 NameID 格式 ，然後按 [下一步]。

      

4. 瀏覽至 [ Idp 組態 ] 索引標籤，然後執行下列步驟：

   

   1. 在 [ 單一登錄 URL ] 文本框中，貼上 您從 Microsoft Entra 系統管理中心複製的 [登入 URL]。

   2. 從 Microsoft Entra 系統管理中心開啟下載的 憑證 （Base64）， 然後上傳至 [憑證 ] 字段。

   3. 按一下 [下一步] 。

5. 接下來，您必須在 Contentstack 中建立角色對應。

   注意

   只有在 IdP 角色對應是 Contentstack 計劃的一部分時，您才能檢視和執行此步驟。

6. 在 Contentstack SSO 安裝程式頁面的 [使用者管理] 區段中，您會看到 Strict Mode（僅透過 SSO 登入授權組織使用者的存取權）和 [工作階段逾時] （定義透過 SSO 登入的使用者工作階段持續時間）。 在這些選項下方，您也會看到 [進階 設定] 選項。

   

7. 按兩下 [進階 設定]，展開 [IdP 角色對應] 區段，將IdP角色對應至Contentstack。 這是選擇性步驟。

8. 在 [ 新增角色對應 ] 區段中，按兩下 [ + 新增角色對應 ] 連結，以新增IdP角色的對應詳細數據，其中包含下列詳細數據：

   

   1. 在IdP 角色識別碼中，輸入IdP群組/角色識別碼（例如「開發人員」），您可以使用指令清單中的值。

   2. 針對 [組織角色]，選取 [管理員] 或 [成員] 角色至對應的群組/角色。

   3. 針對 [ 堆棧層級許可權 ] （選擇性），請將堆疊和對應的堆疊層級角色指派給此角色。 同樣地，您可以為 Contentstack 組織新增更多角色對應。 若要新增角色對應，請按兩下 [ + 新增角色對應 ]，然後輸入詳細數據。

   4. 將角色分隔符保留空白，因為 Microsoft Entra ID 通常會傳回數位中的角色。

   5. 最後，選取 [ 啟用IdP角色對應] 複選框以啟用此功能，然後按 [下一步]。

   注意

   如需詳細資訊，請參閱 Contentstack SSO 指南。

9. 啟用 SSO 之前，建議您測試到目前為止所設定的 SSO 設定。 若要這樣，請執行下列步驟：

   1. 按兩下 [ 測試 SSO ] 按鈕，它會帶您前往 Contentstack 的 [透過 SSO 登入] 頁面，您必須在其中指定組織的 SSO 名稱。
   2. 然後，按兩下 [繼續] 以移至您的IdP登入頁面。
   3. 登入您的帳戶，如果您能夠登入您的 IdP，測試就會成功。
   4. 在成功連線時，您會看到成功訊息，如下所示。

   

10. 測試 SSO 設定之後，請按兩下 [ 啟用 SSO ] 為您的 Contentstack 組織啟用 SSO。

    

11. 啟用之後，使用者可以透過 SSO 存取組織。 如有需要，您也可以 從此頁面停用 SSO 。

    

建立 Contentstack 測試使用者

本節會在 Contentstack 中建立名為 Britta Simon 的使用者。 Contentstack 支援依預設啟用的 Just-In-Time 使用者布建。 本節中沒有適用於您的動作項目。 如果 Contentstack 中還沒有任何使用者存在，在驗證之後就會建立新的使用者。

測試 SSO

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

SP 起始：

• 按兩下 [ 在 Microsoft Entra 系統管理中心測試此應用程式 ]。 這會重新導向至您可以在其中起始登入流程的Contentstack登入URL。

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

IDP 起始：

• 按兩下 [ 在 Microsoft Entra 系統管理中心測試此應用程式 ]，您應該會自動登入您已設定 SSO 的 Contentstack。

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

下一步

設定 Contentstack 後，您可以強制執行工作階段控件，以即時防止組織的敏感數據遭到外泄和滲透。 會話控件會從條件式存取延伸。 瞭解如何使用 適用於雲端的 Microsoft Defender Apps 強制執行會話控件。