Realms
Sur cette page
Un realm est un espace de gestion isolé dans TOSIAM. Chaque realm possède ses propres utilisateurs, groupes, rôles, politiques, modules d’authentification et configuration de services, sans interférence avec les autres realms.
Pourquoi des realms ?#
Les realms permettent le multi-tenancy : une seule instance TOSIAM peut servir plusieurs organisations, départements ou applications tout en maintenant une séparation stricte des données et des politiques.
Cas d’usage typiques :
- Séparer les utilisateurs internes (employés) des utilisateurs externes (clients)
- Héberger plusieurs clients sur la même infrastructure
- Créer des environnements de test isolés du realm de production
Hiérarchie#
Les realms forment une arborescence. Le realm racine (/) existe toujours. Les sub-realms s’y greffent :
/ (root realm)
├── /clients
│ ├── /clients/acme
│ └── /clients/contoso
└── /employeesUn sub-realm hérite de la configuration du realm parent, mais peut la surcharger localement.
Annuaire partagé et frontière de confiance#
Par défaut, un sub-realm clone le datastore du realm parent : même serveur LDAP, même suffixe racine. Les entrées (utilisateurs, groupes) sont alors physiquement communes au realm et à ses sub-realms — un utilisateur créé dans un sub-realm existe sous le même suffixe que le parent.
Un annuaire partagé entre realms n’est pas une frontière d’isolation du stockage. Qui administre un realm administre les entrées communes aux realms qui partagent son annuaire. Pour isoler réellement deux realms, donnez à chacun son propre suffixe (datastore distinct).
TOSIAM protège le cas le plus courant : sur l’API REST d’administration des identités (/api), une écriture (modification, suppression, appartenance de groupe) est refusée (403) lorsqu’elle viserait une identité qui administre un realm ancêtre du realm de la requête. Un administrateur délégué d’un sub-realm ne peut donc pas, via son sub-realm, réécrire un administrateur du realm parent. Administrer les administrateurs de son propre realm reste permis.
Ce qu’un realm contient#
| Ressource | Description |
|---|---|
| Utilisateurs & groupes | Identités stockées dans le datastore du realm |
| Rôles | Rôles statiques et filtrés |
| Modules d’authentification | Instances de modules configurées dans ce realm |
| Chaînes / graphes d’auth | Flux d’authentification disponibles |
| Services | OAuth2, SAML2, self-service, audit… |
| Politiques | Règles d’autorisation (entitlements) |
| Agents | Agents J2EE, Web et OAuth2 |
| Datastores | Sources d’identité (LDAP, AD, JDBC…) |
Gestion via l’API REST#
GET /realms → lister tous les realms
POST /realms → créer un realm
GET /realms/{realm} → lire un realm
PUT /realms/{realm} → mettre à jour
DELETE /realms/{realm} → supprimerGestion via ssoadm#
# Créer un realm
ssoadm create-realm --realm /clients/acme
# Lister les realms
ssoadm list-realms --realm /
# Ajouter un service à un realm
ssoadm add-svc-realm --realm /clients/acme --servicename iPlanetAMAuthService
# Lire les attributs d'un realm
ssoadm get-realm --realm /clients/acmeRealms et URL#
L’URL de chaque realm suit le pattern :
https://hostname/tosiam/json/realms/root/realms/{realm-name}/...Pour les endpoints d’authentification :
https://hostname/tosiam/realms/{realm}/authenticateLe realm root correspond au realm racine /.
Realm inconnu#
Une requête qui nomme un realm inexistant, par exemple /oauth2/<nom>/access_token ou ?realm=/<nom>, est refusée (400 Invalid realm sur les endpoints OAuth2). Ce refus a lieu avant toute authentification.
Pour ne pas relancer la recherche dans la configuration à chaque requête, TOSIAM garde les noms de realms inconnus dans un cache. N’importe quel client peut y faire entrer un nom ; le cache est donc limité :
- en nombre d’entrées : au-delà de la limite, le nom utilisé le moins récemment est oublié ;
- en durée : un nom est oublié après un délai, puis cherché de nouveau à la requête suivante.
Le cache est aussi vidé à chaque création, suppression ou modification d’un realm : un realm créé est accessible tout de suite, même si son nom a été refusé juste avant.
Les deux limites se règlent par des propriétés serveur :
| Propriété | Défaut | Rôle |
|---|---|---|
org.tst.tosiam.idm.unknownRealmCache.maxEntries | 1000 | Nombre maximal de noms de realms inconnus gardés |
org.tst.tosiam.idm.unknownRealmCache.lifetimeSeconds | 300 | Durée, en secondes, pendant laquelle un nom inconnu est gardé |
org.tst.tosiam.idm.unknownRealmCache.maxEntries=1000
org.tst.tosiam.idm.unknownRealmCache.lifetimeSeconds=300Une valeur nulle ou négative est ramenée à 1 entrée ou 1 milliseconde : le cache reste toujours limité. Les propriétés sont lues au démarrage du serveur.
Mis à jour le