Concepts

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
└── /employees

Un 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#

Faites défiler le tableau
RessourceDescription
Utilisateurs & groupesIdentités stockées dans le datastore du realm
RôlesRôles statiques et filtrés
Modules d’authentificationInstances de modules configurées dans ce realm
Chaînes / graphes d’authFlux d’authentification disponibles
ServicesOAuth2, SAML2, self-service, audit…
PolitiquesRègles d’autorisation (entitlements)
AgentsAgents J2EE, Web et OAuth2
DatastoresSources d’identité (LDAP, AD, JDBC…)

Gestion via l’API REST#

http
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}          → supprimer

Gestion via ssoadm#

bash
# 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/acme

Realms 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}/authenticate

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

Faites défiler le tableau
PropriétéDéfautRôle
org.tst.tosiam.idm.unknownRealmCache.maxEntries1000Nombre maximal de noms de realms inconnus gardés
org.tst.tosiam.idm.unknownRealmCache.lifetimeSeconds300Durée, en secondes, pendant laquelle un nom inconnu est gardé
properties
org.tst.tosiam.idm.unknownRealmCache.maxEntries=1000
org.tst.tosiam.idm.unknownRealmCache.lifetimeSeconds=300

Une 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