チュートリアル: Microsoft Entra SSO と Perforce Helix Core - Helix Authentication Service の統合

  • [アーティクル]

このチュートリアルでは、Perforce Helix Core - Helix Authentication Service と Microsoft Entra ID を統合する方法について説明します。 Microsoft Entra ID と Perforce Helix Core - Helix Authentication Service を統合すると、次のことができます。

  • Perforce Helix Core - Helix Authentication Service にアクセスできるユーザーを Microsoft Entra ID で制御できます。
  • ユーザーが自分の Microsoft Entra アカウントを使用して Perforce Helix Core- Helix Authentication Service に自動的にサインインできるように設定できます。
  • 1 つの場所でアカウントを管理します。

前提条件

開始するには、次が必要です。

  • Microsoft Entra サブスクリプション。 サブスクリプションがない場合は、無料アカウントを取得できます。
  • Perforce Helix Core - Helix Authentication Service でのシングル サインオン (SSO) が有効なサブスクリプション。

Note

この統合は、Microsoft Entra 米国政府クラウド環境から利用することもできます。 このアプリケーションは、Microsoft Entra 米国政府クラウドのアプリケーション ギャラリーにあり、パブリック クラウドの場合と同じように構成できます。

シナリオの説明

このチュートリアルでは、テスト環境で Microsoft Entra の SSO を構成してテストします。

  • Perforce Helix Core - Helix Authentication Service では、SP Initiated SSO がサポートされます。

ギャラリーからの Perforce Helix Core - Helix Authentication Service の追加

Microsoft Entra ID への Perforce Helix Core - Helix Authentication Service の統合を構成するには、マネージド SaaS アプリの一覧にギャラリーから Perforce Helix Core - Helix Authentication Service を追加する必要があります。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[新しいアプリケーション] に移動します。
  3. [ギャラリーから追加する] セクションで、検索ボックスに、「Perforce Helix Core - Helix Authentication Service」と入力します。
  4. 結果のパネルから [Perforce Helix Core - Helix Authentication Service] を選択し、アプリを追加します。 お使いのテナントにアプリが追加されるのを数秒待機します。

または、Enterprise App Configuration ウィザードを使用することもできます。 このウィザードでは、SSO の構成に加えて、テナントへのアプリケーションの追加、アプリへのユーザーとグループの追加、ロールの割り当てを行うことができます。 Microsoft 365 ウィザードの詳細をご覧ください。

Perforce Helix Core - Helix Authentication Service の Microsoft Entra SSO の構成とテスト

B.Simon というテスト ユーザーを使用して、Perforce Helix Core - Helix Authentication Service に対する Microsoft Entra SSO を構成してテストします。 SSO が機能するためには、Microsoft Entra ユーザーと Perforce Helix Core - Helix Authentication Service の関連ユーザーとの間にリンク関係を確立する必要があります。

Perforce Helix Core - Helix Authentication Service で Microsoft Entra SSO を構成してテストするには、次の手順を行います。

  1. Microsoft Entra SSO を構成する - ユーザーがこの機能を使用できるようにします。
    1. Microsoft Entra のテスト ユーザーの作成 - B.Simon を使用して Microsoft Entra シングル サインオンをテストします。
    2. Microsoft Entra テスト ユーザーを割り当てる - B.Simon が Microsoft Entra シングル サインオンを使用できるようにします。
  2. Perforce Helix Core - Helix Authentication Service SSO の構成 - アプリケーション側でシングル サインオン設定を構成します。
    1. Perforce Helix Core - Helix Authentication Service テスト ユーザーの作成 - Perforce Helix Core- Helix Authentication Service で B.Simon に対応するユーザーを作成し、Microsoft Entra の B.Simon にリンクさせます。
  3. SSO のテスト - 構成が機能するかどうかを確認します。

Microsoft Entra SSO の構成

