この記事では、Postman と Microsoft Entra ID を統合する方法について説明します。 Postman を Microsoft Entra ID と統合すると、次のことができます。
- Postman にアクセスできるユーザーを Microsoft Entra ID で制御する。
- ユーザーが自分の Microsoft Entra アカウントを使用して Postman に自動的にサインインできるようにする。
- 1 つの中央の場所でアカウントを管理します。
[前提条件]
この記事で説明するシナリオでは、次の前提条件が既にあることを前提としています。
- アクティブなサブスクリプションを持つ Microsoft Entra ユーザー アカウント。 まだアカウントがない場合は、無料でアカウントを作成することができます。
- 次のいずれかのロール:
- Postman でのシングル サインオン (SSO) が有効なサブスクリプション。
注
この統合は、Microsoft Entra 米国政府クラウド環境から利用することもできます。 このアプリケーションは、Microsoft Entra 米国政府クラウドのアプリケーション ギャラリーにあり、パブリック クラウドの場合と同じように構成できます。
シナリオの説明
この記事では、テスト環境で Microsoft Entra SSO を構成してテストします。
- Postman では、SP Initiated SSO と IDP Initiated SSO がサポートされます。
- Postman では、Just-In-Time ユーザー プロビジョニングがサポートされます。
注
このアプリケーションの識別子は固定文字列値であるため、1 つのテナントで構成できるインスタンスは 1 つだけです。
ギャラリーからの Postman の追加
Microsoft Entra ID への Postman の統合を構成するには、ギャラリーからマネージド SaaS アプリのリストに Postman を追加する必要があります。
- クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
- Entra ID>のEnterprise apps>に移動し、新しいアプリケーションを選択します。
- [ギャラリーから追加する] セクションで、検索ボックスに、「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 管理センターにサインインします。
Entra ID>Enterprise apps>Postman>シングルサインオンに移動します。
[シングル サインオン方式の選択] ページで、 [SAML] を選択します。
[ SAML でのシングル サインオンの設定 ] ページで、[ 基本的な SAML 構成 ] の鉛筆アイコンを選択して設定を編集します。
[基本的な SAML 構成] セクションで、アプリケーションを IDP 開始モードで構成する場合は、次の手順を実行します。
[ 応答 URL ] テキスト ボックスに、次のパターンを使用して URL を入力します。
https://identity.getpostman.com/sso/<INSTANCE_NAME>/callback追加の URL を設定 を選択し、SP 開始モードでアプリケーションを構成する場合は、次の手順を実行します。
[ サインオン URL ] テキスト ボックスに、次のパターンを使用して URL を入力します。
https://identity.getpostman.com/sso/<INSTANCE_NAME>/init注
これらの値は実際の値ではありません。 実際の応答 URL とサインオン URL でこれらの値を更新します。 これらの値を取得するには、Postman クライアント サポート チームに問い合わせてください。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。
Postman アプリケーションでは、特定の形式の SAML アサーションを使用するため、カスタム属性のマッピングを SAML トークンの属性の構成に追加する必要があります。 次のスクリーンショットはその例です。 [一意のユーザー ID] の既定値は user.userprincipalname ですが、Postman ではこれをユーザーのメール アドレスにマップすることが求められます。 そのため、リストから user.mail 属性を使用するか、組織の構成に基づいて適切な属性値を使用できます。
[ SAML でのシングル サインオンの設定 ] ページの [ SAML 署名証明書 ] セクションで、 フェデレーション メタデータ XML を探し、[ ダウンロード ] を選択して証明書をダウンロードし、コンピューターに保存します。
[Postman のセットアップ] セクションで、要件に基づいて適切な URL をコピーします。
Microsoft Entra テスト ユーザーの作成と割り当て
ユーザー アカウントの作成と割り当ての クイックスタートのガイドラインに従って、B.Simon というテスト ユーザー アカウントを作成します。
Postman の SSO の構成
Postman 側でシングル サインオンを構成するには、ダウンロードしたフェデレーション メタデータ XML をアップロードし、コピーした適切な URL を Postman で更新する必要があります。 Postman の SSO を構成する方法については、ステップ バイ ステップ ガイドを参照してください。
Postman のテスト ユーザーの作成
このセクションでは、Britta Simon というユーザーを Postman に作成します。 Postman では、Just-In-Time ユーザー プロビジョニングがサポートされています。この設定を有効にするには、[Automatically add new users](新しいユーザーを自動的に追加する) チェック ボックスをオンにします。 この状態で Postman にユーザーがまだ存在していない場合は、認証後に新規に作成されます。
SSO のテスト
このセクションでは、次のオプションを使用して Microsoft Entra のシングル サインオン構成をテストします。
SP 開始:
[ このアプリケーションをテストする] を選択すると、このオプションはログイン フローを開始できる Postman のサインオン URL にリダイレクトされます。
Postman のサインオン URL に直接移動し、そこからログイン フローを開始します。
IDP 起動しました。
- [ このアプリケーションをテストする] を選択すると、SSO を設定した Postman に自動的にサインインします。
Microsoft マイ アプリを使用して、任意のモードでアプリケーションをテストすることもできます。 マイ アプリで [Postman] タイルを選択すると、SP モードで構成されている場合は、ログイン フローを開始するためのアプリケーション サインオン ページにリダイレクトされます。IDP モードで構成されている場合は、SSO を設定した Postman に自動的にサインインされます。 マイ アプリの詳細については、マイ アプリの概要に関するページを参照してください。
関連コンテンツ
Postman を構成したら、組織の機密データを流出と侵入からリアルタイムで保護するセッション制御を適用できます。 セッション制御は条件付きアクセスから拡張されます。 Microsoft Defender for Cloud Appsでセッション制御を適用する方法について説明します。