TutorielGuides

Construire un graphe de connexion dans l'éditeur

Sur cette page

Un graphe d’authentification décrit un parcours de connexion nœud par nœud : chaque nœud demande quelque chose ou prend une décision, et ses sorties mènent au nœud suivant. Ce tutoriel construit dans l’éditeur de la console un parcours en trois temps :

  1. l’identifiant, puis la vérification du mot de passe, confiée à un sous-graphe réutilisable dont le nombre d’essais est un paramètre ;
  2. un nœud de script JavaScript qui demande l’espace de travail, personnel ou professionnel ;
  3. pour l’espace professionnel, un second script qui affiche une charte à accepter.

Le code est dans le dépôt tosiam-samples, dossier tosiam-auth-graph : le graphe exporté de l’éditeur et les commandes ssoadm qui le recréent. Pour les notions (moteur, nœuds, sous-graphes, format JSON), voir Graphes d’authentification.

Étape 1 : le sous-graphe de vérification du mot de passe#

Un sous-graphe est un morceau de parcours que plusieurs graphes appellent. Celui-ci demande le mot de passe, le vérifie dans le data store et redemande en cas d’erreur, autant de fois que le dit son paramètre essais. Il ne finit pas par un succès ou un échec, mais par une sortie nommée (SubGraphExitNode) : valide ou refuse, que le graphe appelant relie à la suite.

Le sous-graphe se crée avec ssoadm, depuis tosiam/verification-mot-de-passe.json :

bash
ssoadm create-sub-graph --realm ref --name verification-mot-de-passe \
  --datafile verification-mot-de-passe.json
json
{
  "startNodeId": "motDePasse",
  "parameters": [
    { "name": "essais", "description": "Nombre de nouveaux essais après un mot de passe faux", "default": "3" }
  ],
  "steps": {
    "motDePasse":   { "type": "PasswordCollectorNode", "outcomes": { "outcome": "verification" } },
    "verification": { "type": "DataStoreNode", "config": { "authLevel": 0 },
                      "outcomes": { "true": "valide", "false": "essais" } },
    "essais":       { "type": "RetryLimitNode", "config": { "retryLimit": "${essais}" },
                      "outcomes": { "true": "motDePasse", "false": "refuse" } },
    "valide":       { "type": "SubGraphExitNode", "config": { "exitName": "valide" } },
    "refuse":       { "type": "SubGraphExitNode", "config": { "exitName": "refuse" } }
  }
}

(Le fichier de l’exemple porte aussi les positions des nœuds dans l’éditeur, layout.) ${essais} est remplacé, à chaque exécution, par la valeur que donne le graphe appelant, ou par 3.

Dans la console, Graphes d’authentification, le sous-graphe apparaît avec l’étiquette SOUS-GRAPHE. Ouvert dans l’éditeur :

Éditeur de graphes, sous-graphe verification-mot-de-passe : Mot de passe (départ), Vérification, Essais restants avec une limite vide et l'indication 3, sorties Valide et Refusé Éditeur de graphes, sous-graphe verification-mot-de-passe : Mot de passe (départ), Vérification, Essais restants avec une limite vide et l'indication 3, sorties Valide et Refusé 1 2 3 4
Le nœud de départ (1), la boucle des essais (2) et les deux sorties nommées (3, 4). La limite des essais est la référence au paramètre, ${essais}.

Étape 2 : créer le graphe et placer les nœuds#

Graphes d’authentification → Nouveau graphe, nom connexion-espace. L’éditeur s’ouvre sur une toile vide. Cherchez chaque nœud dans la palette de gauche et glissez-le sur la toile :

Faites défiler le tableau
Nœud de la paletteRôle
Saisie de l’identifiantDemande l’identifiant
Sous-grapheAppelle verification-mot-de-passe
JavaScript (intégré), deux fois« Espace de travail », puis « Charte »
Succès, ÉchecFins du parcours

Le premier nœud posé devient le nœud de départ (étiquette DÉPART) ; le drapeau d’un nœud le désigne comme départ. L’éditeur nomme les nœuds d’après leur type et ne permet pas de les renommer : un nom donné dans un fichier importé est gardé.

Étape 3 : appeler le sous-graphe#

Dans le nœud « Sous-graphe », saisissez verification-mot-de-passe : le nœud montre aussitôt les sorties valide et refuse du sous-graphe, et un champ par paramètre. Mettez 2 dans « Nombre de nouveaux essais après un mot de passe faux » : ce graphe-ci accepte deux nouveaux essais, quel que soit le défaut du sous-graphe.

Étape 4 : les deux scripts#

