Concepts

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.

Faites défiler le tableau
Après la désactivationJusqu’à 3.37À partir de 3.38.0
Nouvelle authentificationRefuséeRefusée
Session ouverte (avec état)Valide jusqu’à son expirationFermée, comme une déconnexion
Jeton d’accès OAuth2 (introspection, tokeninfo)Valide jusqu’à son expirationRévoqué
Jeton de rafraîchissement OAuth2RefuséRévoqué
userinfoRefuséRefusé
Consentements OAuth2GardésGardé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, ou nsAccountLock selon l’annuaire) ;
  • l’utilisateur est supprimé.

TOSIAM l’apprend par deux voies, qui couvrent tous les canaux de modification :

Faites défiler le tableau
CanalComment TOSIAM l’apprend
Écriture directe dans l’annuaire : outil de gestion des identités (TOSIDM), script, ldapmodifyNotification 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, ssoadmDirectement, 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 :

Faites défiler le tableau
DonnéesRangéesCe qui se passaitÀ partir de 3.38.0
Jetons de SSO persistantAnnuaire configuré dans chaque nœud ou module, par nom de connexionL’ancien cookie connectait l’utilisateur recrééJeton refusé et supprimé à sa présentation
Essais et blocages des graphesCore Token Store, par royaume et nomLe compte recréé héritait des blocagesEffacés
Empreintes d’appareil des graphesMémoire de chaque serveur, par nomLe compte recréé héritait des appareils connusEffacées
Clés d’accès WebAuthnAnnuaire du service WebAuthn, par entryUUIDClés orphelines, inutilisablesSupprimées avec l’utilisateur, ou par balayage
Délégations consenties aux agents IACore Token Store, par royaume et nomDélégations gardées jusqu’à leur expiration, déjà refusées au compte recrééSupprimées
Ressources UMAMagasin des ressources, par nom du propriétaireLe compte recréé retrouvait les ressources de l’ancienSupprimées
Politiques UMA créées par l’utilisateur (partages, repartages)Politiques du royaume, par identifiant universelLe compte recréé retrouvait les partages de l’ancienSupprimées
Partages UMA reçus d’autres propriétairesPolitiques des autres propriétaires, par nom du bénéficiaireLe compte recréé héritait des accès accordés à l’ancienRetirés, voir Données UMA
Libellés UMAMagasin des libellés, sous le nom de l’utilisateurLe compte recréé retrouvait les libellésSupprimés
Demandes UMA en attente, reçues ou faitesMagasin des demandes, par nomUne demande approuvée plus tard ouvrait un accès au compte recrééSupprimées
Historique UMAMagasin de l’historique, par identifiant universelLe compte recréé voyait l’historique de l’ancienSupprimé

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 :

Faites défiler le tableau
Utilisateur du jetonConnexionJeton
Existe, actif, créé avant le jetonAcceptéeGardé
InactifRefuséeGardé, pour la réactivation
N’existe plusRefuséeSupprimé
Créé après le jeton (même nom, autre personne)RefuséeSupprimé

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.

Faites défiler le tableau
MéthodeCheminEffet
GET/api/realms/{realm}/webauthn/orphansListe les clés orphelines, sans rien supprimer
DELETE/api/realms/{realm}/webauthn/orphansSupprime 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).

bash
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 :

json
{
  "credentials": 42,
  "orphans": 2,
  "deleted": 0,
  "orphanIds": ["mT0x…", "Qk9y…"]
}
Faites défiler le tableau
ChampContenu
credentialsNombre de clés d’accès dans l’annuaire du service WebAuthn du royaume
orphansNombre de clés sans utilisateur
deletedNombre de clés supprimées : toujours 0 pour un GET
orphanIdsIdentifiants 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 :

properties
org.tst.tosiam.idm.revokeOnDisable=false

Elle 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 :

Faites défiler le tableau
JournalMessage
amIdmUser <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
amIdmGraph 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)
UmaProviderUMA data of <nom> purged: {umaPolicies=…, umaSharesReceived=…, …} (suppression)
amIdmSweep of the passkeys of <royaume>: <n> passkey(s), <n> without user, <n> deleted (balayage)
Nœud ou module de SSO persistantthe 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).

Faites défiler le tableau
ChampContenu
userId, objectIdIdentifiant universel de l’utilisateur
runAsAuteur 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
transactionIdCelui 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.causeinactive ou deleted
after.revokedNombre de sessions (sessions) et de jetons OAuth2 (oauth2Tokens) révoqués
after.purgedPour 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.failedRévocations ou purges en échec, s’il y en a

Exemple de champ after pour une suppression faite dans la console :

json
{
  "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