次の手順に従って Microsoft Entra SSO を有効にします。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。

  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[Perforce Helix Core - Helix Authentication Service]>[シングル サインオン] の順に移動します。

  3. [シングル サインオン方式の選択] ページで、 [SAML] を選択します。

  4. [SAML によるシングル サインオンのセットアップ] ページで、 [基本的な SAML 構成] の鉛筆アイコンをクリックして設定を編集します。

    Edit Basic SAML Configuration

  5. [基本的な SAML 構成] セクションで、次の手順を実行します。

    a. [識別子 (エンティティ ID)] ボックスに、次のパターンを使用して URL を入力します。https://<HELIX-AUTH-SERVICE>.<CUSTOMER_HOSTNAME>.com/saml

    b. [応答 URL] ボックスに、https://<HELIX-AUTH-SERVICE>.<CUSTOMER_HOSTNAME>.com/saml/sso のパターンを使用して URL を入力します

    c. [サインオン URL] ボックスに、次のパターンを使用して URL を入力します。https://<HELIX-AUTH-SERVICE>.<CUSTOMER_HOSTNAME>.com/

    注意

    これらは実際の値ではありません。 これらの値は、実際の識別子、応答 URL、サインオン URL で更新してください。 これらの値を取得するには、Perforce Helix Core - Helix Authentication Service クライアント サポート チームに問い合わせてください。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。

  6. [Set up single sign-on with SAML](SAML でシングル サインオンをセットアップします) ページの [SAML 署名証明書] セクションで、コピー ボタンをクリックして [アプリのフェデレーション メタデータ URL] をコピーして、お使いのコンピューターに保存します。

    The Certificate download link

Microsoft Entra テスト ユーザーを作成する

このセクションでは、B.Simon というテスト ユーザーを作成します。

  1. Microsoft Entra 管理センターにユーザー管理者以上でサインインしてください。
  2. [ID]>[ユーザー]>[すべてのユーザー] の順に移動します。
  3. 画面の上部で [新しいユーザー]>[新しいユーザーの作成] を選択します。
  4. [ユーザー] プロパティで、以下の手順を実行します。
    1. "表示名" フィールドに「B.Simon」と入力します。
    2. [ユーザー プリンシパル名] フィールドに「username@companydomain.extension」と入力します。 たとえば、「 B.Simon@contoso.com 」のように入力します。
    3. [パスワードを表示] チェック ボックスをオンにし、 [パスワード] ボックスに表示された値を書き留めます。
    4. [Review + create](レビュー + 作成) を選択します。
  5. [作成] を選択します。

Microsoft Entra テスト ユーザーを割り当てる

このセクションでは、B.Simon に Perforce Helix Core - Helix Authentication Service へのアクセスを許可することで、このユーザーがシングル サインオンを使用できるようにします。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[Perforce Helix Core - Helix Authentication Service] の順に移動します。
  3. アプリの概要ページで、[ユーザーとグループ] を選択します。
  4. [ユーザーまたはグループの追加] を選択し、 [割り当ての追加] ダイアログで [ユーザーとグループ] を選択します。
    1. [ユーザーとグループ] ダイアログの [ユーザー] の一覧から [B.Simon] を選択し、画面の下部にある [選択] ボタンをクリックします。
    2. ユーザーにロールが割り当てられることが想定される場合は、 [ロールの選択] ドロップダウンからそれを選択できます。 このアプリに対してロールが設定されていない場合は、[既定のアクセス] ロールが選択されていることを確認します。
    3. [割り当ての追加] ダイアログで、 [割り当て] をクリックします。

Perforce Helix Core - Helix Authentication Service SSO の構成

Perforce Helix Core - Helix Authentication Service 側でシングル サインオンを構成するには、アプリのフェデレーション メタデータ URL を Perforce Helix Core - Helix Authentication Service サポート チームに送信する必要があります。 サポート チームはこれを設定して、SAML SSO 接続が両方の側で正しく設定されるようにします。

Perforce Helix Core - Helix Authentication Service テスト ユーザーの作成

このセクションでは、Perforce Helix Core - Helix Authentication Service で Britta Simon というユーザーを作成します。 Perforce Helix Core - Helix Authentication Service サポート チームと連携して、Perforce Helix Core - Helix Authentication Service プラットフォームにユーザーを追加してください。 シングル サインオンを使用する前に、ユーザーを作成し、有効化する必要があります。

SSO のテスト

このセクションでは、次のオプションを使用して Microsoft Entra のシングル サインオン構成をテストします。

  • [このアプリケーションをテストします] をクリックします。これにより、ログイン フローを開始できる Perforce Helix Core - Helix Authentication Service のサインオン URL にリダイレクトされます。

  • Perforce Helix Core - Helix Authentication Service のサインオン URL に直接移動し、そこからログイン フローを開始します。

  • Microsoft マイ アプリを使用することができます。 マイ アプリ で [Perforce Helix Core - Helix Authentication Service] タイルをクリックすると、Perforce Helix Core - Helix Authentication Service のサインオン URL にリダイレクトされます。 マイ アプリの詳細については、マイ アプリの概要に関するページを参照してください。

次のステップ

Perforce Helix Core - Helix Authentication Service を構成したら、組織の機密データを流出と侵入からリアルタイムで保護するセッション制御を適用することができます。 セッション制御は、条件付きアクセスを拡張したものです。 Microsoft Defender for Cloud Apps でセッション制御を強制する方法をご覧ください。