Accueil · Guide de démarrage · Choisir mon rôle · Je saisis une intervention · Je valide pour ma région · Je valide au niveau central · Je consulte · J'administre la plateforme
Destiné à deux publics : tous les utilisateurs, pour la gestion de leur mot de passe ; les administrateurs, pour la gestion des comptes.
Keycloak gère les identifiants et les mots de passe de la plateforme. Un identifiant unique donne accès à toutes les applications : Tableau de Bord Exécutif, Apache Superset, ODK Central, CloudBeaver.
Autrement dit, vous ne vous connectez qu'une seule fois. C'est Keycloak qui reconnaît votre compte partout ensuite.
Selon votre rôle, vous n'ouvrirez pas les mêmes écrans.
Si vous êtes utilisateur. Vous n'ouvrez pratiquement jamais Keycloak directement. Vous croiserez son écran de connexion à chaque ouverture d'une application. Vous y reviendrez de manière explicite dans deux cas seulement : changer votre mot de passe ou l'oublier.
Si vous êtes administrateur. Vous ouvrez Keycloak régulièrement pour créer des comptes, attribuer des rôles, activer ou désactiver des utilisateurs.
Les deux publics suivent des parcours différents, décrits ci-dessous.
Le mot de passe provisoire ne fonctionne qu'une seule fois. Si vous ne changez pas votre mot de passe à ce moment, il faudra demander une nouvelle réinitialisation.
À faire régulièrement, ou dès qu'un doute apparaît sur sa confidentialité.
Le changement est immédiat. Aucune autre action n'est nécessaire.
Si le message n'arrive pas dans les cinq minutes, vérifiez le dossier de courrier indésirable. Si rien n'apparaît, contactez l'administrateur : votre adresse est peut-être mal enregistrée.
Trois échecs successifs bloquent le compte, par sécurité. Le déblocage n'est pas automatique.
Contactez l'administrateur en indiquant votre nom et votre adresse email. Le déblocage prend quelques minutes.
Un realm est un « univers » Keycloak. La plateforme IMIS PTFs Togo en occupe un seul. Attention à ne jamais travailler dans le realm master, qui gère Keycloak lui-même.
Trois étapes, dans cet ordre.
Étape 1. Créer l'identité.
Étape 2. Attribuer un mot de passe provisoire.
Étape 3. Attribuer le rôle.
saisie, validation_region, responsable_programme, directeur_chef_agence, lecture_seule ou administrateur.Le compte est prêt côté Keycloak. Il reste à créer la ligne miroir dans la base via CloudBeaver, en utilisant la même adresse email.
Exemple 1 : ouvrir un compte pour un nouveau point focal de PTF, région des Plateaux.
saisie.imis.utilisateurs avec role = 'saisie', niveau_geo = 'regional', id_region = 2 pour les Plateaux.Exemple 2 : changer le rôle d'un utilisateur qui passe de saisie à validation_region.
saisie (bouton Unassign), ajoutez validation_region.UPDATE imis.utilisateurs SET role = 'validation_region', id_region = 3 WHERE email = '...';.Les deux systèmes doivent rester cohérents. Un rôle Keycloak différent de celui de la base crée des situations difficiles à diagnostiquer.
Exemple 3 : désactiver un compte après le départ d'un agent.
UPDATE imis.utilisateurs SET actif = false WHERE email = '...';.Ne supprimez pas le compte. Les interventions saisies ou validées par la personne doivent rester rattachées à son nom pour préserver la traçabilité.
À faire quand un utilisateur en fait la demande, ou après un blocage.
Après trois tentatives échouées, un compte est verrouillé.
Le déblocage est immédiat. L'utilisateur peut se reconnecter aussitôt.
Trois choses relèvent d'autres outils.
niveau_geo et id_region dans imis.utilisateurs, pas dans Keycloak.Autrement dit, Keycloak dit qui vous êtes. La base dit ce que vous avez le droit de voir.
imis.utilisateurs. L'utilisateur peut se connecter mais ne voit rien.master par erreur.Question sur votre propre compte ou votre mot de passe : gtounkara@worldbank.org
Question technique sur Keycloak (administrateurs) : équipe technique via gtounkara@worldbank.org
Contenu, domaines, indicateurs
Dr. Auréole Nganhyim, OMS Togo : nganhyima@who.int
Accès, technique, administration
Gary Tounkara, Banque mondiale : gtounkara@worldbank.org