Microsoft Entra SSO 與 Onyxia 整合

在本教學課程中，您將了解如何整合 Onyxia 與 Microsoft Entra ID。 在整合 Onyxia 與 Microsoft Entra ID 時，您可以：

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

必要條件

若要整合 Microsoft Entra ID 與 Onyxia，您需要滿足下列條件：

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

案例描述

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

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

從資源庫新增 Onyxia

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

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

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

設定及測試適用於 Onyxia 的 Microsoft Entra SSO

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

若要設定及測試 Onyxia 的 Microsoft Entra SSO，請執行下列步驟：

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

設定 Microsoft Entra SSO

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

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

2. 瀏覽至 [身分識別]> [應用程式]> [企業應用程式]> [Onyxia]> [單一登入]。

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

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

   

5. 在 [基本 SAML 設定] 設定區段上，已預先設定好應用程式，並已經為 Microsoft Entra 預先填入必要的 URL。 使用者必須按一下 [儲存] 按鈕，才能儲存設定。

6. 若要在 SP 起始模式中設定應用程式，請執行下列步驟：

   在 [登入 URL] 文字方塊中，輸入 URL：https://auth.onyxia.io/auth/saml/callback

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

   

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

   

建立 Microsoft Entra 測試使用者

在本節中，您將在 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 測試使用者

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

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

設定 Onyxia SSO

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

2. 移至 [設定]，然後選取 [帳戶設定]。

   

3. 瀏覽至 [SSO] 區段，然後按一下 [+ 新增連線]。

   

4. 在 [SSO 設定] 區段中，執行下列步驟：

   

   1. 在 [網域名稱] 文字輸入框中，輸入有效的功能變數名稱。

   2. 在 [SSO URL] 文字輸入框中，貼上您從 Microsoft Entra 系統管理中心複製的 [登入 URL]。

   3. 以記事本開啟已下載的憑證 (Base64)，然後將內容貼至 [公開憑證] 文字輸入框。

   4. 複製 [ACS URL]，並將其貼到 Microsoft Entra 系統管理中心 [基本 SAML 設定] 區段的 [回覆 URL] 文字輸入框中。

   5. 複製 [識別碼 (實體識別碼)]，並將其貼到 Microsoft Entra 系統管理中心 [基本 SAML 組態] 區段的 [識別碼 (實體識別碼)] 文字輸入框中。

   6. 按一下 [+ 建立]。

建立 Onyxia 測試使用者

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

測試 SSO

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

SP 起始：

• 在 Microsoft Entra 系統管理中心按一下 [測試此應用程式]。 系統會將您重新導向至 Onyxia 登入 URL，您可以在該處起始登入流程。

• 請直接進入 Onyxia 登入 URL，然後從該處起始登入流程。

IDP 起始：

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

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

下一步

設定好 Onyxia 之後，即可實施工作階段控制，以即時保護組織的敏感性資料，避免遭到外流和非法上傳。 工作階段控制項會從條件式存取延伸。 了解如何使用適用於雲端的 Microsoft Defender 應用程式來強制執行工作階段控制項。