次の方法で共有

Microsoft Entra ID でシングル サインオン用に SonarQube を構成する

この記事では、SonarQube と Microsoft Entra ID を統合する方法について説明します。 SonarQube を Microsoft Entra ID を統合すると、次のことができます。

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

前提条件

この記事で説明するシナリオでは、次の前提条件が既にあることを前提としています。

  • SonarQube でのシングル サインオン (SSO) が有効なサブスクリプション。
  • SonarQube "SAML グループ属性" を正しく設定し、アクセス許可に AzureAD グループを使用する手順 (詳細は以下で説明します)。

注

SonarQube のインストールに関するヘルプは、オンライン ドキュメントで確認できます。

シナリオの説明

この記事では、テスト環境で Microsoft Entra SSO を構成してテストします。

  • SonarQube では、SP Initiated SSO がサポートされます。

注

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

Microsoft Entra ID への SonarQube の統合を構成するには、ギャラリーから管理対象 SaaS アプリの一覧に SonarQube を追加する必要があります。

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

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

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

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

SonarQube に対する Microsoft Entra SSO を構成してテストするには、次の手順を実行します。

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

Microsoft Entra SSO の構成

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

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

  2. Entra ID>Enterprise apps>SonarQube>シングルサインオンに移動する。

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

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

    基本的な SAML 構成を編集する

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

    ある。 [応答 URL] ボックスに、 https://sonar.<companyspecificurl>.io/oauth2/callback/saml のパターンを使用して URL を入力します

    b。 [サインオン URL] ボックスに、次のいずれかの URL を入力します。

    • 運用環境の場合

      https://servicessonar.corp.microsoft.com/

    • 開発環境の場合

      https://servicescode-dev.westus.cloudapp.azure.com

    注

    この値は実際の値ではありません。 実際の応答 URL で値を更新します。これについては、この記事の後半で説明します。

  6. [SAML でシングル サインオンをセットアップします] ページの [SAML 署名証明書] セクションで、 [証明書 (Base64)] を見つけて、 [ダウンロード] を選択し、証明書をダウンロードして、お使いのコンピューターに保存します。

    証明書のダウンロードのリンク

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

    構成 URL をコピーする

Microsoft Entra テスト ユーザーの作成と割り当て

ユーザー アカウントの作成と割り当ての クイックスタートのガイドラインに従って、B.Simon というテスト ユーザー アカウントを作成します。

SonarQube の SSO 構成

  1. 新しい Web ブラウザー ウィンドウを開き、SonarQube 企業サイトに管理者としてサインインします。

  2. [ Administration > Configuration > Security ] を選択し、 SAML プラグイン に移動して次の手順を実行します。

  3. 次の IdP メタデータの詳細をコピーし、SonarQube プラグインの対応するテキスト フィールドに貼り付けます。

    1. IdP エンティティ ID
    2. サインイン URL
    3. X.509 証明書

  4. すべての詳細を保存します。

    SAML プラグイン IDP

  5. [SAML] ページで、次の手順を実行します。

    Sonarqube の構成

    ある。 [Enabled](有効化) オプションを [yes](はい) に切り替えます。

    b。 [Application ID](アプリケーション ID) ボックスに、sonarqube のような名前を入力します。

    c. [Provider Name](プロバイダー名) ボックスに、SAML のような名前を入力します。

    d. [Provider ID] (プロバイダー ID) テキスト ボックスに、Microsoft Entra 識別子の値を貼り付けます。

    え [SAML ログイン URL] テキスト ボックスに [ログイン URL] の値を貼り付けます。

    f. Base 64 でエンコードされた証明書をメモ帳で開き、その内容をコピーして [プロバイダー証明書] テキスト ボックスに貼り付けます。

    ジー [SAML user login attribute](SAML ユーザー ログイン属性) ボックスに、値「http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name」を入力します。

    h. [SAML user name attribute](SAML ユーザー名属性) ボックスに、値「http://schemas.microsoft.com/identity/claims/displayname」を入力します。

    一. [SAML user email attribute](SAML ユーザー メール属性) ボックスに、値「http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress」を入力します。

    j. [保存] を選択します。

SonarQube の SAML グループ属性を構成する

SAML グループ属性を設定し、SonarQube のアクセス許可に AzureAD グループを使用するには、次の手順に従います。

  1. SonarQube の [管理] タブで、[構成] > [セキュリティ] > [SAML] に移動します
  2. [SAML グループ属性] テキスト ボックスに、次の値を入力します: 'http://schemas.microsoft.com/ws/2008/06/identity/claims/role'
  3. 変更を保存します
  4. SonarQube で、[管理] > [セキュリティ] > [グループ] に移動します
  5. AzureAD グループを SonarQube グループにマップします。
    • 各 AzureAD グループに対応するグループが存在しない場合は、SonarQube に作成します。
    • AzureAD と SonarQube の間でグループの名前が正確に一致していることを確認します。

SonarQube テスト ユーザーの作成

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

SSO のテスト

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

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

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

  • Microsoft マイ アプリを使用することができます。 マイ アプリで [SonarQube] タイルを選択すると、このオプションは SonarQube のサインオン URL にリダイレクトされます。 マイ アプリの詳細については、「マイ アプリの概要」を参照してください。

関連コンテンツ