> {
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);
})
);
}
}
```
+ **Configuration du délai d'expiration de session.** Configurez les paramètres de temporisation de session dans le AWS Blu Age Runtime et dans le Microsoft Entra ID. Par exemple, ajoutez le code suivant à votre `application-main.yml` fichier :
```
server:
servlet:
session:
timeout: 3600 # 1 hour in seconds
```
+ **MsalGuard.** Vous devez implémenter MsalGuard cette fonctionnalité pour tous les itinéraires protégés afin d'empêcher tout accès non autorisé. Par exemple :
```
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 }
];
```
Les itinéraires non MsalGuard protégés seront accessibles sans authentification, ce qui peut exposer des fonctionnalités sensibles. Assurez-vous que toutes les routes qui nécessitent une authentification incluent les gardes dans leur configuration.
## Épopées
### Configurer un identifiant Microsoft Entra
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Configurez un compte Microsoft Azure pour créer un identifiant Entra. | Pour les options et les instructions, consultez le [site Web de Microsoft Azure](https://azure.microsoft.com/en-us/free/). | Développeur d’applications |
| Configurez un identifiant Microsoft Entra dans votre application. | Pour savoir comment ajouter l'authentification Microsoft Entra ID B2C (Azure AD B2C) à votre Angular SPA, consultez la documentation [Microsoft](https://learn.microsoft.com/en-us/azure/active-directory-b2c/enable-authentication-angular-spa-app#add-the-authentication-components). En particulier :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application.html) | Développeur d’applications |
### Clonez le référentiel et déployez votre code AWS Blu Age
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Clonez le GitHub référentiel pour obtenir le code angulaire requis pour l'authentification. | Exécutez la commande suivante pour cloner le [GitHub référentiel](https://github.com/aws-samples/sample-microsoft-entra-id-based-auth-in-aws-bluage-modernized-mainframe-app) fourni avec ce modèle dans votre répertoire de travail local actuel :git clone https://github.com/aws-samples/sample-microsoft-entra-id-based-auth-in-aws-bluage-modernized-mainframe-app.git
| Développeur d’applications |
| Déployez le code modernisé AWS Blu Age sur un serveur Tomcat pour implémenter l'authentification. | Pour configurer l'environnement local qui inclut Tomcat et le serveur de développement Angular, suivez les étapes d'installation fournies par l'équipe AWS Blu Age dans le cadre de votre engagement client auprès des services AWS professionnels. | Développeur d’applications |
### Créez la solution d'authentification
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Activez la sécurité d'AWS Blu Age Runtime pour protéger les points de terminaison de l'API REST AWS Blu Age. | Configurez le `application-main.yml` fichier utilisé par le AWS Blu Age Runtime comme suit. Pour un exemple de ce fichier, consultez la section [Référentiel de code](#implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application-tools) plus haut dans ce modèle.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application.html) | Développeur d’applications |
| Intégrez l'exemple de code de votre environnement local dans votre base de code Angular modernisée de Blu Age. | Pour plus d'informations sur la façon d'intégrer l'exemple dans votre base de code Angular modernisée de AWS Blu Age, consultez la section [Référentiel de code](#implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application-tools) plus haut dans ce modèle. | Développeur d’applications |
| Placez la `oauth2-ext` bibliothèque dans le répertoire partagé. | **Placez la `oauth2-ext` bibliothèque dans le répertoire**** partagé du serveur d'applications afin que votre application **AWS **Blu Age modernisée puisse l'utiliser.**Exécutez les commandes suivantes :cd oauth2-ext/target
cp extension-oauth-filter-.jar /{app-server-home}/shared/
| Développeur d’applications |
### Déployer la solution d'authentification
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Déployez l'application frontale. | Exécutez les commandes suivantes pour démarrer l'application frontale localement :npm install
ng serve --ssl
npm start
L'ajout de l'`--ssl`indicateur à la `ng serve` commande garantit que le serveur de développement utilise le protocole HTTPS, qui est plus sécurisé que les autres protocoles et fournit une meilleure simulation d'un environnement de production. | Développeur d’applications |
| Démarrez l'application principale. | Démarrez le serveur Tomcat dans Eclipse. | Développeur d’applications |
### Tester l'application
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Testez la fonctionnalité de connexion. | Accédez à l'application déployée localement `http://localhost:4200` à l'adresse pour vérifier que les utilisateurs sont invités à confirmer leur identité.Le protocole HTTP est utilisé ici à des fins de démonstration. Dans un environnement de production ou tout autre environnement accessible au public, vous devez utiliser le protocole HTTPS pour des raisons de sécurité. Même pour le développement local, nous vous recommandons de configurer le protocole HTTPS lorsque cela est possible.L'invite de connexion Microsoft devrait apparaître et les utilisateurs configurés avec l'identifiant Microsoft Entra devraient être autorisés à accéder à l'application. | Développeur d’applications |
| Testez l'en-tête d'autorisation dans la demande. | Les étapes suivantes utilisent l'[CardDemo](https://github.com/aws-samples/aws-mainframe-modernization-carddemo)application comme exemple. Les étapes de test pour les autres applications modernes peuvent varier.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/implement-entra-id-authentication-in-aws-blu-age-modernized-mainframe-application.html) | Développeur d’applications |
| Testez la fonctionnalité de déconnexion. | Choisissez **Quitter** pour vous déconnecter, puis réessayez d'accéder à l'application. Il devrait présenter une nouvelle invite de connexion. | Développeur d’applications |
## Résolution des problèmes
| Problème | Solution |
| --- | --- |
| Le jeton émis par Microsoft Entra ID n'est pas compatible avec la sécurité Spring Boot OAuth 2.0. | Pour trouver une solution à ce problème, consultez [Microsoft Entra ID OAuth Flow](https://authguidance.com/azure-ad-troubleshooting/) sur le OAuth blog. |
| Questions générales relatives aux jetons. | Pour décoder et afficher le contenu d'un jeton JWT, utilisez le [site Web https://jwt.io/](https://jwt.io/). |
## Ressources connexes
+ [Pour plus d'informations sur la refactorisation de votre application à l'aide de AWS Blu Age, consultez la AWS Mainframe Modernization documentation.](https://docs.aws.amazon.com/m2/latest/userguide/refactoring-m2.html)
+ Pour comprendre le fonctionnement de la OAuth version 2.0, consultez le [site Web de la OAuth version 2.0](https://oauth.net/2/).
+ Pour une présentation de la Microsoft Authentication Library (MSAL), consultez la [documentation Microsoft Entra](https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-overview).
+ Pour plus d'informations sur les profils utilisateur sur un système AS/400, consultez le [didacticiel IBM i (AS400)](https://www.go4as400.com/subsystem-jobs-user-profile-in-as400/jobs.aspx?cid=14).
+ Pour le flux d'authentification OAuth 2.0 et OpenID Connect (OIDC) dans la plateforme d'identité Microsoft, consultez la documentation [Microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/v2-protocols) Entra.