Accueil › Angular › Authentification OAuth2 / OIDC dans une application Angular
Authentification OAuth2 / OIDC dans une application Angular
Sécurité côté frontavance
Dans OAuth2/OIDC, une application Angular est un client public : son code s'exécute chez l'utilisateur, entièrement inspectable, donc incapable de garder un secret. C'est pourquoi le flux recommandé est Authorization Code avec PKCE : l'application redirige vers le serveur d'autorisation, l'utilisateur s'authentifie, un code temporaire revient dans l'URL de redirection, puis l'application l'échange contre des jetons — jeton d'accès, jeton d'identité (OIDC), éventuellement un jeton de rafraîchissement. PKCE remplace le secret client qu'une application front ne peut pas garder : un code_verifier généré localement prouve, au moment de l'échange, que c'est bien la même application qui a initié la demande.
Ce qu'on ne met jamais dans une application front : un secret client. Toute valeur présente dans le bundle JavaScript est publique, quelle que soit la minification.
Le stockage des jetons est un compromis, pas une solution parfaite :
| Stockage | Avantage | Risque |
|---|---|---|
| Mémoire (variable JS) | Inaccessible hors du contexte JS courant | Perdu au rechargement de page |
localStorage |
Persiste entre rechargements | Lisible par tout script, y compris un script injecté par XSS |
Cookie HttpOnly posé par le serveur |
Inaccessible en JavaScript | Nécessite un backend qui coopère (souvent un BFF), et une protection CSRF |
export const authInterceptor: HttpInterceptorFn = (req, next) => {
const domainesAutorises = ['api.maboutique.com'];
const url = new URL(req.url, window.location.origin);
if (!domainesAutorises.includes(url.hostname)) {
return next(req); // jamais de jeton envoyé à un domaine tiers
}
const jeton = inject(AuthService).jetonAcces();
return next(req.clone({ setHeaders: { Authorization: `Bearer ${jeton}` } }));
};
Un guard de route vérifiant l'authentification n'est qu'une aide d'expérience utilisateur : la vraie protection des données se joue côté serveur, à chaque appel API. Préférer une bibliothèque OIDC certifiée à une implémentation maison du flux.
Les termes à connaître
- Client public
Catégorie OAuth2 à laquelle appartient toute application qui s'exécute entièrement côté utilisateur (SPA Angular, application mobile) : son code est visible et inspectable, elle ne peut donc garder aucun secret. À l'opposé d'un « client confidentiel » (un serveur backend), qui peut stocker un secret d'application en toute sécurité.
- Authorization Code Flow avec PKCE
Flux OAuth2/OIDC recommandé pour un client public : l'application redirige vers le serveur d'autorisation, récupère un code temporaire après authentification, puis l'échange contre des jetons. PKCE (Proof Key for Code Exchange) protège cet échange sans nécessiter de secret client.
- code_verifier / code_challenge
Paire PKCE : l'application génère un
code_verifieraléatoire, en dérive uncode_challenge(haché) envoyé avec la demande d'autorisation, puis fournit lecode_verifierd'origine lors de l'échange du code contre les jetons. Le serveur vérifie la correspondance, ce qui empêche qu'un code intercepté soit échangé par un tiers.- Jeton d'accès, jeton d'identité, jeton de rafraîchissement
Trois jetons distincts renvoyés par le serveur d'autorisation : le jeton d'accès (access token) autorise les appels API, le jeton d'identité (ID token, spécifique à OIDC) décrit l'utilisateur authentifié, le jeton de rafraîchissement (refresh token) permet d'obtenir un nouveau jeton d'accès sans réauthentification complète.
- Intercepteur d'authentification
Intercepteur
HttpClient(fonctionnel,HttpInterceptorFn) qui ajoute l'en-têteAuthorization: Bearer <jeton>aux requêtes sortantes. Doit vérifier le domaine de destination avant d'ajouter le jeton, pour ne jamais l'envoyer à une API tierce non maîtrisée.- Cookie HttpOnly
Cookie posé par le serveur avec l'attribut
HttpOnly, inaccessible au JavaScript de la page. Permet de stocker un jeton hors d'atteinte d'un script injecté par XSS, au prix d'une dépendance à un backend qui gère ce cookie (souvent via un pattern BFF, Backend for Frontend) et d'une protection CSRF à mettre en place en complément.- Guard de route (authentification)
CanActivateFnqui vérifie côté client si l'utilisateur semble authentifié, pour éviter d'afficher une page protégée ou rediriger vers la connexion. C'est une aide d'expérience utilisateur, pas un contrôle de sécurité : un utilisateur peut désactiver JavaScript ou appeler l'API directement, contournant tout guard.- Bibliothèque OIDC certifiée
Librairie ayant passé la suite de certification officielle OpenID Foundation (ex.
angular-auth-oidc-client,angular-oauth2-oidc), à préférer systématiquement à une implémentation maison du flux Authorization Code + PKCE : la cryptographie et les nombreux cas limites du protocole sont difficiles à réimplémenter correctement.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.