クイックスタート: Java Web アプリからユーザーをサインインさせ、Microsoft Graph API を呼び出す

[アーティクル]
02/06/2025

このクイックスタートでは、Java Web アプリケーションがユーザーをサインインさせ、Microsoft Graph API を呼び出す方法を示すコードサンプルをダウンロードして実行します。 Microsoft Entra 組織のユーザーは、アプリケーションにサインインできます。

図については、「サンプルのしくみを参照してください。

前提条件

このサンプルを実行するには、次のものが必要です。

Java Development Kit (JDK) 8 以降。
Maven。

クイックスタートアプリを登録してダウンロードする

クイックスタートアプリケーションを開始するには、express (オプション 1) と手動 (オプション 2) の 2 つの方法があります。

オプション 1: アプリを登録して自動的に構成し、コードサンプルをダウンロードする

クラウドアプリケーション管理者以上の権限で Microsoft Entra 管理センター - アプリの登録クイックスタートエクスペリエンスに移動します。
アプリケーションの名前を入力し、次に [登録] を選択します。
ポータルのクイックスタートエクスペリエンスの手順に従って、自動的に構成されたアプリケーションコードをダウンロードします。

オプション 2: アプリケーションとコードサンプルを登録して手動で構成する

手順 1: アプリケーションを登録する

アプリケーションを登録し、アプリの登録情報を手動で追加するには、次の手順に従います。

少なくともクラウドアプリケーション管理者として、Microsoft Entra 管理センターにサインインします。
複数のテナントにアクセスできる場合は、上部のメニュー設定アイコンを使用して、ディレクトリ + サブスクリプション メニューからアプリケーションを登録するテナントに切り替えます。
[ID]、[アプリケーション]、[アプリの登録] の順に移動し、[新規登録] を選択します。
アプリケーションの名を入力します (例: java-webapp )。アプリのユーザーには、この名前が表示される場合があります。後で変更できます。
[登録] を選択します。
[の概要] ページで、アプリケーション (クライアント) ID と ディレクトリ (テナント) IDをメモします。これらの値は後で必要になります。
[管理] で、[認証] を選択します。
[プラットフォームの追加>Web] を選択します。
[リダイレクト URI] セクションに、「https://localhost:8443/msal4jsample/secure/aad」と入力します。
を選択し、を構成します。
[Web] セクションの [リダイレクト URI] で、2 番目のリダイレクト URI として「https://localhost:8443/msal4jsample/graph/me」と入力します。
[管理]で、[証明書とシークレット] を選択します。 [クライアントシークレット] セクションで、[新しいクライアントシークレット] を選択します。
キーの説明 (たとえば、アプリシークレット) を入力し、既定の有効期限のままにして、[追加] を選択します。
クライアントシークレットの値に注意してください。後で必要になります。

手順 2: コードサンプルをダウンロードする

コードサンプルのをダウンロードする

手順 3: コードサンプルを構成する

zip ファイルをローカルフォルダーに抽出します。
随意。 統合開発環境を使用する場合は、その環境でサンプルを開きます。
application.properties ファイルを開きます。これは、src/main/resources/ フォルダーにあります。 aad.clientId、aad.authority、aad.secretKey の各フィールドの値を、それぞれアプリケーション ID、テナント ID、クライアントシークレットの値に置き換えます。次のような外観になります。
```
 aad.clientId=Enter_the_Application_Id_here
 aad.authority=https://login.microsoftonline.com/Enter_the_Tenant_Info_Here/
 aad.secretKey=Enter_the_Client_Secret_Here
 aad.redirectUriSignin=https://localhost:8443/msal4jsample/secure/aad
 aad.redirectUriGraph=https://localhost:8443/msal4jsample/graph/me
 aad.msGraphEndpointHost="https://graph.microsoft.com/"
```

前のコードでは、次の手順を実行します。

