Désactivation d'un compte et révocation des accès
Sur cette page
Quand un utilisateur est désactivé ou supprimé (départ d’un salarié, fin de contrat, compte compromis), ses accès en cours doivent cesser sans attendre l’expiration de ses sessions et de ses jetons. À partir de la version 3.38.0, TOSIAM le fait de lui-même, quel que soit l’endroit où la modification a été faite.
| Après la désactivation | Jusqu’à 3.37 | À partir de 3.38.0 |
|---|---|---|
| Nouvelle authentification | Refusée | Refusée |
| Session ouverte (avec état) | Valide jusqu’à son expiration | Fermée, comme une déconnexion |
Jeton d’accès OAuth2 (introspection, tokeninfo) | Valide jusqu’à son expiration | Révoqué |
| Jeton de rafraîchissement OAuth2 | Refusé | Révoqué |
userinfo | Refusé | Refusé |
| Consentements OAuth2 | Gardés | Gardés |
1. Ce qui déclenche la révocation#
La révocation a lieu dans deux cas :
- l’utilisateur n’est plus actif (
inetUserStatus: Inactive, ounsAccountLockselon l’annuaire) ; - l’utilisateur est supprimé.
TOSIAM l’apprend par deux voies, qui couvrent tous les canaux de modification :
| Canal | Comment TOSIAM l’apprend |
|---|---|
Écriture directe dans l’annuaire : outil de gestion des identités (TOSIDM), script, ldapmodify | Notification de l’annuaire : recherche persistante de TosDJ, ou synchronisation de contenu d’OpenLDAP (RFC 4533). Chaque serveur relit l’utilisateur modifié et révoque s’il n’est plus actif. |
| Écriture par TOSIAM : console, API REST, ssoadm | Directement, au moment de l’écriture : suppression, désactivation, écriture de inetUserStatus ou de nsAccountLock. |
La seconde voie sert aux annuaires qui n’envoient pas de notification : la révocation a lieu même sans recherche persistante, tant que la modification passe par TOSIAM.
2. Ce qui est révoqué#
Sessions#
TOSIAM cherche les sessions de l’utilisateur dans le Core Token Store et les ferme comme une déconnexion. Le traitement habituel de la déconnexion a donc lieu, y compris la déconnexion par canal dérobé des applications OpenID Connect.
Jetons OAuth2#
Les jetons d’accès et de rafraîchissement de l’utilisateur sont supprimés, pour tous ses clients, comme lorsque l’utilisateur révoque lui-même une application. Une introspection répond "active": false, et un rafraîchissement est refusé.
Les consentements sont gardés. Une désactivation est réversible : un utilisateur réactivé se reconnecte avec ses moyens d’authentification d’origine et retrouve ses applications, sans nouveau consentement.
Applications prévenues#
Une application qui garde sa propre session, ou qui valide les jetons par leur seule signature, peut s’abonner aux signaux partagés du royaume (SSF). TOSIAM lui pousse alors RISC account-disabled ou account-purged, et CAEP session-revoked, une seule fois pour tout le site.
3. Suppression : ce qui est purgé#
Une suppression n’est pas réversible. En plus de la révocation, TOSIAM efface alors ce qu’il garde pour l’utilisateur hors de son entrée. Sans cette purge, un utilisateur recréé plus tard sous le même nom retrouverait les données de l’ancien.
La plupart des données d’un utilisateur sont dans son entrée, et disparaissent avec elle : profils TOTP et codes de récupération, appareils push et appareils de confiance, consentements OAuth2, réponses aux questions de sécurité, comptes sociaux liés. Les autres sont traitées ainsi :
| Données | Rangées | Ce qui se passait | À partir de 3.38.0 |
|---|---|---|---|
| Jetons de SSO persistant | Annuaire configuré dans chaque nœud ou module, par nom de connexion | L’ancien cookie connectait l’utilisateur recréé | Jeton refusé et supprimé à sa présentation |
| Essais et blocages des graphes | Core Token Store, par royaume et nom | Le compte recréé héritait des blocages | Effacés |
| Empreintes d’appareil des graphes | Mémoire de chaque serveur, par nom | Le compte recréé héritait des appareils connus | Effacées |
| Clés d’accès WebAuthn | Annuaire du service WebAuthn, par entryUUID | Clés orphelines, inutilisables | Supprimées avec l’utilisateur, ou par balayage |
| Délégations consenties aux agents IA | Core Token Store, par royaume et nom | Délégations gardées jusqu’à leur expiration, déjà refusées au compte recréé | Supprimées |
| Ressources UMA | Magasin des ressources, par nom du propriétaire | Le compte recréé retrouvait les ressources de l’ancien | Supprimées |
| Politiques UMA créées par l’utilisateur (partages, repartages) | Politiques du royaume, par identifiant universel | Le compte recréé retrouvait les partages de l’ancien | Supprimées |
| Partages UMA reçus d’autres propriétaires | Politiques des autres propriétaires, par nom du bénéficiaire | Le compte recréé héritait des accès accordés à l’ancien | Retirés, voir Données UMA |
| Libellés UMA | Magasin des libellés, sous le nom de l’utilisateur | Le compte recréé retrouvait les libellés | Supprimés |
| Demandes UMA en attente, reçues ou faites | Magasin des demandes, par nom | Une demande approuvée plus tard ouvrait un accès au compte recréé | Supprimées |
| Historique UMA | Magasin de l’historique, par identifiant universel | Le compte recréé voyait l’historique de l’ancien | Supprimé |
Une désactivation ne purge rien : un utilisateur réactivé retrouve ses jetons de SSO persistant, ses clés d’accès, ses délégations et ses données UMA.
Quand la purge a lieu#
Comme la révocation, la purge a lieu sur un fil de fond, quel que soit le canal de la suppression. Un utilisateur notifié comme modifié par l’annuaire, puis introuvable, est traité comme supprimé.
Les clés d’accès ne portent que l’entryUUID de leur utilisateur, illisible une fois son entrée supprimée. Elles sont donc relevées juste avant la suppression, et supprimées juste après. Cela n’est possible que si TOSIAM fait la suppression (console, API REST, ssoadm) ; si la suppression échoue, rien n’est purgé. Pour une suppression faite directement dans l’annuaire, voir Clés d’accès orphelines.
Jetons de SSO persistant#
L’annuaire des jetons de SSO persistant est configuré dans chaque nœud et chaque module : TOSIAM ne peut pas le retrouver à partir du royaume pour y faire le ménage. Le contrôle a donc lieu à la présentation du cookie, dans le nœud SSO persistant comme dans le module historique :
| Utilisateur du jeton | Connexion | Jeton |
|---|---|---|
| Existe, actif, créé avant le jeton | Acceptée | Gardé |
| Inactif | Refusée | Gardé, pour la réactivation |
| N’existe plus | Refusée | Supprimé |
| Créé après le jeton (même nom, autre personne) | Refusée | Supprimé |
La date de création de l’utilisateur est lue dans createTimestamp, avec une tolérance de 10 secondes entre l’horloge du serveur et celle de l’annuaire. Si le data store ne renvoie pas cet attribut, seule l’existence de l’utilisateur est vérifiée.
Ce contrôle couvre aussi les suppressions faites directement dans l’annuaire, ou pendant un arrêt de TOSIAM.
Clés d’accès orphelines#
Les clés d’accès d’un utilisateur supprimé directement dans l’annuaire (par TOSIDM, un script, ldapdelete) restent dans l’annuaire du service WebAuthn. Elles ne permettent aucune connexion, mais gardent des données sans titulaire. Un balayage du royaume les retrouve : une clé est orpheline quand aucun utilisateur du royaume ne porte plus son entryUUID.
| Méthode | Chemin | Effet |
|---|---|---|
GET | /api/realms/{realm}/webauthn/orphans | Liste les clés orphelines, sans rien supprimer |
DELETE | /api/realms/{realm}/webauthn/orphans | Supprime les clés orphelines |
Les deux opérations sont réservées à un administrateur du royaume. Le DELETE exige le jeton anti-CSRF, comme toute écriture dans /api (voir l’exemple des graphes JSON).
SERVEUR=https://<serveur>/tosiam
SSO=<jeton de session administrateur> # obtenu par /json/authenticate
# 1. Liste ; la réponse porte aussi le jeton anti-CSRF
curl -s -D entetes.txt -b "iPlanetDirectoryPro=$SSO" \
"$SERVEUR/api/realms/root/webauthn/orphans"
XSRF=$(awk 'tolower($1)=="x-xsrf-token:" {print $2}' entetes.txt | tr -d '\r')
# 2. Suppression, après vérification de la liste
curl -X DELETE "$SERVEUR/api/realms/root/webauthn/orphans" \
-b "iPlanetDirectoryPro=$SSO; XSRF-TOKEN=$XSRF" \
-H "X-XSRF-TOKEN: $XSRF"Réponse des deux opérations :
{
"credentials": 42,
"orphans": 2,
"deleted": 0,
"orphanIds": ["mT0x…", "Qk9y…"]
}| Champ | Contenu |
|---|---|
credentials | Nombre de clés d’accès dans l’annuaire du service WebAuthn du royaume |
orphans | Nombre de clés sans utilisateur |
deleted | Nombre de clés supprimées : toujours 0 pour un GET |
orphanIds | Identifiants des clés sans utilisateur |
Si les clés ou les utilisateurs ne peuvent pas être lus, l’opération échoue et rien n’est supprimé. Un royaume sans service WebAuthn configuré renvoie des compteurs à 0.
Le balayage n’est pas planifié par TOSIAM : appelez-le après les suppressions faites hors de TOSIAM, par exemple à la fin d’un traitement de départs de TOSIDM.
Données UMA#
UMA garde les données d’un utilisateur sous deux clés : son nom (ressources, libellés, demandes, bénéficiaire d’un partage) et son identifiant universel (politiques qu’il a créées, historique). Un utilisateur recréé sous le même nom reprend les deux. TOSIAM purge donc :
- tout ce que l’utilisateur possède : ses ressources, les politiques qu’il a créées, ses libellés, les demandes qu’il a reçues, son historique ;
- les demandes qu’il a faites à d’autres propriétaires : approuvée plus tard, une telle demande accorderait l’accès au compte recréé ;
- les partages que d’autres propriétaires lui ont accordés. UMA crée une politique par ressource et par bénéficiaire : c’est cette politique qui est supprimée. Le propriétaire garde sa ressource et ses partages aux autres utilisateurs ; il voit simplement disparaître l’utilisateur supprimé de la liste.
L’historique UMA est supprimé comme une donnée personnelle. La trace de la suppression reste dans l’événement d’audit de la révocation.
Les tickets de permission et les jetons RPT ne sont pas purgés : ils expirent en quelques minutes.
4. Délai#
La révocation est faite sur un fil de fond, pour ne ralentir ni l’écriture ni la notification. Elle a lieu quelques secondes après la modification. Les tests de non-régression la vérifient en 30 secondes au plus, sur TosDJ et sur OpenLDAP.
Chaque serveur du site reçoit la notification et révoque de son côté. Une session ou un jeton déjà révoqué par un autre serveur est simplement ignoré.
5. Cas particuliers#
Sessions et jetons sans état#
- Jeton OAuth2 sans état (JWT) : TOSIAM le révoque (liste de révocation) et le refuse ensuite à l’introspection et à
userinfo. Un serveur de ressources qui valide seulement la signature ne voit pas la révocation, et accepte le jeton jusqu’à son expiration (voir Jetons OAuth2). Pour qu’un départ prenne effet aussitôt, faites valider les jetons par introspection, gardez-leur une durée de vie courte, ou abonnez l’application aux signaux partagés. - Session sans état : elle n’est pas enregistrée dans le Core Token Store. TOSIAM ne peut pas la retrouver, et elle reste acceptée jusqu’à son expiration. Le délai est borné par sa durée de vie.
Annuaire sans notification#
Si le data store n’a pas de base de recherche persistante (sun-idrepo-ldapv3-config-psearchbase), une désactivation écrite directement dans l’annuaire n’est pas notifiée : elle bloque les nouvelles authentifications, mais ne révoque rien. Seules les écritures faites par TOSIAM révoquent alors. Voir Cache des identités et annuaires sans notification et, pour OpenLDAP, Utiliser OpenLDAP comme annuaire des identités.
Codes d’autorisation#
Un code d’autorisation émis juste avant la désactivation n’est pas révoqué, et peut encore être échangé contre des jetons pendant sa durée de vie, courte. Le jeton de rafraîchissement ainsi obtenu sera refusé, puisque le rafraîchissement vérifie que l’utilisateur est toujours actif. Le jeton d’accès, lui, reste valide jusqu’à son expiration.
6. Réglage et suivi#
La révocation est active par défaut. Elle se désactive par une propriété serveur :
org.tst.tosiam.idm.revokeOnDisable=falseElle n’a lieu que dans le serveur TOSIAM : ssoadm et les outils, qui chargent les data stores dans leur propre processus, ne révoquent rien eux-mêmes. Une modification faite par ssoadm à travers le serveur est traitée normalement.
Chaque révocation est tracée au niveau INFO :
| Journal | Message |
|---|---|
amIdm | User <nom> of the realm <royaume> is inactive: its sessions and tokens are revoked (ou deleted) |
amIdm | <n> session(s) of <nom> logged out |
OAuth2Provider | <n> OAuth2 token(s) of <nom> deleted |
amIdm | Graph attempts and known devices of <nom> forgotten (suppression) |
amIdm | <n> passkey(s) of <nom> deleted with the user (suppression) |
OAuth2Provider | <n> AI delegation(s) of <nom> deleted (suppression) |
UmaProvider | UMA data of <nom> purged: {umaPolicies=…, umaSharesReceived=…, …} (suppression) |
amIdm | Sweep of the passkeys of <royaume>: <n> passkey(s), <n> without user, <n> deleted (balayage) |
| Nœud ou module de SSO persistant | the user '<nom>' of the token no longer exists, or was created after it |
Un échec est tracé au niveau WARN (The credentials of <identifiant> are not revoked, ou What is kept for <identifiant> outside its entry is not purged), sans bloquer la modification ni la suppression de l’utilisateur.
Événement d’audit#
Chaque révocation produit aussi un événement d’audit AM-IDENTITY-ACCESS-REVOKED, du sujet activity et du composant Users. Il relie l’utilisateur, la cause et ce qui a été révoqué, alors que la fermeture de chaque session est auditée à part (AM-SESSION-LOGGED_OUT).
| Champ | Contenu |
|---|---|
userId, objectId | Identifiant universel de l’utilisateur |
runAs | Auteur de la désactivation ou de la suppression, si elle a été écrite par TOSIAM (console, API REST, ssoadm) ; sinon, l’identité du serveur, par exemple pour une notification de l’annuaire ou un verrouillage de compte |
transactionId | Celui de la requête qui a écrit le changement, si elle est passée par TOSIAM : l’événement se rattache ainsi à l’événement d’accès de cette requête |
after.cause | inactive ou deleted |
after.revoked | Nombre de sessions (sessions) et de jetons OAuth2 (oauth2Tokens) révoqués |
after.purged | Pour une suppression : clés d’accès (passkeys), essais des graphes (graphAttempts), appareils connus (knownDevices), délégations des agents IA (aiDelegations), données UMA (umaResources, umaPolicies, umaSharesReceived, umaLabels, umaPendingRequests, umaAuditEntries) |
after.failed | Révocations ou purges en échec, s’il y en a |
Exemple de champ after pour une suppression faite dans la console :
{
"cause": "deleted",
"revoked": {"sessions": 2, "oauth2Tokens": 3},
"purged": {"passkeys": 1, "graphAttempts": 0, "knownDevices": 0, "aiDelegations": 1,
"umaPolicies": 2, "umaSharesReceived": 1, "umaResources": 1, "umaLabels": 0,
"umaPendingRequests": 0, "umaAuditEntries": 4}
}Chaque serveur du site traite la notification de l’annuaire, mais seul le premier trouve encore quelque chose à révoquer. Un serveur ne publie donc l’événement que s’il a révoqué ou purgé quelque chose, s’il a échoué, ou s’il a lui-même écrit le changement. En général, un changement donne ainsi un seul événement pour tout le site. Un serveur qui purge ce qu’il garde en mémoire, comme les appareils connus, publie le sien.
Quand un serveur écrit lui-même le changement, il l’annonce avant de l’écrire. La notification de l’annuaire, qui peut lui parvenir avant la fin de l’écriture, attend alors cette écriture et s’y fond : le serveur publie un seul événement, avec l’auteur du changement et tout ce qui a été révoqué.
La propriété revokeOnDisable=false désactive aussi la purge à la suppression. Le contrôle des jetons de SSO persistant et le balayage des clés d’accès restent actifs.
Mis à jour le