H· Hawiyati Documentation
Documentation Hawiyati

Guide d'administration

Ce guide couvre l'ensemble des fonctionnalités disponibles dans la console d'administration Hawiyati — gestion des utilisateurs et des groupes, enregistrement des applications (fournisseurs de services), configuration des politiques d'authentification, moteur de risque adaptatif, recherche et export des journaux d'audit, provisionnement SCIM et paramètres système. Accédez à la console d'administration à l'adresse https://localhost:8095 ou votre nom d'hôte configuré.

Documentation Hawiyati

Ce guide couvre l'ensemble des fonctionnalités disponibles dans la console d'administration Hawiyati — gestion des utilisateurs et des groupes, enregistrement des applications (fournisseurs de services), configuration des politiques d'authentification, moteur de risque adaptatif, recherche et export des journaux d'audit, provisionnement SCIM et paramètres système. Accédez à la console d'administration à l'adresse https://localhost:8095 ou votre nom d'hôte configuré.

Console d'administration

La console d'administration Hawiyati est une application web WebFlux + Thymeleaf fonctionnant sur le port 8095. Elle constitue l'interface principale pour toutes les tâches d'administration de la plateforme.

Accès à la console

Naviguez vers https://localhost:8095 (environnement de développement) ou votre nom d'hôte administrateur configuré. Lors de la première connexion, utilisez les identifiants administrateur d'amorçage définis lors de l'installation. Toutes les connexions suivantes utilisent l'authentification propre à Hawiyati — la console d'administration est elle-même une application protégée.

⚠
TLS obligatoire

La console d'administration impose HTTPS. N'exposez pas le port 8095 sur une interface publique. En production, placez-la derrière un répartiteur de charge privé ou une passerelle VPN accessible uniquement au personnel d'exploitation.

Rôles des opérateurs administrateurs

Chaque compte administrateur dispose de l'un des trois rôles suivants. Les rôles sont définis à la création du compte et ne peuvent pas être auto-élevés.

RôleBadgePermissions
SUPER_ADMIN Super Admin Accès complet — créer/supprimer des comptes administrateurs, modifier les paramètres système, consulter tous les journaux d'audit, gérer toutes les entités
ADMIN Admin Gérer les utilisateurs, les groupes, les applications, les politiques et la configuration des risques ; ne peut pas créer/supprimer des comptes administrateurs ni modifier les paramètres système globaux
VIEWER Viewer Accès en lecture seule à toutes les pages ; ne peut modifier aucune configuration ni donnée utilisateur. Adapté aux auditeurs et ingénieurs d'astreinte qui nécessitent une visibilité sans accès en écriture.

Tableau de bord

La page d'accueil de la console d'administration affiche un instantané en temps réel de l'état de la plateforme :

—
Utilisateurs totaux
—
Sessions actives
—
FS enregistrés
—
Échecs de connexion (24h)

Structure de navigation

Élément de menuFonction
UtilisateursConsulter, créer, modifier, suspendre et supprimer les comptes utilisateurs
GroupesCréer et gérer les groupes utilisés dans les conditions des politiques
File KYCExaminer et approuver/rejeter les soumissions de documents d'identité
ApplicationsEnregistrer les FS SAML et clients OIDC, affecter des politiques
PolitiquesCréer et gérer les jeux de règles des politiques d'authentification
Zones réseauDéfinir des plages CIDR IPv4 nommées utilisées dans les conditions des politiques
RisqueConfigurer le moteur de risque adaptatif, les signaux, les listes de blocage
Journal d'auditRechercher et exporter les événements de sécurité structurés
Sessions activesConsulter les sessions utilisateurs actives ; révoquer des sessions individuelles
ParamètresParamètres système globaux : TTL de session, politique de mot de passe, SMTP, LDAP, personnalisation

Utilisateurs & Groupes

Hawiyati maintient un schéma d'identité unique pour tous les utilisateurs quelle que soit leur origine — comptes locaux, LDAP/AD, provisionnés via SCIM, ou SQL externe. La page Utilisateurs affiche les comptes du référentiel d'utilisateurs actuellement actif.

Sources d'utilisateurs

SourceMode d'arrivée des utilisateursAuthentification
LOCAL Créés par un administrateur ou via l'auto-inscription Mot de passe haché Argon2id stocké dans la base de données Hawiyati
LDAP / Active Directory Synchronisés depuis un serveur d'annuaire, ou à la volée lors de la première connexion réussie Liaison LDAP en pass-through — le mot de passe n'est jamais stocké dans Hawiyati
SCIM Poussés par un système externe RH/IGA/synchronisation AD via l'API SCIM 2.0 sur le port 8098 Identifiant local défini par le système de provisionnement, ou réinitialisé par l'utilisateur
SQL externe Les utilisateurs existent dans une base de données relationnelle gérée par le client ; Hawiyati les lit Mot de passe vérifié contre le hachage de la base de données externe
ℹ
Référentiel actif

Le référentiel d'utilisateurs actif est défini dans Administration → Paramètres → Référentiels d'utilisateurs. Le changement de référentiel prend effet immédiatement pour les nouvelles tentatives de connexion. Les utilisateurs des référentiels inactifs restent dans la base de données mais ne peuvent pas s'authentifier tant que leur source n'est pas réactivée.

Modèle de statut utilisateur

L'état faisant autorité repose sur deux indicateurs booléens dans l'enregistrement utilisateur : active et pendingApproval. La console d'administration les présente sous forme d'un libellé de statut calculé.

Statut affichéactivependingApprovalPeut s'authentifier ?
ACTIF true false Oui — accès complet
ACTIF_LIMITÉ true true Limité — connexion de base uniquement, pas d'accès aux FS tant que non approuvé
INACTIF false false Non — compte suspendu
EN ATTENTE D'APPROBATION false true Non — en attente d'approbation administrative
MIGRÉ NON RÉCLAMÉ false true + indicateur migré Non — importé en masse, en attente de revendication par l'utilisateur réel
⚠
ACTIF_LIMITÉ est calculé

ACTIF_LIMITÉ est un libellé de présentation — ce n'est pas une colonne de base de données. Ne le cherchez pas dans le schéma. La source de vérité est toujours les deux indicateurs booléens. Un utilisateur avec active=true, pendingApproval=true dispose d'un identifiant valide mais est restreint en attente d'une vérification post-inscription.