Enter_the_Application_Id_here は、登録したアプリケーションのアプリケーション ID です。
Enter_the_Client_Secret_Here は、登録済みアプリケーション用に [証明書とシークレット] で作成した [クライアントシークレット] です。
Enter_the_Tenant_Info_Here は、登録したアプリケーションの ディレクトリ (テナント) ID 値です。

localhost で HTTPS を使用するには、server.ssl.key プロパティを指定します。自己署名証明書を生成するには、keytool ユーティリティ (JRE に含まれる) を使用します。

次に例を示します。

keytool -genkeypair -alias testCert -keyalg RSA -storetype PKCS12 -keystore keystore.p12 -storepass password

server.ssl.key-store-type=PKCS12
server.ssl.key-store=classpath:keystore.p12
server.ssl.key-store-password=password
server.ssl.key-alias=testCert

生成されたキーストアファイルを、リソース フォルダーに配置します。

手順 4: コードサンプルを実行する

プロジェクトを実行するには、次のいずれかの手順を実行します。

埋め込み Spring Boot サーバーを使用して、IDE から直接実行します。
Maven を使用して WAR ファイルにパッケージ化してから、Apache Tomcat などの J2EE コンテナーソリューションにデプロイします。

IDE からプロジェクトを実行する

IDE から Web アプリケーションを実行するには、[実行] を選択し、プロジェクトのホームページに移動します。このサンプルでは、標準のホームページ URL が https://localhost:8443.

フロントページで、ログイン ボタンを選択して、ユーザーを Microsoft Entra ID にリダイレクトし、資格情報の入力を求めます。
ユーザーが認証されると、ユーザーは https://localhost:8443/msal4jsample/secure/aadにリダイレクトされます。これでサインインし、ページにユーザーアカウントに関する情報が表示されます。サンプル UI には、次のボタンがあります。
- サインアウト: 現在のユーザーをアプリケーションからサインアウトし、そのユーザーをホームページにリダイレクトします。
- ユーザー情報の表示: Microsoft Graph のトークンを取得し、トークンを含む要求で Microsoft Graph を呼び出します。この要求は、サインインしているユーザーに関する基本情報を返します。

Tomcat からプロジェクトを実行する

Web サンプルを Tomcat にデプロイする場合は、ソースコードをいくつか変更します。

ms-identity-java-webapp/src/main/java/com.microsoft.azure.msalwebsample/MsalWebSampleApplicationを開きます。

すべてのソースコードを削除し、次のコードに置き換えます。

 package com.microsoft.azure.msalwebsample;

 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.boot.builder.SpringApplicationBuilder;
 import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

 @SpringBootApplication
 public class MsalWebSampleApplication extends SpringBootServletInitializer {

  public static void main(String[] args) {
   SpringApplication.run(MsalWebSampleApplication.class, args);
  }

  @Override
  protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
   return builder.sources(MsalWebSampleApplication.class);
  }
 }

Tomcat の既定の HTTP ポートは 8080 ですが、ポート 8443 経由の HTTPS 接続が必要です。この設定を構成するには:

tomcat/conf/server.xmlに移動します。

<connector> タグを検索し、既存のコネクタを次のコネクタに置き換えます。

<Connector
         protocol="org.apache.coyote.http11.Http11NioProtocol"
         port="8443" maxThreads="200"
         scheme="https" secure="true" SSLEnabled="true"
         keystoreFile="C:/Path/To/Keystore/File/keystore.p12" keystorePass="KeystorePassword"
         clientAuth="false" sslProtocol="TLS"/>

コマンドプロンプトウィンドウを開きます。このサンプルのルートフォルダー (pom.xml ファイルがある場所) に移動し、mvn package 実行してプロジェクトをビルドします。
- このコマンドを実行すると、/targets ディレクトリに msal-web-sample-0.1.0.war ファイルが生成されます。
- このファイルの名前を msal4jsample.warに変更します。
- Tomcat またはその他の J2EE コンテナーソリューションを使用して WAR ファイルをデプロイします。
  - msal4jsample.war ファイルをデプロイするには、Tomcat インストールの /webapps/ ディレクトリにコピーし、Tomcat サーバーを起動します。
