Formations — 1 037 leçons en français

Accueil › Fullstack Angular + Spring Boot › Rafraîchir un jeton sans casser les requêtes en vol

Rafraîchir un jeton sans casser les requêtes en vol

Authentification de bout en boutintermediaire

Un jeton d'accès court (15 minutes) implique qu'il expirera pendant que l'utilisateur travaille. Le comportement souhaité est qu'il ne s'en aperçoive pas.

Le principe : à la première réponse 401, on rafraîchit une seule fois, on met les autres requêtes en attente, puis on les rejoue avec le nouveau jeton.

@Injectable({ providedIn: 'root' })
export class RafraichissementService {
  private http = inject(HttpClient);
  private jeton = inject(JetonStockage);
  private enCours$: Observable<string> | null = null;

  /** Un seul appel réseau, quel que soit le nombre d'appelants simultanés. */
  rafraichir(): Observable<string> {
    this.enCours$ ??= this.http
      .post<{ jeton: string }>('/api/auth/rafraichir', {}, { withCredentials: true })
      .pipe(
        map((r) => r.jeton),
        tap((jeton) => this.jeton.enregistrer(jeton)),
        finalize(() => (this.enCours$ = null)), // libérer pour la prochaine fois
        shareReplay(1),                         // les suivants reçoivent la même valeur
      );
    return this.enCours$;
  }
}

Le ??= combiné au finalize est tout le mécanisme : le premier appelant crée le flux, les suivants s'y greffent, et le flux disparaît dès qu'il est terminé.

Les termes à connaître

Jeton de rafraîchissement

Jeton à durée de vie longue (jours ou semaines) dont le seul usage est d'obtenir un nouveau jeton d'accès. Il ne doit jamais accompagner les requêtes métier : moins il circule, moins il risque d'être intercepté.

Rafraîchissement concurrent

Situation où plusieurs requêtes échouent en 401 au même instant (un écran qui charge trois ressources). Si chacune déclenche un rafraîchissement, on obtient plusieurs appels simultanés et, avec une rotation de jetons, une invalidation mutuelle.

Rotation des jetons

Pratique où chaque rafraîchissement émet un nouveau jeton de rafraîchissement et invalide le précédent. Elle limite la durée d'exploitation d'un jeton volé, mais rend les appels concurrents destructeurs si le front n'en émet pas un seul à la fois.

shareReplay

Opérateur RxJS qui partage un même flux entre plusieurs abonnés et leur rejoue la dernière valeur. C'est le mécanisme qui permet à dix requêtes en attente de se greffer sur un seul appel de rafraîchissement.

switchMap

Opérateur RxJS qui, pour chaque valeur reçue, s'abonne à un nouvel observable en annulant le précédent. Ici, il permet d'enchaîner « attendre le nouveau jeton » puis « rejouer la requête ».

File d'attente de requêtes

Mécanisme qui met en pause les requêtes survenant pendant un rafraîchissement, pour les rejouer avec le nouveau jeton. Sans cette file, l'utilisateur voit des erreurs transitoires alors que sa session est valide.

Lire l'explication détaillée et faire le quiz →

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.