教學課程:Microsoft Entra SSO 與 Postman 整合
在本教學課程中,您將了解如何整合 Postman 與 Microsoft Entra ID。 整合 Postman 與 Microsoft Entra ID 時,您可以:
- 在 Microsoft Entra ID 中控制可存取 Postman 的人員。
- 協助使用者以其 Microsoft Entra 帳戶自動登入 Postman。
- 在一個集中式位置管理您的帳戶。
必要條件
若要開始使用,您需要下列項目:
- Microsoft Entra 訂用帳戶。 如果您沒有訂用帳戶,可以取得免費帳戶。
- 已啟用 Postman 單一登入 (SSO) 的訂用帳戶。
注意
此整合也可從 Microsoft Entra US Government 雲端環境使用。 您可以在 Microsoft Entra US Government 雲端應用程式資源庫中找到此應用程式,並以您從公用雲端所做的相同方式進行設定。
案例描述
在本教學課程中,您會在測試環境中設定及測試 Microsoft Entra SSO。
- Postman 支援由 SP 和 IDP 起始的 SSO。
- Postman 支援 Just In Time 使用者佈建。
注意
此應用程式的識別碼是固定的字串值,因此一個租用戶中只能設定一個執行個體。
從資源庫新增 Postman
若要設定將 Postman 整合到 Microsoft Entra ID 中,您需要從資源庫將 Postman 新增到受控 SaaS app 清單。
- 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
- 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]。
- 在 [從資源庫新增] 區段的搜尋方塊中輸入 Postman。
- 從結果面板中選取 [Postman],然後新增應用程式。 將應用程式新增至您的租用戶時,請稍候幾秒鐘。
或者,您也可以使用企業應用程式組態精靈。 在此精靈中,您可以將應用程式新增至租用戶、將使用者/群組新增至應用程式、指派角色,以及逐步進行 SSO 設定。 深入了解 Microsoft 365 精靈。
設定及測試 Postman 的 Microsoft Entra SSO
以名為 B.Simon 的測試使用者,設定及測試與 Postman 搭配運作的 Microsoft Entra SSO。 若要讓 SSO 能夠運作,您必須建立 Microsoft Entra 使用者與 Postman 中相關使用者之間的連結關聯性。
若要設定及測試與 Postman 搭配的 Microsoft Entra SSO,請執行下列步驟:
- 設定 Microsoft Entra SSO - 讓使用者能夠使用此功能。
- 建立 Microsoft Entra 測試使用者 - 以使用 B.Simon 測試 Microsoft Entra 單一登入。
- 指派 Microsoft Entra 測試使用者 - 讓 B.Simon 使用 Microsoft Entra 單一登入。
- 設定 Postman SSO - 在應用程式端設定單一登入設定。
- 建立 Postman 測試使用者 - 使 Postman 中對應的 B.Simon 連結到該使用者在 Microsoft Entra 中的代表項目。
- 測試 SSO - 確認組態是否正常運作。
設定 Microsoft Entra SSO
遵循下列步驟來啟用 Microsoft Entra SSO。
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [Postman] > [單一登入]。
在 [選取單一登入方法] 頁面上,選取 [SAML]。
在 [以 SAML 設定單一登入] 頁面上,按一下 [基本 SAML 設定] 的鉛筆圖示,以編輯設定。
在 [基本 SAML 設定] 區段上,如果您想要以 IDP 起始模式設定應用程式,請執行下列步驟:
在 [回覆 URL] 文字方塊中,使用下列模式來輸入 URL:
https://identity.getpostman.com/sso/<INSTANCE_NAME>/callback
如果您想要以 SP 起始模式設定應用程式,請按一下 [設定其他 URL],然後執行下列步驟:
在 [登入 URL] 文字方塊中,以下列模式輸入 URL︰
https://identity.getpostman.com/sso/<INSTANCE_NAME>/init
注意
這些都不是真正的值。 請使用實際的回覆 URL 與登入 URL 更新這些值。 請連絡 Postman 用戶端支援小組以取得這些值。 您也可以參考 [基本 SAML 設定] 區段中所示的模式。
Postman 應用程式需要特定格式的 SAML 判斷提示,需要您在 SAML 權杖屬性設定新增自訂屬性對應。 以下螢幕擷取畫面顯示上述的範例。 [唯一的使用者識別碼] 的預設值是 user.userprincipalname,但是 Postman 會預期這是與使用者電子郵件地址對應的值。 對此您可以使用清單中的 user.mail 屬性,或者根據組織組態使用適當的屬性值。
在 [以 SAML 設定單一登入] 頁面上的 [SAML 簽署憑證] 區段中,尋找 [同盟中繼資料 XML],然後選取 [下載],以下載憑證並將其儲存在電腦上。
在 [設定 Postman] 區段上,根據您的需求複製適當的 URL。
建立 Microsoft Entra 測試使用者
在本節中,您將建立名為 B.Simon 的測試使用者。
- 以至少是使用者管理員的身分登入 Microsoft Entra 系統管理中心。
- 瀏覽至 [身分識別]>[使用者]>[所有使用者]。
- 在畫面頂端選取 [新增使用者] > [建立新使用者]。
- 在 [使用者] 屬性中,執行下列步驟:
- 在 [顯示名稱] 欄位中,輸入
B.Simon
。 - 在 [使用者主體名稱] 欄位中,輸入 username@companydomain.extension。 例如:
B.Simon@contoso.com
。 - 選取 [顯示密碼] 核取方塊,然後記下 [密碼] 方塊中顯示的值。
- 選取 [檢閱 + 建立]。
- 在 [顯示名稱] 欄位中,輸入
- 選取 建立。
指派 Microsoft Entra 測試使用者
在本節中,您會將 Postman 的存取權授與 B.Simon,讓其能夠使用單一登入。
- 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
- 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [Postman]。
- 在應用程式的概觀頁面中,選取 [使用者和群組]。
- 選取 [新增使用者/群組],然後在 [新增指派] 對話方塊中選取 [使用者和群組]。
- 在 [使用者和群組] 對話方塊中,從 [使用者] 列表中選取 [B.Simon],然後按一下畫面底部的 [選取] 按鈕。
- 如果您預期將角色指派給使用者,則可以從 [選取角色] 下拉式清單中選取該角色。 如果未為此應用程式設定任何角色,您會看到已選取 [預設存取權] 角色。
- 在 [新增指派] 對話方塊中,按一下 [指派] 按鈕。
設定 Postman SSO
若要在 Postman 端設定單一登入,您必須在 Postman 中上傳所下載的 [同盟中繼資料 XML] 和更新適當的已複製 URL。 若要了解如何設定 Postman SSO,請參閱逐步指南。
建立 Postman 測試使用者
本節會在 Postman 中建立名為 Britta Simon 的使用者。 Postman 支援 just-in-time 使用者佈建,您可以選取自動新增使用者的核取方塊來加以啟用。 如此一來,如果 Postman 中還沒有任何使用者存在,在驗證之後就會建立新的使用者。
測試 SSO
在本節中,您會使用下列選項來測試您的 Microsoft Entra 單一登入設定。
SP 起始:
按一下 [測試此應用程式],這樣會重新導向至 Postman 登入 URL,您可以在其中起始登入流程。
直接移至 Postman 登入 URL,然後從該處起始登入流程。
IDP 起始:
- 按一下 [測試此應用程式],您應該會自動登入已設定 SSO 的 Postman。
您也可以使用 Microsoft「我的應用程式」,以任何模式測試應用程式。 當您按一下 [我的應用程式] 中的 [Postman] 圖格時,如果是在 SP 模式中設定,您會重新導向 [應用程式登入] 頁面來起始登入流程,如果是在 IDP 模式中設定,則應該會自動登入已設定 SSO 的 Postman。 如需「我的應用程式」的詳細資訊,請參閱我的應用程式簡介。
下一步
設定 Postman 後,您可以強制執行工作階段控制項,以即時防止組織的敏感資料遭到外洩和滲透。 工作階段控制項會從條件式存取延伸。 了解如何使用適用於雲端的 Microsoft Defender 應用程式來強制執行工作階段控制項。