ファイルがデプロイされたら、ブラウザーを使用して https://localhost:8443/msal4jsample に移動します。

重要

このクイックスタートアプリケーションでは、クライアントシークレットを使用して、自身を機密クライアントとして識別します。クライアントシークレットはプレーンテキストとしてプロジェクトファイルに追加されるため、セキュリティ上の理由から、運用環境でアプリケーションを使用する前に、クライアントシークレットの代わりに証明書を使用することをお勧めします。証明書の使用方法の詳細については、「アプリケーション認証のための証明書資格情報」を参照してください。

詳細情報

サンプルのしくみ

このクイックスタートで生成されたサンプルアプリの動作を示す図。

MSAL を取得する

MSAL for Java (MSAL4J) は、Microsoft ID プラットフォームによって保護されている API へのアクセスに使用されるユーザーのサインインとトークンの要求に使用される Java ライブラリです。

Maven または Gradle を使用してアプリケーションに MSAL4J を追加し、アプリケーションの pom.xml (Maven) または build.gradle (Gradle) ファイルに次の変更を加えて依存関係を管理します。

pom.xml 内:

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>msal4j</artifactId>
    <version>1.0.0</version>
</dependency>

build.gradle の場合:

compile group: 'com.microsoft.azure', name: 'msal4j', version: '1.0.0'

MSAL を初期化する

MSAL for Java への参照を追加するには、MSAL4J を使用するファイルの先頭に次のコードを追加します。

import com.microsoft.aad.msal4j.*;

ヘルプとサポート

ヘルプが必要な場合、問題を報告する場合、またはサポートオプションについて知りたい場合は、「ヘルプと開発者向けのサポート」を参照。

次の手順

Microsoft ID プラットフォームでユーザーをサインインする Web アプリの構築の詳細については、マルチパートシナリオシリーズを参照してください。

シナリオ: ユーザーをサインインさせる Web アプリ

次の方法で共有

前提条件

クイックスタートアプリを登録してダウンロードする

オプション 1: アプリを登録して自動的に構成し、コードサンプルをダウンロードする

オプション 2: アプリケーションとコードサンプルを登録して手動で構成する

手順 1: アプリケーションを登録する

手順 2: コードサンプルをダウンロードする

手順 3: コードサンプルを構成する

手順 4: コードサンプルを実行する

IDE からプロジェクトを実行する

Tomcat からプロジェクトを実行する

詳細情報

サンプルのしくみ

MSAL を取得する

MSAL を初期化する

ヘルプとサポート

次の手順

フィードバック

その他のリソース

次の方法で共有

クイック スタート: Java Web アプリからユーザーをサインインさせ、Microsoft Graph API を呼び出す

前提 条件

クイックスタート アプリを登録してダウンロードする

オプション 1: アプリを登録して自動的に構成し、コード サンプルをダウンロードする

オプション 2: アプリケーションとコード サンプルを登録して手動で構成する

手順 1: アプリケーションを登録する

手順 2: コード サンプルをダウンロードする

手順 3: コード サンプルを構成する

手順 4: コード サンプルを実行する

IDE からプロジェクトを実行する

Tomcat からプロジェクトを実行する

詳細情報

サンプルのしくみ

MSAL を取得する

MSAL を初期化する

ヘルプとサポート

次の手順

フィードバック

その他のリソース

前提条件

クイックスタートアプリを登録してダウンロードする

オプション 1: アプリを登録して自動的に構成し、コードサンプルをダウンロードする

オプション 2: アプリケーションとコードサンプルを登録して手動で構成する

手順 2: コードサンプルをダウンロードする

手順 3: コードサンプルを構成する

手順 4: コードサンプルを実行する