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

發行項
07/06/2024

此教學課程將說明為設定自動使用者佈建，而必須在 Postman 與 Microsoft Entra ID 中執行的步驟。設定後，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，對 Postman 自動佈建及取消佈建使用者和群組。如需此服務的用途、運作方式和常見問題等重要詳細資訊，請參閱使用 Microsoft Entra ID 對 SaaS 應用程式自動佈建和取消佈建使用者。

支援的功能

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

必要條件

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

Microsoft Entra 租用戶。
下列角色其中之一：應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
企業方案的 Postman 租用戶。
Postman 中具有管理員權限的使用者帳戶。

步驟 1：規劃佈建部署

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

步驟 2：設定 Postman 以支援使用 Microsoft Entra ID 進行佈建

在開始設定 Postman 以支援使用 Microsoft Entra ID 進行佈建之前，您必須在 Postman 管理主控台內產生 SCIM API 權杖。

注意

您可以造訪 Postman SCIM 佈建概觀 (英文) 頁面，以參閱在 Postman 中啟用 SCIM 佈建 (英文) 步驟。

登入您的 Postman 帳戶，以瀏覽至 Postman 管理主控台 (英文)。
登入之後，按一下右側的 [小組]，然後按一下 [小組設定]。
選取提要欄位中的 [驗證]，然後開啟 [SCIM 佈建] 切換。
您會收到一則快顯訊息，詢問您是否要開啟 SCIM 佈建，按一下 [開啟] 以啟用 SCIM 佈建。
若要 [產生 SCIM API 金鑰]，請執行下列步驟：
1. 選取 [SCIM 佈建] 區段中的 [產生 SCIM API 金鑰]。
2. 輸入金鑰的名稱，然後按一下 [產生]。
3. 複製新的 API 金鑰以供稍後使用，然後按一下 [完成]。
注意

您可以重新造訪此頁面來管理 SCIM API 金鑰。如果您重新產生現有的 API 金鑰，則可以選擇在切換時讓第一個金鑰保持作用中狀態。

注意

若要繼續啟用 SCIM 佈建，請參閱使用 Microsoft Entra ID 來設定 SCIM (英文)。如需進一步的資訊或需要協助設定 SCIM，請連絡 Postman 支持 (英文)。

步驟 3：從 Microsoft Entra 應用程式庫新增 Postman

從 Microsoft Entra 應用程式庫新增 Postman，以開始管理對 Postman 的佈建。如果您先前已針對 SSO 設定 Postman，則可使用相同的應用程式。不過，建議您在一開始測試整合時，建立個別的應用程式。在此深入了解從資源庫新增應用程式。

步驟 4：定義佈建範圍內的人員

Microsoft Entra 佈建服務可讓您根據對應用程式的指派，和/或根據使用者/群組屬性，界定將要對其進行佈建的人員。如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者和群組指派給應用程式。如果選擇僅根據使用者或群組屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。

從小規模開始。在推出給所有人之前，先使用一小部分的使用者和群組進行測試。當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。當範圍設為所有使用者和群組時，您可以指定屬性型範圍篩選條件。
如需其他角色，可以更新應用程式資訊清單以新增角色。

步驟 5：設定將使用者自動佈建至 Postman

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

若要在 Microsoft Entra ID 中為 Postman 設定自動使用者佈建：

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

屬性類型支援篩選 Postman 所需項目

userName String ✓ ✓

作用中布林值 ✓

name.givenName String ✓

name.familyName String ✓
在 [對應] 區段底下，選取 [將 Microsoft Entra 群組同步至 Postman]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步至 Postman 的群組屬性。選取為比對屬性的屬性會用來比對 Postman 中的群組以進行更新作業。選取 [儲存] 按鈕以認可所有變更。

屬性類型支援篩選 Postman 所需項目

displayName String ✓ ✓

成員參考
若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
如要啟用 Postman 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。
藉由在 [設定] 區段的 [範圍] 中選擇所需的值，定義要佈建至 Postman 的使用者和/或群組。
當您準備好要佈建時，按一下 [儲存]。