Création d'un utilisateur

Naviguez vers Administration → Utilisateurs → Ajouter un utilisateur et complétez le formulaire.

ChampObligatoireNotes
Nom d'utilisateurObligatoire3–30 caractères ; lettres, chiffres, tirets bas, tirets. Unique, immuable après création.
Adresse e-mailObligatoireAdresse e-mail valide. Les comptes créés par un administrateur sont automatiquement marqués email_verified=true.
Mot de passeObligatoireMinimum 8 caractères. Haché avec Argon2id à l'enregistrement — jamais stocké en clair.
Numéro de téléphoneFacultatifFormat E.164 — ex. +213555123456. Requis pour l'AMF par SMS OTP.
Prénom, NomFacultatifUtilisés dans les attributs et les modèles de notifications par e-mail.
LangueFacultatiffr / en / ar. Affecte la langue des e-mails de notification. Valeur par défaut : fr.
✓
Activation immédiate

Les utilisateurs créés par un administrateur peuvent se connecter immédiatement. Aucun e-mail d'invitation n'est envoyé, sauf si vous en déclenchez un manuellement depuis la page de détail de l'utilisateur (Envoyer une invitation TOTP ou Envoyer une invitation Clé d'accès).

Modification d'un utilisateur

Naviguez vers Administration → Utilisateurs → [nom d'utilisateur] → Modifier. Champs modifiables : adresse e-mail, numéro de téléphone, prénom, nom, langue et statut actif.

⚠
Le nom d'utilisateur est immuable

Le nom d'utilisateur ne peut pas être modifié après la création — c'est la clé de recherche stable utilisée dans les journaux d'audit, les appartenances aux groupes et les enregistrements de session des applications. Si un mauvais nom d'utilisateur a été utilisé, créez un nouveau compte et supprimez l'ancien (après avoir vérifié qu'il n'existe pas d'obligation de conformité d'audit nécessitant de conserver l'historique).

Suspension d'un compte

En mode de modification, désactivez le commutateur Actif. Les sessions existantes ne sont pas immédiatement résiliées — l'utilisateur est bloqué à la prochaine requête nécessitant une validation de session, ou à l'expiration de sa session en cours. Pour forcer la résiliation immédiate de la session, révoquez les sessions actives depuis Administration → Sessions actives.

Suppression d'un utilisateur