Un nœud « JavaScript (intégré) » (ScriptedDecisionNode) exécute un script à chaque passage. Le script pose une question avec action.send(...), puis, quand l’utilisateur a répondu, choisit sa sortie avec action.goTo(...). Ses sorties possibles se déclarent dans le champ « Outcomes », séparées par des virgules : personnel,professionnel pour le premier, accepte,refuse pour le second. Le champ « Name » donne au script un nom qui le distingue dans les journaux : espace-de-travail, charte-professionnelle.

Modifier le code ouvre l’éditeur de script :

Éditeur de script du nœud JavaScript : dix lignes, sharedState['espace.demande'] = true, action.send(callbacksBuilder.choiceCallback('Espace de travail', ['Personnel', 'Professionnel'], 0)), action.goTo(...), sorties personnel et professionnel, Aucune erreur de syntaxe Éditeur de script du nœud JavaScript : dix lignes, sharedState['espace.demande'] = true, action.send(callbacksBuilder.choiceCallback('Espace de travail', ['Personnel', 'Professionnel'], 0)), action.goTo(...), sorties personnel et professionnel, Aucune erreur de syntaxe 1 2 3 4 5
Le script note qu’il a posé sa question (1), la pose (2), puis choisit sa sortie d’après la réponse (3) ; les sorties déclarées (4) ; Enregistrer (5) reporte le code dans le nœud.
javascript
if (!sharedState['espace.demande']) {
  sharedState['espace.demande'] = true;
  action.send(callbacksBuilder.choiceCallback('Espace de travail', ['Personnel', 'Professionnel'], 0));
} else {
  delete sharedState['espace.demande'];
  action.goTo(callbacks.getChoice() == 1 ? 'professionnel' : 'personnel');
}

Le second script affiche un texte et un choix :

javascript
if (!sharedState['charte.demandee']) {
  sharedState['charte.demandee'] = true;
  action.send(
    callbacksBuilder.textOutputCallback("L'espace professionnel est réservé à un usage professionnel. Acceptez-vous la charte d'utilisation ?"),
    callbacksBuilder.choiceCallback('Charte', ["J'accepte", 'Je refuse'], 0));
} else {
  delete sharedState['charte.demandee'];
  action.goTo(callbacks.getChoice() == 0 ? 'accepte' : 'refuse');
}

TOSIAM propose aussi un nœud « Conditions d’utilisation » (TermsAndConditionsNode), qui garde la version acceptée dans le profil et ne la redemande pas à la connexion suivante (voir Nœuds : lifecycle utilisateur). Le script de ce tutoriel ne stocke rien : la charte est présentée à chaque connexion.

Étape 5 : relier les nœuds, vérifier, enregistrer#

Tirez un lien de chaque sortie (pastille à droite d’un nœud) vers l’entrée du nœud suivant (pastille à gauche) :

Faites défiler le tableau
SortieVers
Saisie de l’identifiant → outcomeSous-graphe
Sous-graphe → valideEspace de travail
Sous-graphe → refuseÉchec
Espace de travail → personnelSuccès
Espace de travail → professionnelCharte
Charte → accepteSuccès
Charte → refuseÉchec

Réorganiser automatiquement le graphe range les nœuds. L’indicateur de santé de la barre d’outils passe au vert quand rien ne manque (sortie non reliée, nœud inaccessible, script sans sortie…). Enregistrez (Ctrl+S).

Éditeur, graphe connexion-espace : Saisie de l'identifiant (départ), Sous-graphe verification-mot-de-passe avec 2 essais, deux nœuds JavaScript avec leurs sorties personnel, professionnel, accepte, refuse, Succès et Échec ; 6 nœuds, 7 connexions Éditeur, graphe connexion-espace : Saisie de l'identifiant (départ), Sous-graphe verification-mot-de-passe avec 2 essais, deux nœuds JavaScript avec leurs sorties personnel, professionnel, accepte, refuse, Succès et Échec ; 6 nœuds, 7 connexions 1 2 3 4 5 6
L’identifiant (1), le sous-graphe et son paramètre (2), les scripts « Espace de travail » (3) et « Charte » (4), les deux fins (5) et Enregistrer (6).

Étape 6 : exposer le graphe à la connexion#

Exposer ce graphe comme parcours de connexion (barre d’outils) crée une instance du module graph-module du même nom, qui exécute le graphe. La liste des graphes le marque ACTIF :

Liste des graphes d'authentification du royaume ref : connexion-espace, 6 nœuds, ACTIF ; verification-mot-de-passe, SOUS-GRAPHE, 5 nœuds Liste des graphes d'authentification du royaume ref : connexion-espace, 6 nœuds, ACTIF ; verification-mot-de-passe, SOUS-GRAPHE, 5 nœuds 1 2 3
Le graphe exposé (1), son sous-graphe (2), et Exporter (3).

L’adresse de connexion, par la nouvelle page de connexion ou par XUI :

