チュートリアル: Microsoft Entra シングル サインオン (SSO) と Harness の統合

  • [アーティクル]

このチュートリアルでは、Harness を Microsoft Entra ID と統合する方法について学習します。 Harness と Microsoft Entra ID を統合すると、次のことができます。

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

前提条件

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

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

シナリオの説明

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

注意

このアプリケーションの識別子は固定文字列値であるため、1 つのテナントで構成できるインスタンスは 1 つだけです。

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

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

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

Harness 用に Microsoft Entra SSO を構成してテストする

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

Harness に対して Microsoft Entra SSO を構成してテストするには、次の手順に従います:

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

Microsoft Entra SSO の構成

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

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

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

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

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

    Edit Basic SAML Configuration

  5. [基本的な SAML 構成] セクションで、アプリケーションを IDP 開始モードで構成する場合は、次の手順を実行します。

    [応答 URL] ボックスに、https://app.harness.io/gateway/api/users/saml-login?accountId=<harness_account_id> のパターンを使用して URL を入力します

  6. アプリケーションを SP 開始モードで構成する場合は、 [追加の URL を設定します] をクリックして次の手順を実行します。

    [サインオン URL] テキスト ボックスに、URL として「https://app.harness.io/」と入力します。

    注意

    応答 URL 値は、実際の値ではありません。 実際の応答 URL は、このチュートリアルの後半で説明する「Harness SSO の構成」セクションで取得します。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。

  7. [SAML によるシングル サインオンのセットアップ] ページの [SAML 署名証明書] セクションで、 [フェデレーション メタデータ XML] を探して [ダウンロード] を選択し、証明書をダウンロードして、お使いのコンピューターに保存します。

    The Certificate download link

  8. [Harness のセットアップ] セクションで、要件に基づいて適切な URL をコピーします。

    Copy configuration URLs

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 に Harness へのアクセスを許可することで、シングル サインオンを使用できるようにします。

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

Harness SSO の構成

  1. 別の Web ブラウザー ウィンドウで、Harness 企業サイトに管理者としてサインインします

  2. ページの右上で、 [Continuous Security](継続的なセキュリティ)>[Access Management](アクセス管理)>[Authentication Settings](認証設定) の順にクリックします。

    Screenshot that shows the

  3. [SSO Providers](SSO プロバイダー) セクションで、 [+ Add SSO Providers](+ SSO プロバイダーの追加)>[SAML] の順にクリックします。

    Screenshot that shows the

  4. [SAML Provider](SAML プロバイダー) ポップアップで、次の手順を実行します。

    Screenshot that shows the

    a. [SSO プロバイダーで SAML ベースのログインを有効にした後で次の URL を入力してください] インスタンスをコピーし、[基本的な SAML 構成] セクションの [応答 URL] ボックスに貼り付けます。

    b. [Display Name](表示名) ボックスに表示名を入力します。

    c. [Choose file] (ファイルの選択) をクリックして、Microsoft Entra ID からダウンロードしたフェデレーション メタデータ XML ファイルをアップロードします。

    d. [SUBMIT](送信) をクリックします。

Harness のテスト ユーザーの作成

Microsoft Entra ユーザーが Harness にサインインできるようにするには、そのユーザーを Harness にプロビジョニングする必要があります。 Harness では、プロビジョニングは手動で行います。

ユーザー アカウントをプロビジョニングするには、次の手順に従います。

  1. 管理者として Harness にサインインします。

  2. ページの右上で、 [Continuous Security](継続的なセキュリティ)>[Access Management](アクセス管理)>[Users](ユーザー) の順にクリックします。

    Screenshot that shows the

  3. ページの右側にある [+ Add User]\(+ ユーザーの追加) をクリックします。

    Screenshot that shows the

  4. [Add User](ユーザーの追加) ポップアップで、次の手順を実行します。

    Harness configuration

    a. [Email Address(es)](メール アドレス) ボックスに、ユーザーのメール アドレスを入力します (例: B.simon@contoso.com)。

    b. 対象のユーザー グループを選択します。

    c. [送信] をクリックします。

Harness では、自動ユーザー プロビジョニングもサポートされています。自動ユーザー プロビジョニングの構成方法について詳しくは、こちらをご覧ください。

SSO のテスト

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

SP Initiated:

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

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

IDP Initiated:

  • [このアプリケーションをテストします] をクリックすると、SSO を設定した Harness に自動的にサインインされるはずです。

また、Microsoft マイ アプリを使用して、任意のモードでアプリケーションをテストすることもできます。 マイ アプリで [Harness] タイルをクリックすると、SP モードで構成されている場合は、ログイン フローを開始するためのアプリケーション サインオン ページにリダイレクトされます。IDP モードで構成されている場合は、SSO を設定した Harness に自動的にサインインされます。 マイ アプリの詳細については、マイ アプリの概要に関するページを参照してください。

次のステップ

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