Naviguez vers Administration → Utilisateurs → [nom d'utilisateur] → Supprimer. Cette opération supprime définitivement l'enregistrement utilisateur et toutes les données associées : identifiants, appartenances aux groupes, enregistrements de consentement, enregistrements de dispositifs, soumissions KYC. Les sessions actives dans Redis subsistent jusqu'à l'expiration du TTL.

⚠
Irréversible

La suppression est permanente. Si vous avez besoin de conserver le compte pour un examen de conformité, suspendez plutôt que de supprimer. La suppression retire tous les liens d'audit associés à ce nom d'utilisateur depuis l'enregistrement utilisateur ; les événements d'audit eux-mêmes demeurent dans la table audit_events.

Groupes

Les groupes sont des ensembles nommés d'utilisateurs utilisés comme conditions dans les politiques d'authentification. Naviguez vers Administration → Groupes.

Type de groupeDescriptionGestion des membres
LocalCréé et géré dans la console HawiyatiAjouter/supprimer des membres via Administration → Groupes → [groupe] → Membres
LDAP / ADImporté lors de la synchronisation d'annuaireLecture seule dans Hawiyati ; géré dans le serveur d'annuaire

Chaque modification d'appartenance publie une invalidation sur le canal Redis sp-config:invalidate. Les caches de politiques en aval sont vidés en quelques secondes — aucun redémarrage de service n'est nécessaire.

✓
Bonne pratique

Utilisez des groupes, pas des exceptions par utilisateur. Les politiques d'authentification opèrent sur des groupes. L'affectation d'utilisateurs à des groupes nommés (« Utilisateurs privilégiés », « Prestataires », « Télétravail ») rend les politiques prévisibles et auditables.


Gestion des identifiants

Les administrateurs peuvent gérer tous les facteurs d'authentification pour tout compte utilisateur. Ces opérations sont à privilèges élevés — chaque action est journalisée.

Réinitialisation du mot de passe

Naviguez vers Administration → Utilisateurs → [nom d'utilisateur] → Réinitialiser le mot de passe. Définit immédiatement un nouveau mot de passe. L'ancien mot de passe est invalidé. Le nouveau mot de passe doit comporter au moins 8 caractères et est haché avec Argon2id avant stockage. Communiquez le nouveau mot de passe par un canal hors bande sécurisé — la console d'administration n'affiche pas le mot de passe après soumission.

Journalisé sous : end_user.reset_password

Authentificateur TOTP

Deux options pour l'inscription TOTP assistée par un administrateur :

A
Assistée par administrateur (en présentiel ou partage d'écran)
Ouvrez Administration → Utilisateurs → [nom d'utilisateur] → Inscrire TOTP. La console génère un secret TOTP et un code QR. L'utilisateur scanne avec son application d'authentification (compatible RFC 6238), lit le code à 6 chiffres, et l'administrateur le saisit pour activer. Le secret est chiffré AES-256-GCM au repos.
B
Envoi d'une invitation d'inscription par e-mail
Pour les utilisateurs distants : Administration → Utilisateurs → [nom d'utilisateur] → Envoyer une invitation TOTP par e-mail. Le système envoie un e-mail avec un lien vers la page d'inscription TOTP en libre-service (/idp/enroll/totp). L'utilisateur se connecte avec son mot de passe pour vérifier son identité, scanne le code QR et finalise l'inscription de manière autonome. Nécessite la configuration SMTP.

Réinitialisation TOTP : Supprime le secret TOTP stocké. La préférence AMF de l'utilisateur revient à PWD_ONLY jusqu'à une nouvelle inscription. Journalisé sous : end_user.reset_totp

FIDO2 / Clés d'accès (Passkeys)

L'enregistrement des identifiants FIDO2 doit s'effectuer dans le propre navigateur de l'utilisateur — WebAuthn lie l'identifiant au dispositif de l'utilisateur et à l'identifiant de la partie de confiance. Les administrateurs ne peuvent pas enregistrer une clé d'accès au nom d'un utilisateur.

Action administrateurChemin de navigationDescription
Envoyer une invitation clé d'accès Administration → Utilisateurs → [nom d'utilisateur] → Envoyer une invitation clé d'accès Envoie un e-mail personnalisé avec un lien vers /idp/fido2/enroll. L'utilisateur se connecte, enregistre sa clé d'accès.
Supprimer toutes les clés FIDO2 Administration → Utilisateurs → [nom d'utilisateur] → Supprimer toutes les clés d'accès Supprime chaque identifiant FIDO2 enregistré. À utiliser lorsqu'un utilisateur perd tous ses dispositifs. Journalisé sous : end_user.delete_fido2.

File de vérification KYC

Arbre de décision pour la révision KYC manuelle
Les demandes KYC soumises à la révision manuelle suivent ce flux de décision structuré.

La vérification KYC (Connaissance du client) est une étape d'inscription optionnelle nécessitant que les utilisateurs soumettent un document d'identité officiel. Lorsqu'elle est activée par la politique d'inscription, les documents soumis apparaissent dans la file KYC pour examen par l'administrateur.

Naviguez vers Administration → File KYC. La file affiche toutes les soumissions en attente dans l'ordre chronologique (les plus anciennes en premier).

ActionEffetÉvénement d'audit
Approuver Définit le statut de soumission à APPROVED et le kyc_status de l'utilisateur à APPROVED. Un e-mail de confirmation est envoyé si SMTP est configuré. L'utilisateur peut désormais accéder aux applications nécessitant le KYC. kyc.approve
Rejeter Définit le statut de soumission à REJECTED. Un e-mail de rejet est envoyé avec le motif de rejet obligatoire. L'utilisateur peut soumettre à nouveau, sauf si la politique l'en empêche. kyc.reject
✓
Motif de rejet

Le motif de rejet est obligatoire et est envoyé à l'utilisateur. Rédigez des motifs clairs et exploitables — par exemple : « L'image du document est floue — veuillez soumettre une photo nette de votre carte nationale d'identité. » Des motifs de rejet vagues augmentent les erreurs de soumission et les tickets de support.

Valeurs de statut KYC

StatutSignification
(aucun)L'utilisateur n'a soumis aucun document KYC
PENDINGDocuments soumis, en attente d'examen par l'administrateur
APPROVEDDocuments vérifiés et approuvés
REJECTEDExamen terminé ; soumission rejetée — l'utilisateur peut soumettre à nouveau

Applications (Fournisseurs de services)

Les fournisseurs de services (FS) sont les applications qui utilisent Hawiyati comme fournisseur d'identité. Naviguez vers Administration → Applications pour gérer les enregistrements de FS.

Ajout d'un FS SAML

1
Obtenir les métadonnées du FS
Téléchargez le XML de métadonnées SAML du FS depuis son point de terminaison de métadonnées. Si le FS n'en dispose pas, collectez : l'Identifiant d'entité (URN ou URL), l'URL ACS (point de terminaison du service consommateur d'assertions), et optionnellement le certificat public du FS pour les demandes AuthnRequest signées.
2
Créer l'enregistrement du FS
Naviguez vers Administration → Applications → Enregistrer un FS SAML. Importez le XML de métadonnées, ou saisissez manuellement l'Identifiant d'entité et l'URL ACS. Le formulaire d'enregistrement du FS accepte également un nom, une description et une URL de logo à des fins d'affichage.
3
Fournir les métadonnées du FI au FS
Téléchargez les métadonnées du FI Hawiyati depuis https://[hôte-hawiyati]/idp/saml2/metadata et importez-les dans le FS. Les métadonnées incluent l'Identifiant d'entité du FI, le point de terminaison SSO et le certificat de signature.
4
Configurer la correspondance des attributs
Dans l'onglet Attributs du FS, définissez les attributs utilisateur à inclure dans l'assertion SAML. Attributs courants : uid (nom d'utilisateur), email, givenName, sn, groups.
5
Affecter une politique d'authentification
Sous l'onglet Politique d'authentification du FS, affectez une politique. Les FS sans politique affectée autorisent toutes les connexions sans AMF.
✓
Tester l'intégration
Utilisez la démo du FS SAML sur le port 8090 ou initiez une connexion depuis votre FS. Vérifiez que l'assertion est acceptée et que les valeurs des attributs sont correctes.

Ajout d'un client OIDC

ChampObligatoireNotes
Identifiant clientAuto-généré ou personnaliséIdentifiant unique du client OIDC. Utilisé dans le paramètre client_id.
Secret clientAuto-généréAffiché une seule fois à la création. Utilisé uniquement pour les clients confidentiels (applications côté serveur). Les clients publics utilisent PKCE à la place.
URI de redirectionObligatoire ; une ou plusieursCorrespondance exacte uniquement. Les URI avec caractères génériques ne sont pas pris en charge. Incluez tous les environnements (dev, recette, prod) séparément.
Types d'autorisationObligatoireauthorization_code (avec PKCE) est le seul type d'autorisation pris en charge pour les nouvelles intégrations. refresh_token est disponible lorsqu'il est activé.
PortéesFacultatifPar défaut : openid profile email. Des portées supplémentaires peuvent être ajoutées par application.
Durée de vie du jetonFacultatifTTL du jeton d'accès (défaut : 300s), TTL du jeton d'identité (défaut : 3600s), TTL du jeton de rafraîchissement (si activé).

Après création du client OIDC, configurez le FS pour utiliser le document de découverte OIDC à l'adresse : https://[hôte-hawiyati]/.well-known/openid-configuration


Politiques d'authentification

Les politiques contrôlent ce qui se passe lorsqu'un utilisateur se connecte à un fournisseur de services. Chaque politique contient une liste ordonnée de règles. Le FI évalue les règles de haut en bas et applique la première règle dont toutes les conditions correspondent (sémantique de première correspondance, comme un ensemble de règles pare-feu). Si aucune règle ne correspond, l'action par défaut est Autoriser.

Anatomie d'une règle

Chaque règle répond à quatre questions :

DimensionOptionsNotes
Qui (groupe) Tout le monde ou Membres d'un groupe spécifique Toutes les conditions d'une règle sont appliquées avec un ET logique. Pour une logique OU (Groupe A ou Groupe B), créez deux règles séparées au même niveau de priorité.
Où (zone réseau) N'importe où ou Depuis une zone réseau nommée (liste CIDR) Créez des zones réseau dans Administration → Zones réseau ou directement depuis l'éditeur de règles.
Quand (plage horaire) À tout moment ou Durant une plage horaire configurée (jours + plage HH:mm) L'heure est évaluée par rapport au fuseau horaire local du serveur. Documentez-le dans les descriptions de politiques si le fuseau horaire du serveur diffère de celui des utilisateurs.
Action Autoriser / Exiger l'AMF / Refuser Lorsque l'option Exiger l'AMF est sélectionnée, restreignez optionnellement à des méthodes spécifiques : TOTP, FIDO2, EMAIL_OTP, SMS_OTP. Laissez non coché pour accepter toute méthode inscrite.

Flux d'évaluation des politiques

1
Arrivée de la demande de connexion
Un utilisateur initie une connexion à un FS SAML ou un client OIDC. Le FS est recherché et sa politique affectée est chargée depuis le cache (sauvegardé Redis, TTL ~10s).
2
Évaluation des règles par ordre de priorité
Les règles sont itérées du numéro de priorité le plus bas au plus élevé. Pour chaque règle : vérification de la condition de groupe → vérification de la condition de zone réseau → vérification de la condition temporelle. Les trois doivent correspondre pour que la règle s'applique.
3
La première correspondance l'emporte
La première règle dont toutes les conditions correspondent applique son action : Autoriser, Exiger l'AMF ou Refuser. Aucune autre règle n'est évaluée. Ceci est identique à la sémantique de première correspondance pare-feu.
4
Dérogation du moteur de risque (si activé)
Le moteur de risque adaptatif s'exécute en parallèle. Si l'action de risque est plus restrictive que l'action de politique, l'action de risque l'emporte. Ordre de sévérité : AUTORISER < AMF_QUELCONQUE < AMF_FORTE < REFUSER.
✓
Action finale appliquée
La plus restrictive de l'action de politique et de l'action de risque est appliquée. L'utilisateur voit un flux d'authentification unique et cohérent.

Modèles de politiques courants

Exiger l'AMF pour tous les utilisateurs

Règle 1 (tout le monde) : Tous / N'importe où / À tout moment → Exiger AMF

Contournement réseau bureau — AMF uniquement depuis l'extérieur

Règle 1 (priorité 1) : Tous / Depuis la zone "Réseau bureau" / À tout moment → Autoriser Règle 2 (priorité 2) : Tous / N'importe où / À tout moment → Exiger AMF

AMF forte pour le groupe privilégié, AMF quelconque pour les autres

Règle 1 (priorité 1) : Membres de "Utilisateurs privilégiés" / N'importe où / À tout moment → Exiger AMF (TOTP, FIDO2) Règle 2 (priorité 2) : Tous / N'importe où / À tout moment → Exiger AMF

Accès réservé aux heures ouvrables

Règle 1 (priorité 1) : Tous / N'importe où / Lun–Ven 08h00–18h00 → Autoriser Règle 2 (priorité 2) : Tous / N'importe où / À tout moment → Refuser
⚠
L'ordre des règles est important

Une règle Autoriser tout en tête de liste court-circuitera chaque règle en dessous. Placez toujours les règles plus spécifiques (limitées à un groupe, une zone, une plage horaire) avant les règles attrape-tout.

⚠
Conditions de groupe orphelines

La suppression d'un groupe référencé par une condition de politique ne met pas automatiquement à jour la politique. La condition ne correspond silencieusement jamais. Après la suppression d'un groupe, examinez toutes les politiques qui le référençaient et supprimez ou mettez à jour les règles concernées.

Affectation d'une politique à un FS

Naviguez vers Administration → Applications → [application] → Politique d'authentification → Affecter. Sélectionnez la politique et enregistrez. Chaque FS peut avoir au maximum une politique. Pour supprimer une politique sans en affecter une autre, sélectionnez « Aucune politique (autoriser tout) ». Les modifications prennent effet immédiatement via l'invalidation du cache Redis.


Zones réseau

Les zones réseau sont des ensembles nommés de plages CIDR IPv4 utilisés dans les conditions des politiques d'authentification. Naviguez vers Administration → Zones réseau pour gérer les zones indépendamment, ou créez des zones directement depuis l'éditeur de règles de politique.

ChampDescription
NomUnique dans toutes les zones. Utilisé dans les conditions des règles de politique.
DescriptionFacultatif. Documentez l'objectif — ex., « Réseau bureau siège social 192.168.1.0/24 ».
Plages CIDRUn ou plusieurs blocs CIDR IPv4. Une adresse IP cliente doit correspondre à n'importe quel CIDR de la zone. Une liste CIDR vide signifie que la zone ne correspond jamais.

Les modifications de zone (ajout/suppression de CIDR, renommage) prennent effet immédiatement via l'invalidation Redis — aucun redémarrage de service n'est requis. L'ajout ou la suppression de CIDR d'une zone se propage instantanément à toutes les politiques qui référencent cette zone.


Moteur de risque

Le moteur de risque adaptatif évalue chaque tentative d'authentification par rapport à des signaux comportementaux et contextuels. En fonction du score de risque résultant, il peut laisser la décision de politique inchangée, exiger une AMF plus forte, ou bloquer complètement l'accès — automatiquement, à chaque connexion, en parallèle de l'évaluation de politique.

Modes de fonctionnement

Définissez le mode dans Administration → Risque → Paramètres → Mode.

ModeComportementQuand l'utiliser
DÉSACTIVÉ L'évaluation des risques est entièrement ignorée. Aucun signal évalué. Aucune surcharge. Configuration initiale, dépannage, ou lorsque le moteur de risque n'est pas nécessaire.
SURVEILLANCE Les signaux sont évalués et les évaluations enregistrées, mais l'action de risque ne remplace jamais l'action de politique. Utilisez ce mode pour mesurer l'impact de l'application sans affecter les utilisateurs. Ajustement en pré-production. Exécutez pendant plusieurs jours de trafic réel et examinez le tableau de bord.
APPLICATION L'action de risque remplace l'action de politique lorsqu'elle est plus restrictive. Mode de fonctionnement en production. Après ajustement en mode SURVEILLANCE et confirmation de taux de faux positifs acceptables.
✓
Déploiement recommandé

Commencez en mode SURVEILLANCE, examinez le tableau de bord pendant plusieurs jours de trafic réel, ajustez les seuils et les pondérations, puis passez en mode APPLICATION. Les faux positifs en mode SURVEILLANCE sont visibles sans impact sur les utilisateurs.

Pipeline d'évaluation des risques

1
Arrivée de la demande de connexion
L'évaluation de politique et l'évaluation des risques s'exécutent en parallèle pour chaque tentative de connexion.
2
Évaluation des signaux activés
Chaque signal activé évalue la demande et contribue 0 à 30 points. Les points de tous les signaux sont additionnés et plafonnés à 100.
3
Conversion du score en niveau de risque
Le score total est converti en FAIBLE / MOYEN / ÉLEVÉ / CRITIQUE à l'aide de seuils configurables. Les signaux peuvent également définir une dérogation de niveau minimum qui force le niveau indépendamment du score numérique.
4
Détermination de l'action de risque
Chaque niveau de risque correspond à une action de risque : FAIBLE→AUTORISER, MOYEN→AMF_QUELCONQUE, ÉLEVÉ→AMF_FORTE, CRITIQUE→REFUSER (valeurs par défaut, configurables).
5
La plus restrictive de politique et risque l'emporte
Ordre de sévérité : AUTORISER < AMF_QUELCONQUE < AMF_FORTE < REFUSER. La plus restrictive de l'action de politique et de l'action de risque est appliquée. L'utilisateur voit un flux d'authentification unique.

Signaux de risque

NOUVEAU_DISPOSITIF

Détecte les connexions depuis un navigateur/dispositif non reconnu. Hawiyati émet un cookie hwd_id (UUID, durée de vie 400 jours) à chaque navigateur. À chaque connexion, le cookie est vérifié par rapport à la liste des dispositifs connus de l'utilisateur.

FacteurContribution au risque
KNOWN_DEVICE0 point — aucun risque supplémentaire
NEW_DEVICEMOYEN — dispositif non reconnu pour un utilisateur ayant au moins un dispositif connu enregistré
DEVICE_TRUST_EXPIREDMOYEN — le dispositif était approuvé mais la fenêtre d'approbation a expiré
REVOKED_DEVICE_SEENÉLEVÉ — un dispositif révoqué par un administrateur est réapparu

Référence de première connexion : la toute première connexion d'un utilisateur ne déclenche pas de signal NOUVEAU_DISPOSITIF. Les connexions suivantes depuis un navigateur différent le déclenchent.

VÉLOCITÉ_GÉO

Détecte les connexions depuis des emplacements physiquement impossibles. Nécessite un fichier de base de données GeoIP2 au format MaxMind (sous licence séparée ; chemin configuré dans Administration → Risque → Paramètres → Base de données GeoIP).

FacteurContribution au risque
GEO_OK0 point
NEW_COUNTRYMOYEN — connexion depuis un pays depuis lequel l'utilisateur ne s'est jamais authentifié
IMPOSSIBLE_TRAVELÉLEVÉ + dérogation de niveau minimum ÉLEVÉ — vitesse de déplacement implicite dépassant le maximum configuré (défaut : 900 km/h ≈ vitesse d'avion de ligne)

VÉLOCITÉ_CONNEXION

Détecte les attaques par force brute et par bourrage d'identifiants en comptant les connexions échouées récentes dans une fenêtre temporelle glissante (défaut : 15 minutes).

FacteurSeuil (défaut)Risque
USER_FAILED_HIGH≥ 5 connexions échouées par nom d'utilisateur dans la fenêtreMOYEN-ÉLEVÉ
IP_FAILED_HIGH≥ 10 connexions échouées par IP dans la fenêtreMOYEN-ÉLEVÉ
IP_MANY_USERS≥ 5 noms d'utilisateur distincts tentés par IP dans la fenêtreÉLEVÉ — indicateur de bourrage d'identifiants

RÉPUTATION_IP

Vérifie l'IP cliente par rapport à une liste de blocage maintenue par l'administrateur. Naviguez vers Administration → Risque → Réputation IP pour importer des listes de blocage CIDR. Hawiyati ne contient pas de données préchargées.

FacteurDescription
KNOWN_MALICIOUS_IPIP figurant sur une liste de blocage de renseignements sur les menaces
CREDENTIAL_STUFFING_IPIP associée à des campagnes de bourrage d'identifiants
TOR_EXITNœud de sortie Tor
ANON_PROXYProxy anonyme ou VPN couramment utilisé pour masquer l'origine
DATACENTERPlage IP de centre de données ou fournisseur cloud

Modes de défaillance des signaux

Mode de défaillanceEn cas d'erreurQuand l'utiliser
OUVERT (défaut) Signal ignoré — ne contribue aucun point. L'évaluation continue avec les autres signaux. Signaux où la disponibilité prime sur la sécurité conservative (ex. VÉLOCITÉ_GÉO lorsque la base de données GeoIP peut être indisponible)
FERMÉ Le signal impose une dérogation de niveau minimum ÉLEVÉ — l'accès nécessite une AMF FIDO2 ou supérieure jusqu'à résolution de l'erreur. Signaux critiques pour la sécurité où une erreur de base de données doit être traitée comme suspecte (ex. RÉPUTATION_IP)

Actions par niveau de risque (défauts)

Niveau de risqueAction par défautExpérience utilisateur
FAIBLEAUTORISERAucune modification du flux de connexion normal
MOYENAMF_QUELCONQUEInvitation à fournir tout second facteur inscrit
ÉLEVÉAMF_FORTEInvitation spécifique à utiliser une clé de sécurité FIDO2 ou une clé d'accès
CRITIQUEREFUSERConnexion bloquée — « Accès refusé : niveau de risque trop élevé »

Modifiez les valeurs par défaut dans Administration → Risque → Actions par niveau.


Journaux d'audit

Hawiyati enregistre un événement d'audit structuré pour chaque action pertinente sur le plan de la sécurité — tentatives d'authentification, modifications de configuration, mutations d'utilisateurs et de groupes, émission de jetons et activité des administrateurs. Naviguez vers Administration → Journal d'audit pour rechercher et exporter les événements.

Filtres de recherche

FiltreComportement
CatégorieCorrespondance exacte. L'une de : authentication, configuration, iam, process, token, federation, access.
ActionCorrespondance exacte avec le code d'action (ex. authentication.login.success).
ActeurCorrespondance partielle (insensible à la casse) avec le nom d'utilisateur de l'acteur.
RésultatCorrespondance exacte : success, failure ou unknown.
De / ÀPlage horaire inclusive. Format ISO 8601 ou sélecteur de date.
RechercheRecherche en texte libre dans les champs message et resourceId de l'événement.
ℹ
Les requêtes d'audit sont elles-mêmes auditées

Chaque recherche effectuée par un administrateur est journalisée comme un événement audit.query dans la catégorie access. Chaque export est journalisé comme audit.export. La piste d'audit ne peut pas être consultée discrètement — toute consultation laisse une trace.

Structure d'un événement — champs toujours présents

ChampTypeDescription
@timestampISO 8601Moment de l'événement (UTC)
servicechaîneModule qui a émis l'événement (ex. hawiyati-http-server)
categorychaîneCode de catégorie de haut niveau
actionchaîneCode d'action spécifique (ex. authentication.login.success)
outcomechaînesuccess, failure ou unknown
severitychaîneINFO pour succès/inconnu ; WARN pour échec. Défini automatiquement — ne peut pas être remplacé.
actorchaîneNom d'utilisateur de la personne ou du système ayant effectué l'action
messagechaîneRésumé lisible par l'humain de l'événement

Export

Naviguez vers Administration → Journal d'audit → Exporter. Deux formats :

FormatCas d'usageColonnes / structure
CSV Analyse en tableur dans Excel ou Google Sheets 11 colonnes : event_time, source_service, category, action, outcome, severity, actor_username, source_ip, resource_type, resource_id, message. Protégé contre l'injection de formules (les valeurs commençant par =, +, -, @ sont préfixées d'une tabulation).
JSON Pipeline de journaux, ingestion SIEM, analyse programmatique Chaque ligne est un objet événement complet (NDJSON). Les clés de détails sensibles sont automatiquement masquées par "***".

Taille maximale d'export : 50 000 lignes (configurable via hawiyati.audit.export.max-rows). Pour des historiques plus importants, réduisez la fenêtre temporelle et effectuez des exports par lots.

Destinations des événements

DestinationDéfautDescription
Journal JSON structuréToujours actifÉcrit dans le journal applicatif sous forme NDJSON sur le logger audit. Ne peut pas être désactivé. Routez via Logback vers un fichier dédié pour l'ingestion par un collecteur de journaux.
Base de données (JPA asynchrone)ActivéPersisté dans la table PostgreSQL audit_events. Alimente l'interface de recherche dans la console. Écrivain par micro-lots asynchrones : 100 événements/flush, intervalle de 1s, capacité de file de 10 000 événements.
Syslog CEFDésactivéCommon Event Format pour l'ingestion SIEM (Splunk, QRadar, ArcSight). Activez avec hawiyati.audit.cef.enabled: true.

Rétention

Les événements ne peuvent pas être supprimés tant qu'ils n'ont pas au moins 30 jours (configurable via hawiyati.audit.retention.min-days). Une tâche en arrière-plan supprime les événements antérieurs au plancher de rétention selon un calendrier. Définissez retention.enabled: false pour accumuler indéfiniment.


Provisionnement SCIM 2.0

Séquence de provisionnement et réconciliation SCIM
Le provisionnement SCIM crée des comptes pré-approuvés et réconcilie les identités avec les sources d'annuaire.

SCIM (System for Cross-domain Identity Management) permet aux systèmes externes — plateformes RH, outils de gouvernance des identités, agents de synchronisation AD — de créer, mettre à jour et désactiver des utilisateurs dans Hawiyati automatiquement via l'API SCIM 2.0 sur le port 8098.

Activation de SCIM

1
Générer un jeton SCIM
Naviguez vers Administration → Référentiels d'utilisateurs → Jetons SCIM → Générer un jeton. Le jeton en clair est affiché une seule fois — copiez-le immédiatement. Seul le hachage SHA-256 est stocké.
2
Configurer votre source de provisionnement
Configurez votre système de provisionnement pour envoyer des requêtes à https://[hôte-hawiyati]:8098/scim/v2/ avec l'en-tête Authorization: Bearer <jeton>.
✓
Vérifier le provisionnement
Testez en provisionnant un seul utilisateur et vérifiez qu'il apparaît dans la liste Administration → Utilisateurs avec source_type = SCIM. Consultez Administration → Journal d'audit pour les événements end_user.create avec l'acteur system.

Points de terminaison API SCIM

MéthodeCheminOpération
GET/scim/v2/UsersLister les utilisateurs (paginé, filtrable)
POST/scim/v2/UsersCréer un utilisateur
GET/scim/v2/Users/{id}Obtenir un utilisateur par identifiant
PUT/scim/v2/Users/{id}Remplacer un utilisateur (mise à jour complète)
PATCH/scim/v2/Users/{id}Mettre à jour un utilisateur (partiel)
DELETE/scim/v2/Users/{id}Supprimer un utilisateur
GET/scim/v2/ServiceProviderConfigDécouverte
GET/scim/v2/SchemasDécouverte de schéma
⚠
Groupes non pris en charge

GET /scim/v2/Groups retourne HTTP 501 Non implémenté. Le provisionnement des groupes est prévu dans la feuille de route. Pour l'instant, gérez les appartenances aux groupes via la console d'administration ou des appels API directs après le provisionnement des utilisateurs SCIM.

Correspondance des attributs SCIM

Attribut SCIMChamp HawiyatiNotes
userNameusernameObligatoire, unique
emails[0].valueemailObligatoire
name.givenNamefirst_name
name.familyNamelast_name
phoneNumbers[0].valuephone_numberFormat E.164 requis
preferredLanguagelocale
activeactiveDéfinir à false pour désactiver le compte
urn:...externalIdexternal_idChamp d'extension SCIM Hawiyati uniquement
⚠
Périmètre de l'extension SCIM

L'extension SCIM Hawiyati comprend uniquement : externalId, sourceInstanceId, pendingApproval. Les champs d'identifiants, de niveau d'assurance et d'AMF sont explicitement exclus du schéma SCIM — ces données sont gérées via l'interface d'administration propre à Hawiyati ou les flux de libre-service des utilisateurs, jamais via SCIM.

Sécurité des jetons

Les jetons SCIM sont validés par comparaison de hachage SHA-256 — le jeton en clair n'est jamais stocké. Un jeton invalide ou révoqué retourne HTTP 401. Renouvelez les jetons périodiquement : générez un nouveau jeton, mettez à jour la source de provisionnement, vérifiez que le provisionnement fonctionne, puis révoquez l'ancien jeton. Les jetons SCIM n'expirent pas automatiquement.


Paramètres & Personnalisation

Naviguez vers Administration → Paramètres pour la configuration globale du système. Seuls les comptes SUPER_ADMIN peuvent modifier les paramètres.

Paramètres de session

ParamètreDéfautDescription
TTL de session8 heuresDurée de validité d'une session Hawiyati sans activité utilisateur.
Délai d'expiration absolu24 heuresDurée maximale de session indépendamment de l'activité.
Période de grâce AMF0Durée pendant laquelle une étape AMF réussie est mémorisée (évite une nouvelle invite AMF dans la même session). 0 = AMF redemandée à chaque accès au FS.
Limite de sessions simultanéesillimitéesNombre maximal de sessions actives simultanées par utilisateur. Les sessions les plus anciennes sont résiliées lorsque la limite est atteinte.

Politique de mot de passe

ParamètreDéfautDescription
Longueur minimale8Nombre minimal de caractères du mot de passe.
Exiger une majusculefalseAu moins une lettre majuscule requise.
Exiger un chiffrefalseAu moins un chiffre requis.
Exiger un caractère spécialfalseAu moins un caractère non alphanumérique requis.
Historique des mots de passe0Nombre d'anciens mots de passe qui ne peuvent pas être réutilisés. 0 = pas de contrôle d'historique.
Seuil de verrouillage10Tentatives de connexion consécutives échouées avant verrouillage du compte.
Durée de verrouillage30 minutesDurée pendant laquelle le compte reste verrouillé après dépassement du seuil. 0 = verrouillé jusqu'au déverrouillage par l'administrateur.

Passerelle de notification (SMTP & SMS)

Groupe de paramètresChamps
SMTP Hôte, port, mode TLS (STARTTLS / SSL), nom d'utilisateur, mot de passe, adresse d'expédition, nom d'affichage de l'expéditeur
Passerelle SMS URL du point de terminaison HTTP, méthode HTTP (POST/GET), en-tête d'authentification, modèle du corps de requête, motif de succès de la réponse

Testez les deux passerelles avant de les utiliser pour la livraison d'OTP AMF — utilisez la fonctionnalité d'envoi de test intégrée après configuration.

Connecteur LDAP / Active Directory

ChampDescription
URL LDAPURL du serveur ldap:// ou ldaps://
DN de liaisonDN du compte de service que Hawiyati utilise pour interroger l'annuaire
Mot de passe de liaisonMot de passe du compte de service — stocké chiffré
Base de recherche des utilisateursDN sous lequel rechercher les objets utilisateur
Filtre de recherche des utilisateursFiltre LDAP pour les objets utilisateur (ex. (objectClass=person))
Attribut de nom d'utilisateurAttribut LDAP mappé au nom d'utilisateur Hawiyati (ex. sAMAccountName ou uid)
Base de recherche des groupesDN sous lequel rechercher les objets de groupe
Attribut de membres du groupeAttribut LDAP des groupes listant les DN membres (ex. member)
Intervalle de synchronisationFréquence à laquelle Hawiyati synchronise l'annuaire LDAP (défaut : 15 minutes)

Annuaire d'identités SQL externe

Hawiyati peut authentifier les utilisateurs directement depuis une base de données relationnelle appartenant au client (PostgreSQL, MySQL ou Microsoft SQL Server) sans migrer la table des utilisateurs. Lors de la première connexion réussie, Hawiyati crée automatiquement un enregistrement fantôme léger qui conserve le profil et les appartenances aux groupes — le mot de passe reste toujours dans la base de données externe.

Connexion et mappage de table

ChampDescription
NomLibellé lisible par l'humain pour cet annuaire (affiché dans la console d'administration)
Type de base de donnéesPOSTGRES, MYSQL ou MSSQL
URL JDBCChaîne de connexion JDBC complète, ex. jdbc:postgresql://db.example.org:5432/myapp
Utilisateur DBIdentifiant de connexion à la base de données que Hawiyati utilise pour les requêtes en lecture seule
Mot de passe DBStocké chiffré AES-256 dans la base de configuration de Hawiyati
Table des utilisateursTable ou vue contenant les enregistrements utilisateurs (défaut : users)
Colonne nom d'utilisateurColonne contenant le nom de connexion (défaut : username)
Colonne mot de passeColonne contenant le hachage du mot de passe stocké (défaut : password_hash)
Colonne e-mailColonne mappée à l'adresse e-mail de l'utilisateur (défaut : email)
Colonne prénomOptionnel — mappé au prénom de l'utilisateur
Colonne nom de familleOptionnel — mappé au nom de famille de l'utilisateur
Colonne activeColonne booléenne optionnelle ; si présente, une valeur false bloque la connexion
Clause WHEREFiltre supplémentaire optionnel ajouté à chaque requête, ex. deleted_at IS NULL

Algorithme de hachage des mots de passe

AlgorithmeQuand l'utiliser
BCRYPTPar défaut. Compatible avec les hachages produits par bcrypt (tout facteur de coût $2a, $2b, $2y).
ARGON2Hachages Argon2id (valeurs par défaut Spring Security v5.8).
PBKDF2Hachages PBKDF2WithHmacSHA256.
SHA256Condensé hexadécimal SHA-256 simple. Migrez vers bcrypt dès que possible.

Activation

Configurez et testez l'annuaire en premier (bouton Tester la connexion), puis cliquez sur Activer. Hawiyati achemine immédiatement toutes les nouvelles tentatives de connexion via la base de données externe. Pour annuler, cliquez sur Désactiver — l'annuaire actif revient à Local et les utilisateurs fantômes existants conservent leurs profils.

Les points d'entrée API d'activation sont : POST /api/v1/sql-stores/{id}/activate et POST /api/v1/sql-stores/{id}/deactivate.

Synchronisation des utilisateurs

La synchronisation planifiée optionnelle (bouton Synchroniser les utilisateurs ou cron) importe toutes les lignes de la table externe et pré-crée les enregistrements fantômes. Cela n'est pas requis pour que la connexion fonctionne, mais permet aux administrateurs de rechercher, d'assigner à des groupes et de préprovisionner les utilisateurs avant leur première connexion.

Personnalisation

ParamètreDescription
Nom de l'organisationAffiché dans l'en-tête de la page de connexion, les modèles d'e-mails et les pages de consentement
LogoImporter un SVG ou PNG (max 200 Ko). Affiché sur la page de connexion et le portail de compte.
Couleur principaleCode couleur hexadécimal appliqué aux boutons et accents de liens sur les pages orientées utilisateurs
Titre de la page de connexionTexte personnalisé affiché au-dessus du formulaire de connexion (prend en charge le texte brut ; le HTML est échappé)
Contact d'assistanceE-mail ou URL affiché sur les pages d'erreur et la section d'aide du portail de compte
URL de politique de confidentialitéLien sur la page d'auto-inscription et les écrans de consentement

Référence des événements d'audit

Chaque opération génère un événement d'audit visible dans Administration → Journal d'audit. Principaux événements par catégorie :

Événements d'authentification

Code d'actionRésultatDéclencheur
authentication.login.successsuccessUtilisateur authentifié avec succès
authentication.login.failurefailureAuthentification échouée (mauvais identifiant, OTP invalide, refus de politique, etc.)
authentication.logoutsuccessUtilisateur déconnecté (SLO initié par le FI ou le FS)
authentication.mfa.totp.successsuccessSecond facteur TOTP réussi
authentication.mfa.totp.failurefailureCode TOTP invalide ou expiré
authentication.mfa.fido2.successsuccessAssertion FIDO2/WebAuthn réussie
authentication.mfa.fido2.failurefailureAssertion FIDO2 échouée
authentication.session.expiredunknownTTL de session dépassé sans déconnexion explicite

Événements IAM (utilisateurs & groupes)

Code d'actionDéclencheur
end_user.createUn administrateur crée un utilisateur
end_user.saveUn administrateur modifie un profil utilisateur ou son statut
end_user.reset_passwordUn administrateur réinitialise un mot de passe
end_user.reset_totpUn administrateur supprime l'inscription TOTP
end_user.enroll_totpUn administrateur finalise l'inscription TOTP au nom de l'utilisateur
end_user.delete_fido2Un administrateur supprime tous les identifiants FIDO2
end_user.approveUn administrateur approuve une auto-inscription en attente
end_user.rejectUn administrateur rejette une auto-inscription en attente
end_user.deleteUn administrateur supprime un compte utilisateur
user_group.createUn administrateur crée un groupe
user_group.add_memberUn administrateur ajoute un utilisateur à un groupe
user_group.remove_memberUn administrateur supprime un utilisateur d'un groupe
user_group.deleteUn administrateur supprime un groupe
kyc.approveUn administrateur approuve une soumission de document KYC
kyc.rejectUn administrateur rejette une soumission de document KYC

Événements de politique & configuration

Code d'actionDéclencheur
auth_policy.createUn administrateur crée une nouvelle politique
auth_policy.save_rulesUn administrateur enregistre la liste de règles (remplacement complet)
auth_policy.deleteUn administrateur supprime une politique
auth_policy.assign_spUn administrateur affecte une politique à un fournisseur de services
auth_policy.unassign_spUn administrateur supprime une politique d'un fournisseur de services
network_zone.createUn administrateur crée une zone réseau
network_zone.updateUn administrateur modifie une zone
network_zone.deleteUn administrateur supprime une zone réseau
risk.settings.mode.updateMode du moteur de risque modifié
risk.reputation.importListe de blocage de réputation IP importée
risk.device.revokeUn administrateur a révoqué un dispositif connu

Bonnes pratiques

✓
Utilisez des groupes, pas des exceptions par utilisateur

Les politiques d'authentification opèrent sur des groupes. Affectez les utilisateurs à des groupes nommés (« Utilisateurs privilégiés », « Prestataires », « Télétravail ») et rédigez les politiques en fonction de ces groupes. Évitez les politiques qui référencent des noms d'utilisateur spécifiques — elles sont fragiles, difficiles à auditer et ne passent pas à l'échelle.

✓
Auditez les réinitialisations AMF

Les réinitialisations de mot de passe et TOTP sont des opérations à privilèges élevés. Une réinitialisation malveillante ou erronée peut abaisser le niveau de sécurité d'un utilisateur. Examinez périodiquement le journal d'audit pour les événements end_user.reset_password et end_user.reset_totp et vérifiez qu'ils étaient intentionnels.

✓
Suspendez plutôt que de supprimer en cas de doute

La suppression retire tous les liens d'audit associés à ce nom d'utilisateur depuis l'enregistrement utilisateur. S'il est possible que vous ayez besoin de l'historique du compte pour un examen de conformité, suspendez le compte d'abord et ne supprimez que lorsque les exigences de rétention sont confirmées.

✓
Renouvelez les jetons SCIM périodiquement

Générez un nouveau jeton, mettez à jour la source de provisionnement, vérifiez que le provisionnement fonctionne, puis révoquez l'ancien jeton. Les jetons SCIM n'expirent pas automatiquement — configurez un rappel de calendrier pour les renouveler trimestriellement.

✓
Testez les changements de politique sur un FS de démonstration d'abord

Affectez la politique au FS SAML de démonstration (port 8090) ou au FS OIDC de démonstration (port 8092) et effectuez une connexion de test avant d'appliquer la politique aux applications de production. Une règle Refuser attrape-tout mal configurée bloquera immédiatement tous les utilisateurs du FS.

✓
Utilisez le mode SURVEILLANCE avant d'appliquer les contrôles de risque

Exécutez le moteur de risque en mode SURVEILLANCE pendant au moins une semaine de trafic de production réel avant de passer en mode APPLICATION. Le tableau de bord indique exactement combien de défis supplémentaires auraient été émis — ajustez jusqu'à ce que le taux de faux positifs soit acceptable.

✓
Actualisez régulièrement les listes de blocage IP

Les données de réputation IP vieillissent rapidement. Utilisez la fonctionnalité d'expiration et une cadence d'importation régulière (hebdomadaire avec Remplacement) pour maintenir les données à jour. Des données de liste de blocage périmées sont moins nocives qu'aucune donnée — les entrées expirées cessent automatiquement de correspondre.

HawiyatiDocumentation · v2026 · Spring Boot 3.5