http://localhost:8080/tosiam/auth/?realm=ref&module=connexion-espace
http://localhost:8080/tosiam/XUI/?realm=/ref&authIndexType=module&authIndexValue=connexion-espace#login

Exécuter ce graphe comme connexion (barre d’outils de l’éditeur) le teste aussi sans ouvrir de session.

Étape 7 : exporter, puis recréer avec ssoadm#

Exporter (liste des graphes) enregistre une sélection de graphes dans un fichier JSON, avec les sous-graphes qu’ils appellent :

Fenêtre Exporter des graphes du royaume ref : connexion-espace coché, option Inclure les sous-graphes référencés cochée, bouton Exporter (1) Fenêtre Exporter des graphes du royaume ref : connexion-espace coché, option Inclure les sous-graphes référencés cochée, bouton Exporter (1) 1 2 3
Le graphe choisi (1), ses sous-graphes joints au fichier (2), Exporter (3).

Le fichier est une enveloppe (graphs, subGraphs) ; ssoadm attend un graphe par fichier. L’exemple garde les deux, tirés de l’export avec jq, et les recrée ainsi :

bash
jq '.graphs["connexion-espace"]' tosiam-authgraphs-ref-*.json > connexion-espace.json
jq '.graphs["verification-mot-de-passe"]' tosiam-authgraphs-ref-*.json > verification-mot-de-passe.json

ssoadm create-sub-graph     --realm ref --name verification-mot-de-passe --datafile verification-mot-de-passe.json
ssoadm create-auth-graph    --realm ref --name connexion-espace --datafile connexion-espace.json
ssoadm create-auth-instance --realm ref --name connexion-espace --authtype AuthGraph
ssoadm update-auth-instance --realm ref --name connexion-espace --attributevalues tosiam-auth-graph-id=connexion-espace

Le sous-graphe d’abord : le graphe y fait référence. Les identifiants des nœuds (node_1…) sont ceux que l’éditeur a donnés. Le format complet est décrit sur la page Import, export et format JSON.

Étape 8 : se connecter#

Ouvrez l’adresse de l’étape 6 et connectez-vous avec mmouse / Mickey-Mouse-2026. Après le mot de passe, le premier script demande l’espace de travail ; le choix s’affiche sous forme de boutons :

Nouvelle page de connexion : question Espace de travail, choix Personnel et Professionnel, Professionnel sélectionné, bouton Continuer Nouvelle page de connexion : question Espace de travail, choix Personnel et Professionnel, Professionnel sélectionné, bouton Continuer 1 2
La question du script (1) et le choix (2).
Page XUI : Espace de travail, boutons Personnel et Professionnel, Professionnel sélectionné, bouton Se connecter Page XUI : Espace de travail, boutons Personnel et Professionnel, Professionnel sélectionné, bouton Se connecter 1 2
La question du script (1) et le choix (2).

« Personnel » ouvre la session. « Professionnel » affiche d’abord la charte :

Nouvelle page de connexion : texte L'espace professionnel est réservé à un usage professionnel. Acceptez-vous la charte d'utilisation ? ; Charte, choix J'accepte et Je refuse, bouton Continuer Nouvelle page de connexion : texte L'espace professionnel est réservé à un usage professionnel. Acceptez-vous la charte d'utilisation ? ; Charte, choix J'accepte et Je refuse, bouton Continuer 1 2
Le texte du second script (1) et son choix (2) : « J’accepte » ouvre la session, « Je refuse » la refuse.
Page XUI : texte L'espace professionnel est réservé à un usage professionnel. Acceptez-vous la charte d'utilisation ? ; Charte, boutons J'accepte et Je refuse Page XUI : texte L'espace professionnel est réservé à un usage professionnel. Acceptez-vous la charte d'utilisation ? ; Charte, boutons J'accepte et Je refuse 1 2
Le texte du second script (1) et son choix (2) : « J’accepte » ouvre la session, « Je refuse » la refuse.

En cas de problème#

Faites défiler le tableau
SymptômeCause probable
« Authentication failed » juste après l’identifiantLe sous-graphe manque, ou il est rangé parmi les graphes d’authentification : la liste ne lui donne pas l’étiquette SOUS-GRAPHE, et la validation du graphe appelant le signale. Ouvrez-le dans l’éditeur et enregistrez-le : une sortie de sous-graphe le range parmi les sous-graphes
Le nœud « Sous-graphe » n’a pas de sortieLe nom saisi n’est celui d’aucun sous-graphe, ou le sous-graphe n’a pas de Sortie de sous-graphe
« Authentication failed » après un mot de passe justeTrois essais faux récents : le compte est bloqué 15 minutes. Lever le blocage sur la fiche de l’utilisateur

Pour aller plus loin#

Mis à jour le