More than 3 years have passed since last update.

【Microsoft ID プラットフォーム】(Azure AD) Java Web アプリ (eclipse)-設定編-

Posted at 2020-02-20

はじめに（背景)

下記検証の続きとなります。

SPA (Node.js)
https://qiita.com/Design_Tshirt7/items/553958e3724cc3718aa9
ASP.NET
https://qiita.com/Design_Tshirt7/items/c282d645c2117be12d4e
ASP.NET Core
https://qiita.com/Design_Tshirt7/items/ed8d45a0dff76b741c03
Java Web アプリ (WARfile)
https://qiita.com/Design_Tshirt7/items/df8dd7799bfdc32c9078

背景は、上記と同じとなりますが、初めてご訪問頂いた人もいると思いますので、記載させて頂きます。

Office365を導入して、数年が経ちました。
皆様が慣れてきて、そろそろ、Office365とのシングルサインをすれば、便利になるんじゃない！！との声が出来てきました。そして、上司から、"Single Sign On よろしく！"との恐ろしい声がかかりました。

確かにIDaaSとしてのAzure ADは既に稼働しているので、後は、連携するアプリケーションの準備が出来れば可能ですが、、、このオンプレWebアプリケーションとIDaaSとのSSOは敷居が高い。

なぜなら、アプリケーション側でSAML/OpenIDConnect/OAuthとおしゃべりができないので、改修が必須となる。そこで、Microsoft ID プラットフォームを使えば、ライブラリが提供されているので、これをうまく活用すれば、SSOの敷居が少しでも低くるなると考え、検証を開始致しました。

Microsoft ID プラットフォーム

『Microsoft ID プラットフォーム (旧称: 開発者向け Azure Active Directory)』
https://docs.microsoft.com/ja-jp/azure/active-directory/develop/

Microsoft ID プラットフォームは、Azure Active Directory (Azure AD) 開発者プラットフォームの進化版です。これにより、すべての Microsoft ID にサインインして、Microsoft API (Microsoft Graph) や開発者が構築した API を呼び出すためのトークンを取得するアプリケーションを開発者が構築できます。これはフル機能を備えたプラットフォームであり、OAuth 2.0 および OpenID Connect 標準に準拠した認証サービス、オープンソースライブラリ、アプリケーションの登録および構成、充実した概念とリファレンスのドキュメント、クイックスタートサンプル、コードサンプル、チュートリアル、攻略ガイドによって構成されています。

ふむふむ。確かにサンプルコードがあるので、できそうかも。。。

いざトライ！！

1.参照ページ
『Quickstart: Add sign-in with Microsoft to a Java web app』
https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-v2-java-webapp

*日本語ページにするとstep3の4が省略されているので注意です。

2.登場人物
1.Identity Provider (Azure AD)

オンマイクロソフトアカウントを使います。
2.Relying Party (Java)
(事前の準備をお願い致します。インストール方法は割愛させて頂きます)

Java Development Kit (JDK) 8 以降
Maven
Spring boot
eclipse

3.手順
◆手順1:アプリケーションの登録
1.Azure portal(https://portal.azure.com) にサインインします。
2.[ホーム]-> [Azure AD Active Directory] -> [アプリの登録]へ進む

3.[新規登録] をクリックします。

4.アプリケーション登録で下記項目を選択して、[登録]をクリック。
(1).名前欄：任意のアプリケーション名を入力
(2).サポートされているアカントの種類：この組織ディレクトリのみに含まれるアカウント
(3).リダイレクトURL：空白　=> (後ほど、入力されます。)

5.登録したアプリケーションが表示されますので、[クイックスタート]をクリック。

6.クイックスタートガイドの[Java]をクリック。

7.[これらの変更を行います]をクリック。

8.下記構成内容が表示されますので、[更新する]をクリック。
(1).リダイレクト URI :
http://localhost:8080/msal4jsample/secure/aad
http://localhost:8080/msal4jsample/graph/me
(2).クライアントシークレット

認可コードフローとなりますので、アクセストーンとIDトークンのチェックは無しとなっております。

9.クライアントシークレットが表示されますので、コピーをして、[完了]をクリック。

クライアントシークレットは以降の手順で必要となりますので、必ずコピーをお願い致します。

10.下記の[認証]画面から応答URLの内容が反映されている事を確認。

◆手順2:プロジェクトのダウンロード
1.warを作成する為のプロジェクトファイルをダウンロードします。

プロジェクトファイル：ms-identity-java-webapp-master.zip

◆手順3:コードサンプルの構成
1.ZIP ファイルをローカルフォルダーに展開します。

2.src\main\resources\のapplication.propertiesファイルを編集致します。

name	value
aad.clientId (クライアントID)	69b99f5e-673d-44b6-b777-64ac67f49bbc
aad.authority (テナントID)	a94216cd-7c42-4b24-8ba0-ce5c210951bd
aad.secretKey(クライアントシークレット)	B_wP8cT8g?z=4RFGe3TvKe[M@fAJvhS8

3.Self-signed Certificateの作成とapplication.propertiesファイルの編集
3-1.Keyの作成を実施致します。

3-2.作成したkeyを"resource"フォルダに移動致します。

3-3.application.propertiesファイルの編集を行います。

◆手順4:Java, Maven, spring boot, eclipseのダウンロード&設定
*手順は割愛させていただきます。
*私が検証で使った各バージョンは、下記となります。

C:\>java -version
java version "1.8.0_172"
Java(TM) SE Runtime Environment (build 1.8.0_172-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.172-b11, mixed mode)

C:\>mvn -version
Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f)
Maven home: C:\apache-maven-3.6.3\bin\..
Java version: 1.8.0_172, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk1.8.0_172\jre
Default locale: ja_JP, platform encoding: MS932
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

*eclipse version

*spring boot version