Primary Refresh Token : comprendre le SSO Microsoft Entra sous Windows

L’essentiel

Le Primary Refresh Token est délivré par Microsoft Entra au broker de la plateforme après authentification de l’utilisateur et validation de l’appareil. Il sert ensuite à demander des jetons pour les applications, pas à être présenté directement à chaque ressource.

Sous Windows, CloudAP participe à la connexion et Web Account Manager fournit le broker aux applications. Une clé de session liée au PRT signe les demandes ; sa protection par TPM réduit le risque de rejeu hors de l’appareil.

AzureAdPrt : YES confirme la présence d’un PRT pour l’utilisateur connecté à l’instant de dsregcmd. Il ne valide ni une application précise, ni un accès conditionnel, ni le canal MDM.

Le Primary Refresh Token est délivré par Microsoft Entra au broker de la plateforme après authentification de l’utilisateur et validation de l’appareil. Il sert ensuite à demander des jetons pour les applications, pas à être présenté directement à chaque ressource.

Pourquoi cette technologie existe

Lors d’une connexion prise en charge, Windows établit l’identité utilisateur et l’état de l’appareil. CloudAP échange avec Microsoft Entra et obtient un PRT ainsi qu’une clé de session ; le mécanisme varie selon Entra join, hybrid join et fédération.

Le PRT est un artefact de renouvellement à large portée, pas un access token destiné à une ressource. WAM et les applications compatibles demandent à Entra des jetons ciblés en s’appuyant sur le PRT et la preuve de possession.

Le besoin opérationnel doit être défini avant de choisir un profil ou un outil. Il faut distinguer le résultat attendu, l’expérience utilisateur, le propriétaire de la configuration et les contrôles qui confirmeront son application. La présence d’un paramètre dans une console ne justifie pas son activation.

L’intention configurée dans le cloud, son applicabilité, l’état reçu par Windows et le résultat observé correspondent à quatre informations différentes. Une affectation réussie, un état vert ou une requête HTTP acceptée ne prouve pas à lui seul que tout le parcours fonctionne.

Le fonctionnement de « PRT et SSO Windows » dépend du rôle exact de chaque partie : plan de contrôle, transport, traitement local, état conservé et résultat renvoyé. Le portail peut afficher une décision prise par Windows, tandis qu’un agent local peut subir une limite provenant du service cloud.

Les interfaces supportées et les détails internes observables n’ont pas le même statut. Logs, tâches et clés de registre peuvent expliquer un comportement. Ils ne constituent pas pour autant des interfaces stables pour une automatisation durable.

Le cycle réel couvre le déclenchement, le traitement, le résultat, la nouvelle évaluation et la réaction à une dérive. Reproduire une configuration sans comprendre cette séquence masque souvent la cause d’un écart.

Une intention envoyée, une valeur effective, un inventaire, un état de conformité, une télémétrie et un cache d’affichage ne décrivent pas la même chose. Leur producteur, leur heure et leur contexte déterminent la façon de les interpréter.

Identités, certificats, licences, services réseau, versions clientes et autres outils de gestion peuvent modifier le résultat sans appartenir directement au produit étudié. Une dépendance absente ne doit pas être confondue avec une limite de la technologie.

Une observation terrain reste un indice lorsqu’elle complète la documentation. Les noms de tâches, fichiers, événements ou rythmes internes peuvent changer. Les décisions de conception reposent sur les interfaces et les comportements officiellement documentés.

Architecture, composants et flux de données

Lors d’une connexion prise en charge, Windows établit l’identité utilisateur et l’état de l’appareil. CloudAP échange avec Microsoft Entra et obtient un PRT ainsi qu’une clé de session ; le mécanisme varie selon Entra join, hybrid join et fédération.

Le PRT est un artefact de renouvellement à large portée, pas un access token destiné à une ressource. WAM et les applications compatibles demandent à Entra des jetons ciblés en s’appuyant sur le PRT et la preuve de possession.

La clé de session signe les requêtes liées au PRT. Lorsqu’elle est protégée par TPM, le matériel contribue à empêcher l’export et le rejeu de la preuve sur un autre poste.

Prérequis, compatibilité et limites de support

Je sépare les prérequis nécessaires à l’existence de la fonction de ceux qui ne concernent qu’un scénario d’administration. La présence d’une option dans une console ne prouve ni la prise en charge de la version cliente, ni l’éligibilité de la licence.

