> {
return next.handle(request).pipe(
catchError((error: HttpErrorResponse) => {
if (error.status === 401) {
// Handle token expiration
this.authService.login();
}
if (error.status === 403) {
// Handle unauthorized access
this.router.navigate(['/unauthorized']);
}
return throwError(() => error);
})
);
}
}
```
+ **セッションタイムアウトの設定。** AWS Blu Age ランタイムと Microsoft Entra ID の両方でセッションタイムアウト設定を構成します。例えば、`application-main.yml` ファイルに次のコードを追加します。
```
server:
servlet:
session:
timeout: 3600 # 1 hour in seconds
```
+ **MsalGuard。**不正アクセスを防ぐために、保護するすべてのルートに MsalGuard 機能を実装する必要があります。例えば、次のようになります。
```
const routes: Routes = [
{ path: '', redirectTo: '/transaction-runner', pathMatch: 'full' },
{ path: 'transaction-runner', component: TransactionRunnerComponent, canActivate:guards },
{ path: 'user-info', component: UserInfoComponent, canActivate:guards },
{ path: 'term/:transid/:commarea', component: TermComponent, canActivate:guards },
{ path: 'code', component: TransactionRunnerComponent }
];
```
MsalGuard 保護が適用されていないルートには認証なしでアクセスできるため、機密機能が公開される可能性があります。認証を必要とするすべてのルートの設定にガードが含まれていることを確認してください。
## エピック
### Microsoft Entra ID をセットアップする
| タスク | 説明 | 必要なスキル |
| --- | --- | --- |
| Microsoft Azure アカウントをセットアップして Entra ID を作成する。 | オプションと手順については、[Microsoft Azure のウェブサイト](https://azure.microsoft.com/en-us/free/)を参照してください。 | アプリ開発者 |
| アプリケーションで Microsoft Entra ID をセットアップする。 | Microsoft Entra ID B2C (Azure AD B2C) 認証を Angular SPA に追加する方法については、[Microsoft のドキュメント](https://learn.microsoft.com/en-us/azure/active-directory-b2c/enable-authentication-angular-spa-app#add-the-authentication-components)を参照してください。具体的には次のとおりです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application.html) | アプリ開発者 |
### リポジトリのクローンを作成し、 AWS Blu Age コードをデプロイする
| タスク | 説明 | 必要なスキル |
| --- | --- | --- |
| 認証に必要な Angular コードを取得するために、GitHub リポジトリのクローンを作成する。 | 次のコマンドを実行して、このパターンで提供している [GitHub リポジトリ](https://github.com/aws-samples/sample-microsoft-entra-id-based-auth-in-aws-bluage-modernized-mainframe-app)をローカルの現在の作業ディレクトリにクローンします。git clone https://github.com/aws-samples/sample-microsoft-entra-id-based-auth-in-aws-bluage-modernized-mainframe-app.git
| アプリ開発者 |
| 認証を実装するために、 AWS Blu Age モダナイズされたコードを Tomcat サーバーにデプロイします。 | Tomcat と Angular 開発サーバーを含むローカル環境を設定するには、 AWS プロフェッショナルサービスとのカスタマーエンゲージメントの一環として AWS Blu Age チームが提供するインストール手順に従います。 | アプリ開発者 |
### 認証ソリューションを構築する
| タスク | 説明 | 必要なスキル |
| --- | --- | --- |
| AWS Blu Age REST API エンドポイントを保護するために、AWS Blu Age ランタイムセキュリティを有効にする。 | AWS Blu Age ランタイムが使用する`application-main.yml`ファイルを次のように設定します。このファイルの例については、このパターンの前半の「[コードリポジトリ](#implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application-tools)」セクションを参照してください。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application.html) | アプリ開発者 |
| ローカル環境のサンプルコードを Blu Age によりモダナイズされた Angular コードベースに組み込む。 | AWS Blu Age のモダナイズされた Angular コードベースに例を組み込む方法については、このパターンの前半の[コードリポジトリ](#implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application-tools)セクションを参照してください。 | アプリ開発者 |
| `oauth2-ext` ライブラリを共有ディレクトリに配置する。 | ****AWS Blu Age によりモダナイズされたアプリケーションで使用できるように、`oauth2-ext` ライブラリをアプリケーションサーバーの****共有ディレクトリに配置します**。**以下の コマンドを実行します。cd oauth2-ext/target
cp extension-oauth-filter-.jar /{app-server-home}/shared/
| アプリ開発者 |
### 認証ソリューションをデプロイする
| タスク | 説明 | 必要なスキル |
| --- | --- | --- |
| フロントエンドアプリケーションをデプロイする。 | 以下のコマンドを実行して、フロントエンドアプリケーションをローカルで起動します。npm install
ng serve --ssl
npm start
`ng serve` コマンドに `--ssl` フラグを付加すると、開発サーバーで HTTPS を使用するようにできます。HTTPS は他のプロトコルよりも安全であり、本番環境の優れたシミュレーションが行えます。 | アプリ開発者 |
| バックエンドアプリケーションを起動する。 | Eclipse で Tomcat サーバーを起動します。 | アプリ開発者 |
### アプリケーションをテストする
| タスク | 説明 | 必要なスキル |
| --- | --- | --- |
| ログイン機能をテストする。 | ローカルにデプロイされたアプリケーションに `http://localhost:4200` でアクセスし、ユーザーが自分の ID の確認を求められることを検証します。ここでは、デモのために HTTP を使用します。本番稼働環境やその他のパブリックにアクセス可能な環境では、セキュリティのために HTTPS を使用する必要があります。ローカル開発であっても、可能であれば HTTPS をセットアップすることをお勧めします。
Microsoft ログインプロンプトが表示され、Microsoft Entra ID で設定されたユーザーにアプリケーションへのアクセスが許可される必要があります。 | アプリ開発者 |
| リクエストで送信した認可ヘッダーをテストする。 | 以下の手順では、例として [CardDemo](https://github.com/aws-samples/aws-mainframe-modernization-carddemo) アプリケーションを使用します。他の最新のアプリケーションのテスト手順は異なります。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application.html) | アプリ開発者 |
| ログアウト機能をテストする。 | **[終了]** を選択してログアウトし、アプリケーションにもう一度アクセスしてみてください。新しいログインプロンプトが表示されるはずです。 | アプリデベロッパー |
## トラブルシューティング
| 問題 | ソリューション |
| --- | --- |
| Microsoft Entra ID によって発行されたトークンに、Spring Boot OAuth 2.0 セキュリティとの互換性がない。 | 問題の解決については、OAuth ブログの「[Microsoft Entra ID OAuth Flow](https://authguidance.com/azure-ad-troubleshooting/)」を参照してください。 |
| トークン関連の一般的な質問。 | JWT トークンの内容をデコードして表示するには、[https://jwt.io/](https://jwt.io/) ウェブサイトを使用してください。 |
## 関連リソース
+ AWS Blu Age を使用したアプリケーションのリファクタリングについては、 [AWS Mainframe Modernization ドキュメント](https://docs.aws.amazon.com/m2/latest/userguide/refactoring-m2.html)を参照してください。
+ OAuth 2.0 の動作については、[OAuth 2.0 のウェブサイト](https://oauth.net/2/)を参照してください。
+ Microsoft Authentication Library (MSAL) の概要については、[Microsoft Entra のドキュメント](https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-overview)を参照してください。
+ AS/400 システムのユーザープロファイルの詳細については、[IBM i (AS400) チュートリアル](https://www.go4as400.com/subsystem-jobs-user-profile-in-as400/jobs.aspx?cid=14)を参照してください。
+ Microsoft ID プラットフォームの OAuth 2.0 および OpenID Connect (OIDC) 認証フローについては、[Microsoft Entra のドキュメント](https://learn.microsoft.com/en-us/entra/identity-platform/v2-protocols)を参照してください。