Les builds, éditions, rôles, dépendances réseau et contextes d’exécution doivent être confirmés avant d’interpréter un comportement. Les éléments internes observés mais non documentés comme interfaces publiques sont explicitement traités comme tels.

• appareil enregistré ou joint selon scénario
• utilisateur Entra valide
• connectivité login.microsoftonline.com
• heure et proxy corrects
• TPM recommandé
• applications compatibles WAM
• policies CA connues

Cycle de fonctionnement, étape par étape

Cette séquence décrit ce que font les différents composants, depuis le déclenchement jusqu’au résultat. Elle sert de modèle mental : selon le scénario, certaines étapes peuvent être asynchrones ou exécutées dans un autre contexte.

Je distingue l’action demandée, son transport, son traitement local et son accusé de résultat. Cette distinction explique pourquoi deux écrans peuvent afficher temporairement des états différents sans qu’il y ait nécessairement une panne.

Fonctionnement détaillé et responsabilités

Lors d’une connexion prise en charge, Windows établit l’identité utilisateur et l’état de l’appareil. CloudAP échange avec Microsoft Entra et obtient un PRT ainsi qu’une clé de session ; le mécanisme varie selon Entra join, hybrid join et fédération.

Le PRT est un artefact de renouvellement à large portée, pas un access token destiné à une ressource. WAM et les applications compatibles demandent à Entra des jetons ciblés en s’appuyant sur le PRT et la preuve de possession.

La clé de session signe les requêtes liées au PRT. Lorsqu’elle est protégée par TPM, le matériel contribue à empêcher l’export et le rejeu de la preuve sur un autre poste.

• appareil enregistré ou joint selon scénario
• utilisateur Entra valide
• connectivité login.microsoftonline.com
• heure et proxy corrects

Configuration, exploitation et cas limites

Pour le SSO navigateur, un mécanisme de cookie PRT est utilisé par les navigateurs compatibles. Les applications Office et autres clients modernes s’intègrent au broker ; une application utilisant son propre cache peut avoir un état différent du PRT système.

Le PRT est renouvelé pendant l’usage actif selon le cycle Microsoft. Sa durée nominale ne doit pas être transformée en promesse de session permanente : révocation, changement d’état utilisateur/appareil, fréquence de connexion et Conditional Access influencent l’accès.

Les claims MFA et appareil peuvent être associés au parcours d’authentification. Un PRT présent n’implique pas que toutes les exigences d’une policy Conditional Access sont satisfaites pour une application donnée.

• Tester une application WAM
• Comparer navigateur et client natif
• Tester après changement réseau

Lire les états et les résultats

dsregcmd /status exécuté dans la session de l’utilisateur expose AzureAdPrt, heures UTC, authority et diagnostics de la tentative précédente. Exécuté élevé, il peut afficher un contexte différent ou un avertissement ; je conserve le contexte dans la collecte.

CloudAP écrit les erreurs dans AAD/Operational et les informations détaillées dans AAD/Analytic. Les événements 1006 et 1007 encadrent une acquisition PRT dans la procédure Microsoft et permettent de construire une chronologie.

Le PRT ne remplace pas Cloud Kerberos Trust. Ce dernier utilise le parcours Entra et un TGT partiel pour atteindre des ressources AD ; je distingue toujours SSO cloud, ticket Kerberos et jeton applicatif.

Une configuration décrit ce qui devrait arriver. L’inventaire montre un état observé à un instant donné, tandis qu’un log d’exécution indique ce que le composant a réellement tenté. Les horodatages et les contextes doivent correspondre avant de relier ces informations.

Les états non applicable, pending, conflict, error et success doivent rester séparés. L’absence d’un poste dans un rapport ne permet pas de conclure : il peut être hors ligne, non éligible, non ciblé, en retard de télémétrie ou exclu de la collecte.

Pilote, généralisation et maintien en conditions opérationnelles

Le pilote couvre plusieurs modèles matériels, versions de Windows, profils réseau, populations utilisateur et exceptions métier. Une cohorte témoin aide à distinguer l’effet du changement d’une évolution globale du service, d’une mise à jour applicative ou d’un incident réseau.

Les critères GO sont définis avant le début : couverture, taux de succès, délai de convergence, incidents, tickets support, régressions et temps de rollback. Une moyenne satisfaisante ne masque pas un sous-groupe en échec ; les résultats sont donc segmentés par version, modèle, site et mode de gestion.

Les cas négatifs sont testés volontairement : appareil hors ligne, licence absente, identité non éligible, règle non applicable, réseau filtré et retour arrière. Un design exploitable doit échouer de manière visible, sûre et compréhensible pour le support.

Après généralisation, les exceptions, permissions, versions de profil et dépendances doivent être revues régulièrement. Le service cloud et Windows évoluent ; une décision correcte aujourd’hui doit rester traçable et être revalidée lorsqu’un prérequis ou une interface change.

Interfaces d’observation, commandes et exemples

Les commandes illustrent les objets et états décrits dans l’article. Elles restent en lecture seule et ne modifient volontairement aucune ressource. Elles servent à comprendre les données disponibles, pas à fournir un outil de collecte prêt à déployer.

Une automatisation durable doit employer une API ou une interface officiellement supportée. Une clé de registre, un fichier ou une tâche interne peut évoluer avec Windows, l’agent ou le service.

# Exemple de collecte en lecture seule — à adapter avant utilisation
$ErrorActionPreference = 'Stop'
try {
  dsregcmd.exe /status
  Get-WinEvent -LogName 'Microsoft-Windows-AAD/Operational' -MaxEvents 120 |
    Select-Object TimeCreated,Id,LevelDisplayName,Message
} catch { Write-Error "Collecte PRT impossible : $($_.Exception.Message)"; exit 1 }

Observabilité : où lire l’état réel

La chronologie relie l’heure de la demande, le check-in, l’événement local, la décision du composant et la remontée dans le portail. Conservez l’heure UTC et l’heure locale. Avant tout partage, anonymisez les UPN, DeviceId, TenantId, noms internes, certificats, adresses et contenus métiers.

La collecte initiale reste en lecture seule. Ne videz pas un cache, ne supprimez pas une clé, ne réinitialisez pas un agent et ne forcez pas un enrôlement avant d’avoir capturé les informations utiles. Ces actions changent l’état et peuvent faire disparaître la cause initiale.

Les scripts publiés ici illustrent la collecte décrite dans l’article et restent en lecture seule. Une remédiation doit proposer une simulation, limiter sa cible, expliquer son impact et restaurer l’état précédent. Une opération privilégiée ou à grande échelle exige en plus une validation formelle et un pilote représentatif.

• Identifier le type de join.
• Lire SSO State en contexte user.
• Contrôler heures PRT.
• Observer CloudAP/AAD.
• Tester une application WAM
• Comparer navigateur et client natif
• Tester après changement réseau

Validation du modèle et cas d’usage

Je vérifie le modèle sur un appareil représentatif en reliant la configuration du service, l’état reçu, le traitement local et la donnée remontée. L’objectif n’est pas de certifier la production, mais de confirmer que l’explication décrit bien le comportement observé.

Un cas d’usage est retenu lorsque la technologie répond au besoin sans ajouter une autorité concurrente, une dépendance non maîtrisée ou un niveau d’opacité incompatible avec l’exploitation.

• Identifier le type de join.
• Lire SSO State en contexte user.
• Contrôler heures PRT.
• Observer CloudAP/AAD.
• Tester une application WAM
• Comparer navigateur et client natif
• Tester après changement réseau

Limites, modes de panne et lecture des erreurs

Les limites du modèle produisent des symptômes observables. Le tableau indique où le fonctionnement normal peut diverger et quelles informations permettent de confirmer l’origine de l’écart, sans transformer l’article en procédure de dépannage.

Une erreur isolée doit être replacée dans sa phase et son contexte. Je privilégie les résultats documentés du service et du client avant les détails d’implémentation susceptibles de changer.

Adoption progressive, réversibilité et vigilance

Pour introduire la technologie, je commence par un scénario borné, des appareils pilotes et des critères d’observation définis. L’adoption progresse uniquement si les dépendances, la supervision et les responsabilités de support sont comprises.

Le retour arrière dépend souvent de la propriété de la ressource et du cycle de synchronisation. Je le teste avant généralisation et je ne déduis jamais la réversibilité de la seule disparition d’un profil dans le portail.