H· Hawiyati Documentation
Documentation Hawiyati

Premiers pas

Tout ce qu'il vous faut pour comprendre, évaluer et déployer Hawiyati — des premiers concepts à votre première intégration opérationnelle.

Documentation Hawiyati

Tout ce qu'il vous faut pour comprendre, évaluer et déployer Hawiyati — des premiers concepts à votre première intégration opérationnelle.

🏛️ Qu'est-ce qu'Hawiyati ?

Hawiyati (هويتي — « Mon identité » en arabe) est une plateforme de gestion des identités et des accès (IAM/CIAM) sur site, conçue pour les organisations qui exigent une souveraineté totale sur leur infrastructure d'identité.

Hawiyati IAM Platform — Component Architecture HAWIYATI IAM PLATFORM — COMPONENT ARCHITECTURE Spring Boot 3.5 · Java 25 · gRPC EXTERNAL ACTORS ENTRY LAYER & FEDERATION HTTPS · SAML 2.0 · OIDC · WebAuthn PLATFORM SERVICES HTTPS internal · gRPC DATA & INFRASTRUCTURE JDBC · Redis pub/sub · gRPC User Browser Browser · Mobile App Administrator Admin Console SAML Service Provider SAML 2.0 OIDC Relying Party OIDC · OAuth 2.0 SCIM Client HR System · Directory hawiyati-gateway Spring Cloud Gateway · :8080 Routing · TLS termination hawiyati-http-server IdP Login · MFA · FIDO2 · :8085 SAML ACS · OIDC callback · Account BFF hawiyati-federation SAML 2.0 · OIDC · :8087 Assertion & token issuance · Policy hawiyati-admin Admin Console · :8095 · WebFlux hawiyati-account Account Portal · :8096 · BFF/OIDC hawiyati-scim SCIM 2.0 API · :8098 hawiyati-session · :9004 hawiyati-cache · :9003 hawiyati-infra · :9002 PostgreSQL hawiyati · hawiyati_identity Redis / Valkey Sessions · Cache · Rate limits Audit & Logs CEF Syslog · OTel · SIEM PKI & Keystore SAML · OIDC · mkcert TLS External Actor External System Entry / Federation Platform Service gRPC Service Data Store

Les sections ci-dessous couvrent la prise en main d'Hawiyati. Pour une cartographie complète des modules avec les ports, les frontières gRPC et la topologie de déploiement, consultez le Guide d'implémentation.

Hawiyati s'exécute entièrement dans le réseau du client et fournit une authentification de niveau entreprise, une fédération d'applications, une authentification multi-facteurs (AMF), la gestion du cycle de vie des utilisateurs, des politiques d'accès adaptatives et une journalisation d'audit de qualité conformité — sans dépendance envers un service cloud externe, sans comportement de rappel à domicile et sans flux de données sortants.

Principe fondamental Les données d'identité appartiennent à l'organisation qui les détient. Hawiyati l'impose par l'architecture, non par la politique — aucun appel API sortant au moment de l'exécution, aucune télémétrie et aucune ressource hébergée sur un CDN.

Fondements techniques

CoucheTechnologieVersion
Framework applicatifSpring Boot / Spring Cloud Northfields3.5.5 / 2025.0.1
Environnement d'exécutionJava (OpenJDK ou GraalVM)25
Système de buildMaven monorepo3.8+
Base de données principalePostgreSQL16+ recommandé
Magasin de sessions / cacheRedis ou Valkey7+ compatible
Protocole inter-servicesgRPC (mTLS mutuel en production)—
Migration de schémaFlyway (embarqué)—

Architecture en bref

Hawiyati est une plateforme de microservices. Tous les services sont des JARs Spring Boot autonomes. Le trafic navigateur entre par une passerelle et est routé vers des services spécialisés. La communication interne utilise gRPC.

Browser / SP Application
    │
    ▼
hawiyati-gateway (8080)   — Spring Cloud Gateway (routage uniquement)
    │
    ├──▶ hawiyati-http-server (8085)  — Flux de connexion IdP, SAML ACS, points de terminaison OIDC
    ├──▶ hawiyati-federation  (8087)  — Découverte OIDC, émission de jetons
    ├──▶ hawiyati-account     (8096)  — Portail en libre-service pour les utilisateurs finaux
    ├──▶ hawiyati-admin       (8095)  — Console d'administration (WebFlux + Thymeleaf)
    └──▶ hawiyati-scim        (8098)  — API de provisionnement entrant SCIM 2.0

Services gRPC internes :
    ├── hawiyati-infra    — Registre des FdS, service de configuration
    ├── hawiyati-cache    — Façade de cache Redis
    └── hawiyati-session  — Gestionnaire du cycle de vie des sessions

Bibliothèques partagées :
    ├── hawiyati-persistence       — JPA PostgreSQL, Flyway, chiffrement
    ├── hawiyati-audit             — Journal d'audit structuré (CEF/syslog + OTel)
    ├── hawiyati-saml-federation   — Implémentation SAML 2.0 personnalisée
    └── hawiyati-openid-federation — Implémentation OIDC personnalisée

⚡ Différenciateurs clés

Qu'est-ce qui distingue Hawiyati des plateformes d'identité hébergées dans le cloud (Okta, Entra ID, Ping Cloud) ?

  • 🏗️
    Souveraineté totale sur site
    Les événements d'authentification ne quittent jamais le réseau du client. Aucun appel API sortant au moment de l'exécution, aucun relais cloud et aucune connectivité internet requise pendant le fonctionnement.
  • 🔐
    Pile SAML 2.0 et OIDC personnalisée
    Hawiyati implémente ses propres protocoles de fédération plutôt que de dépendre d'OpenSAML ou de Nimbus. Cela permet un contrôle direct sur les opérations cryptographiques, le mappage d'attributs et les extensions de protocole sans les contraintes des bibliothèques tierces.
  • 🌍
    Support de la localisation arabe dès la conception
    La console d'administration, le portail utilisateur et l'interface de connexion prennent en charge l'arabe RTL (police Alexandria, formatage des dates et des nombres selon les paramètres régionaux). Conçu spécifiquement pour les organisations des marchés arabophones.
  • 📋
    Alignement NIST SP 800-63
    Les niveaux d'assurance L0–L4 correspondent directement aux exigences IAL/AAL. Les flux KYC, l'application des politiques AMF et le stockage des justificatifs sont conçus pour satisfaire les directives NIST pour les déploiements réglementés.
  • 🔒
    Les justificatifs ne quittent jamais le serveur en clair
    Les mots de passe sont hachés avec Argon2id. Les secrets TOTP sont chiffrés au repos. Les codes de secours sont affichés une seule fois et stockés sous forme de hachages. FIDO2 ne stocke que la clé publique. Aucune donnée sensible n'est jamais journalisée.
  • 📦
    Zéro dépendance externe à l'exécution
    Les polices, icônes et ressources de l'interface sont servies localement. Les données de géolocalisation sont chargées depuis une base de données intégrée. La vérification des bots échoue fermé — aucun repli CDN qui pourrait exposer des événements d'authentification.

👥 À qui s'adresse-t-il ?

Publics cibles principaux

PublicComment Hawiyati aide
Organismes gouvernementaux Déploiement souverain sans flux de données externes. Prise en charge des interfaces en arabe. Respect des exigences locales de résidence des données. Alignement NIST 800-63 pour les niveaux d'assurance.
Établissements financiers Piste d'audit de qualité conformité, application de l'AMF, accès adaptatif par zone réseau et score de risque, intégration LDAP/AD, flux de révision des documents KYC.
Organisations de santé Contrôle d'accès basé sur les rôles, gestion des sessions, suivi du consentement, journaux d'audit exportables pour les revues réglementaires, application du niveau d'assurance par application.
Équipes IT d'entreprise SSO centralisé pour toutes les applications SAML 2.0 et OIDC, provisionnement SCIM, gestion complète du cycle de vie des utilisateurs, intégration d'annuaire LDAP/AD.
Équipes d'opérations sécurité Signaux de risque en temps réel, surveillance des activités de connexion, suivi des appareils, événements d'audit structurés compatibles avec l'ingestion SIEM (CEF/syslog), métriques Prometheus.

Quatre personas utilisateurs principaux

👤
Utilisateur final
S'authentifie via le portail de connexion, gère ses facteurs AMF et ses appareils, et accède aux applications fédérées. Interagit avec le portail de libre-service.
🛠️
Opérateur administrateur
Gère les utilisateurs, les groupes, les applications et les politiques d'authentification via la console d'administration. Répond aux incidents de sécurité, examine les journaux d'audit et configure les paramètres de risque.
💻
Développeur FdS
Intègre des applications avec Hawiyati via SAML 2.0 ou OIDC. Configure l'enregistrement des FdS, teste les flux de connexion et mappe les attributs/portées pour son application.
🔐
Responsable sécurité
Définit les politiques d'authentification, configure les seuils de risque, examine les rapports d'audit de conformité et valide les exigences de niveau d'assurance pour les applications réglementées.

📖 Terminologie clé

Termes tels qu'utilisés dans Hawiyati spécifiquement — non des définitions génériques de manuel. Regroupés par domaine pour une référence rapide.

Identité et authentification

TermeDéfinition
Fournisseur d'identité (FdI) Le système qui authentifie les utilisateurs et atteste leur identité auprès d'autres systèmes. Dans un déploiement Hawiyati, Hawiyati lui-même est le FdI. Il possède la page de connexion, évalue les justificatifs, applique l'AMF et émet des jetons de fédération (assertions SAML ou jetons OIDC).
Fournisseur de services (FdS) Une application qui s'appuie sur le FdI pour l'authentification. Le FdS ne voit jamais le mot de passe de l'utilisateur — il reçoit uniquement une assertion signée d'Hawiyati confirmant qui est l'utilisateur et quels attributs il porte. Exemples : un ERP interne, un portail web ou un outil SaaS configuré pour utiliser SAML ou OIDC.
Principal L'entité authentifiée effectuant une requête. Dans la plupart des cas, il s'agit d'un utilisateur final. Dans Hawiyati, le principal est identifié par un UUID interne stable — jamais par un attribut modifiable comme le nom d'utilisateur ou l'adresse e-mail.
Justificatif d'identité Tout secret ou possession utilisé pour prouver l'identité. Hawiyati prend en charge : les mots de passe (hachage Argon2id), les secrets TOTP (chiffrés au repos), les clés publiques FIDO2, les codes OTP (éphémères) et les codes de secours (hachés, affichés une fois). Les justificatifs ne sont jamais journalisés.
Session Un enregistrement côté serveur du contexte d'un utilisateur authentifié stocké dans Redis. Suit : l'heure d'authentification, les méthodes AMF utilisées, le niveau de risque, l'adresse IP, l'empreinte de l'appareil et l'expiration. Un utilisateur peut avoir plusieurs sessions simultanées depuis différents appareils.
Jeton de session Un identifiant opaque émis vers le navigateur sous forme de cookie HttpOnly, Secure, SameSite=Strict qui correspond à une session côté serveur. Jamais intégré dans des URL ou des réponses API.
Authentification renforcée (Step-Up) Un défi d'authentification supplémentaire requis en cours de session pour accéder à une ressource sensible. Par exemple : ré-authentification avant la suppression d'un appareil AMF, ou confirmation d'un mot de passe avant le téléchargement de données personnelles.
Niveau d'assurance (L0–L4) Le niveau de vérification d'identité attribué à un utilisateur, aligné sur l'IAL NIST SP 800-63A-4. L0 = aucune vérification ; L1 = basique ; L2 = KYC standard ; L3 = KYC renforcé + selfie/liveness ; L4 = KYC élevé + révision humaine. Source de vérité : kyc_profiles.current_level.
KYC (Connaissance du client) Un flux d'inscription facultatif où les utilisateurs téléchargent des documents d'identité pour révision. La complétion peut être requise avant que l'accès soit accordé à des applications spécifiques. Élève le niveau d'assurance de l'utilisateur lors de l'approbation.
Jeton de continuation Un jeton de courte durée qui stocke le FK sp_entity_id pour une connexion fédérée en cours. Prévient les attaques de redirection ouverte en ne stockant jamais l'URL d'initiation SP brute.
Jeton de complétion Un jeton aléatoire de 256 bits (stocké sous HMAC-SHA256, TTL 15 minutes, usage unique) émis après un flux de migration ou de réclamation pour restreindre la route qu'un utilisateur peut emprunter avant de terminer complètement l'inscription.

Authentification multi-facteurs (AMF)

TermeDéfinition
Préférence AMF Le second facteur par défaut configuré de chaque utilisateur. Valeurs : PWD_ONLY, PWD_THEN_TOTP, PWD_THEN_OTP, FIDO2. Peut être remplacé par une politique.
TOTP Mot de passe à usage unique basé sur le temps (RFC 6238). Code à six chiffres généré par une application d'authentification (Google Authenticator, Authy), valide 30 secondes. Secret chiffré au repos ; protection contre la relecture appliquée — le même code ne peut pas être accepté deux fois.
FIDO2 / WebAuthn / Passkey Authentification par clé publique basée sur la biométrie de l'appareil ou des clés de sécurité matérielles. La clé privée de l'utilisateur ne quitte jamais son appareil. Hawiyati ne stocke que la clé publique. « Passkey » et « justificatif FIDO2 » sont utilisés de façon interchangeable.
OTP par e-mail Un code à usage unique délivré à l'adresse e-mail de l'utilisateur. TTL de 5 minutes ; limité en débit par adresse. Nécessite que la livraison de courrier sortant soit configurée.
OTP par SMS Un code à usage unique délivré via une passerelle SMS HTTP (configurable). La limitation du débit par MSISDN s'applique. Nécessite une intégration de fournisseur SMS configurée.
Code de secours Un code de sauvegarde à usage unique généré lorsqu'un utilisateur s'inscrit à l'AMF. Affiché à l'utilisateur exactement une fois, stocké sous hachage Argon2id. Invalidé définitivement après utilisation. Permet la récupération du compte lorsque l'appareil AMF principal est perdu.

Protocoles

TermeDéfinition
SAML 2.0 Standard de fédération basé sur XML. Hawiyati agit comme FdI SAML. Les FdS envoient un AuthnRequest ; Hawiyati retourne une Response signée contenant une Assertion avec l'identité et les attributs de l'utilisateur. Hawiyati implémente sa propre pile SAML — pas OpenSAML.
Assertion Une déclaration signée d'un FdI concernant un utilisateur. En SAML : un élément XML <Assertion>. En OIDC : un jeton d'identité (JWT signé). Les deux attestent qui est l'utilisateur, quand il s'est authentifié, quelles méthodes AMF ont été utilisées et quels attributs il porte.
URL ACS URL du service consommateur d'assertion — le point de terminaison sur le FdS où Hawiyati publie la réponse SAML après l'authentification. Doit utiliser HTTPS en production.
Entity ID L'identifiant unique global d'un fournisseur de services SAML. Typiquement une URL mais n'a pas besoin d'être accessible. Doit correspondre exactement entre les métadonnées du FdS et l'enregistrement du FdS dans Hawiyati.
Relay State Une chaîne opaque que le FdS inclut dans l'AuthnRequest SAML pour pouvoir restaurer l'état (par exemple, la page initialement demandée) après la complétion de l'authentification. Hawiyati transmet le Relay State tout au long du flux sans le modifier.
SLO (Déconnexion unique) Une déconnexion coordonnée qui termine la session au FdI et envoie des notifications de déconnexion à tous les FdS participants. Hawiyati prend en charge le SLO front-canal ; le back-canal est partiel — validez par partie de confiance avant de vous y fier.
OIDC (OpenID Connect) Une couche d'identité JSON/REST au-dessus d'OAuth 2.0. Hawiyati agit comme fournisseur OIDC. Les applications utilisent le flux Authorization Code + PKCE pour obtenir des jetons d'identité et des jetons d'accès. Document de découverte à /.well-known/openid-configuration.
PKCE Proof Key for Code Exchange (RFC 7636). Prévient l'interception du code d'autorisation. Le client génère un code_verifier aléatoire, le hache en code_challenge, l'envoie avec la requête d'authentification. Le serveur exige le vérificateur au point de terminaison du jeton. Requis pour tous les clients OIDC publics.
Nonce Une valeur aléatoire incluse dans une requête d'autorisation OIDC et intégrée dans le jeton d'identité. Le client vérifie le nonce pour prévenir la relecture du jeton. Hawiyati applique la liaison de nonce pour tous les flux OIDC.
SCIM 2.0 System for Cross-domain Identity Management — une API REST standard pour le provisionnement des utilisateurs. Hawiyati expose un point de terminaison SCIM 2.0 Users pour le provisionnement entrant uniquement (le provisionnement sortant est dans la feuille de route).

Politiques et accès adaptatif

TermeDéfinition
Politique d'authentification Un ensemble de règles ordonné attaché à un fournisseur de services qui détermine quelles étapes d'authentification sont requises. Les règles s'évaluent en premier correspondant. Les conditions peuvent combiner : appartenance au groupe, zone réseau, heure de la journée, score de risque et nouveauté de l'appareil.
Score de risque Une valeur numérique (0–100) calculée par tentative d'authentification à partir de signaux : nouveauté de l'appareil (NEW_DEVICE), vélocité de connexion (VELOCITY), anomalie géographique (GEOIP) et réputation IP (IP_REPUTATION). Correspond aux niveaux : LOW / MEDIUM / HIGH / CRITICAL.
Mode d'application L'action quand une condition de politique correspond : ALLOW (continuer), MFA_REQUIRED (authentification renforcée), DENY (bloquer). Ordre de sévérité : ALLOW < MFA_ANY < MFA_STRONG < DENY — le plus strict entre politique et risque l'emporte.
Zone réseau Une plage IP nommée (bloc CIDR) utilisée dans les conditions de politique. Exemple : « VPN d'entreprise » = 10.0.0.0/8. Permet d'avoir des exigences différentes pour les connexions depuis le réseau d'entreprise et depuis l'extérieur.
Accès adaptatif Ajustement dynamique des exigences d'authentification basé sur les signaux de risque en temps réel. Lorsqu'un risque élevé est détecté, le moteur peut exiger une authentification renforcée ou bloquer l'accès sans modification de règle de politique.

Applications (Fournisseurs de services)

TermeDéfinition
Enregistrement FdS Configuration d'un fournisseur de services dans le registre d'Hawiyati. SAML : entity ID, URL ACS, format du name ID, mappage d'attributs, certificat de signature, paramètres de chiffrement. OIDC : client ID, secret client (ou mode public), URI de redirection, portées autorisées, types d'octroi.
URI de redirection L'URL où Hawiyati envoie le code d'autorisation après l'authentification OIDC. Correspondance exacte appliquée — les jokers ne sont pas autorisés.
Portée (Scope) Paramètre d'autorisation OIDC contrôlant quelles revendications sont incluses dans le jeton d'identité. Hawiyati prend en charge les portées standard (openid, profile, email) et les mappages d'attributs personnalisés.

Administration et audit

TermeDéfinition
Console d'administration L'interface administrative web pour les opérateurs de la plateforme (port 8095). Utilisée pour gérer : les utilisateurs et les groupes, les applications, les politiques d'authentification, les paramètres de risque, les jetons SCIM, l'image de marque et les paramètres système. L'accès est contrôlé par rôle via RBAC.
Portail de compte L'application web en libre-service pour les utilisateurs finaux (port 8096). Permet aux utilisateurs de : consulter et modifier leur profil, changer de mot de passe, gérer les méthodes AMF, examiner les appareils, lister et révoquer les sessions, consulter le journal d'activité et gérer les consentements de confidentialité.
Événement d'audit Un enregistrement structuré d'une action significative de la plateforme. Inclut toujours : @timestamp, service, category, action, outcome, severity, actor, message. Stocké dans PostgreSQL ; optionnellement transféré vers syslog/SIEM.
RBAC Contrôle d'accès basé sur les rôles — le mécanisme contrôlant ce que les utilisateurs de la console d'administration peuvent voir et faire. Les rôles administrateur déterminent quelles sections de la console sont accessibles et quelles opérations peuvent être effectuées.
Jeton SCIM Un jeton API bearer utilisé pour authentifier les clients de provisionnement SCIM. Émis depuis la console d'administration ; le texte en clair est affiché une seule fois lors de la génération (seul le hachage est stocké). Peut être révoqué à tout moment.

Termes de déploiement

TermeDéfinition
Distribution (dist/) Le répertoire d'exécution créé par deploy.bat contenant : les JARs compilés de tous les services, les fichiers de configuration, les certificats TLS, les répertoires de logs et les fichiers PID. Les services sont démarrés/arrêtés via dist\start.bat et dist\stop.bat.
gRPC Le protocole de communication inter-services utilisé entre les microservices Hawiyati. Les services exposent des points de terminaison gRPC pour les appels internes (recherche de session, lectures du registre FdS, opérations de cache). Sécurisé avec mTLS mutuel en production.
Flyway L'outil de migration de schéma de base de données embarqué dans hawiyati-persistence. Au démarrage, applique les scripts de migration SQL en attente pour mettre le schéma PostgreSQL à jour. V62 est la migration tête actuelle.
Redis / Valkey Le magasin de données en mémoire utilisé uniquement pour l'état de session et les compteurs de limitation du débit. Compatible avec Redis 7+ et Valkey 7+. Aucune donnée d'identité persistante n'est stockée ici — peut être vidé et redémarré sans perte de données.
Magasin d'utilisateurs La source de vérité pour les identités utilisateurs. Types : LOCAL (base de données Hawiyati), LDAP (liaison + synchronisation Active Directory), SCIM (provisionnement entrant), SQL (pont en lecture seule). Un seul type est actif à la fois.

🚀 Guide de démarrage rapide

Démarrez Hawiyati localement pour le développement, les tests de fumée ou l'évaluation en moins d'une heure.

Prérequis

  • ✓
    Java 25 (OpenJDK ou GraalVM) — les versions antérieures ne sont pas prises en charge ; la pile utilise les fonctionnalités du langage Java 25 et les threads virtuels
  • ✓
    Maven 3.8+ — pour construire le monorepo
  • ✓
    PostgreSQL 16+ — créez une base de données et un utilisateur avant de démarrer la pile ; Flyway appliquera les migrations de schéma au premier démarrage
  • ✓
    Redis 7+ ou Valkey 7+ — utilisé pour l'état de session et la limitation du débit ; aucune persistance requise
  • ✓
    8 Go de RAM minimum — 16 Go recommandés lors de l'exécution de tous les services simultanément
  • ✓
    mkcert (facultatif mais recommandé) — pour les certificats HTTPS de développement approuvés localement ; la pile de développement nécessite TLS pour les flux SAML/OIDC
  • ✓
    Windows 11 ou Linux (RHEL 8+ / Ubuntu 22+) — Windows est l'environnement de développement principal ; Linux est la cible de production
Version Java La pile nécessite Java 25. La source quick-start.md indique Java 21+ mais la pile de production et tous les tests de production ciblent Java 25. Utilisez Java 25 pour éviter les problèmes de compatibilité.

Étapes d'installation

1

Construire le monorepo

Exécutez un build Maven complet pour compiler tous les modules et exécuter les tests unitaires. Comptez 3 à 5 minutes au premier lancement (téléchargement des dépendances).

mvn -B verify

Pour une vérification de compilation uniquement plus rapide (sans tests) :

mvn -q -DskipTests compile
Résultat attendu : BUILD SUCCESS pour les 16 modules.
2

Configurer HTTPS local (une seule fois)

Hawiyati nécessite HTTPS pour les flux SAML et OIDC. Le script de configuration TLS utilise mkcert pour générer des certificats approuvés localement pour les noms d'hôtes de développement.

deployment\setup-tls.bat

Ajoutez ensuite les noms d'hôtes de développement au fichier hosts Windows (C:\Windows\System32\drivers\etc\hosts) :

127.0.0.1  dev.hawiyati.org
127.0.0.1  admin.dev.hawiyati.org
127.0.0.1  account.dev.hawiyati.org
127.0.0.1  federation.dev.hawiyati.org
127.0.0.1  saml.spdemo.org
127.0.0.1  oidc.spdemo.org
Résultat attendu : Certificats TLS générés dans dist/certs/ ; aucun avertissement de certificat dans le navigateur pour les noms d'hôtes de développement.
3

Déployer et démarrer la pile

Le script de déploiement assemble le package de distribution, puis le script de démarrage lance tous les services.

deploy.bat
dist\start.bat

Pour démarrer un seul service (pour le développement ou le débogage) :

dist\start.bat hawiyati-admin

Vérifiez que tous les services sont en cours d'exécution :

dist\status.bat
Résultat attendu : Tous les services affichent le statut RUNNING ; migrations Flyway appliquées au premier démarrage.
4

Se connecter à la console d'administration

Ouvrez la console d'administration dans votre navigateur. Les identifiants par défaut sont définis dans le fichier de configuration initial — changez-les immédiatement après la première connexion.

https://admin.dev.hawiyati.org:8095

Depuis la console d'administration, vous pouvez : créer des utilisateurs, enregistrer des fournisseurs de services, configurer des politiques d'authentification et consulter le journal d'audit.

Résultat attendu : La console d'administration se charge avec le tableau de bord Hawiyati affichant 0 utilisateur et 0 application.
5

Enregistrer votre première application FdS

Naviguez vers Applications → Ajouter une application. Choisissez SAML 2.0 ou OIDC selon votre type d'intégration. La démo SAML SP et la démo OIDC SP sont pré-enregistrées en mode développement pour les tests.

Pour SAML : fournissez l'Entity ID et l'URL ACS des métadonnées de votre FdS. Pour OIDC : fournissez l'URI de redirection et sélectionnez les portées dont votre application a besoin.

Résultat attendu : L'application apparaît dans la liste des applications avec le statut Actif.
6

Créer votre premier utilisateur et tester une connexion

Naviguez vers Utilisateurs → Ajouter un utilisateur. Saisissez les champs requis (nom d'utilisateur, e-mail, téléphone au format E.164). Un mot de passe temporaire est défini lors de la sauvegarde.

Ouvrez ensuite la démo SAML SP dans un onglet de navigateur séparé et tentez une connexion :

https://saml.spdemo.org:8090

Ou la démo OIDC SP :

https://oidc.spdemo.org:8092
Résultat attendu : Redirection réussie vers la page de connexion Hawiyati → identifiants acceptés → redirection vers la démo SP avec les informations utilisateur affichées.

URL locales principales

ComposantURLPort
Passerelle / Point d'entréehttps://dev.hawiyati.org:80808080
Connexion IdP / SAML ACS / OIDChttps://dev.hawiyati.org:80858085
Découverte OIDC / fédérationhttps://federation.dev.hawiyati.org:80878087
Console d'administrationhttps://admin.dev.hawiyati.org:80958095
Portail de compte (libre-service)https://account.dev.hawiyati.org:80968096
Démo SAML SPhttps://saml.spdemo.org:80908090
Démo OIDC SPhttps://oidc.spdemo.org:80928092
API de provisionnement SCIMhttp://localhost:8098/scim/v28098
Client de test SCIMhttp://localhost:80998099

Problèmes courants au premier démarrage

Approbation des certificats SAML et OIDC nécessitent tous deux un HTTPS valide. Si vous ignorez setup-tls.bat ou n'ajoutez pas les noms d'hôtes de développement à votre fichier hosts, les navigateurs bloqueront la redirection de connexion. mkcert doit être exécuté en tant qu'administrateur pour installer l'autorité de certification locale.
Incompatibilité de somme de contrôle Flyway V1 Si vous avez une base de données de développement existante, Flyway peut signaler une incompatibilité de somme de contrôle sur V1. Consultez docs/SESSION_STATE.md pour la somme de contrôle exacte et la commande de réparation (flyway repair).
Politique de mot de passe La politique de mot de passe par défaut requiert au minimum : 10 caractères, au moins une majuscule, un chiffre et un caractère spécial. Les utilisateurs créés par l'administrateur avec des mots de passe temporaires doivent les changer à la première connexion.
Format de numéro de téléphone Les numéros de téléphone des utilisateurs doivent être au format E.164 (par exemple, +213555123456). La console d'administration valide cela — la saisie d'un format local entraînera une erreur de validation.
gRPC en mode développement Les connexions gRPC internes sont en clair (pas de mTLS mutuel) dans le profil de développement. N'exposez pas les ports gRPC internes à l'extérieur. Le mTLS mutuel est requis pour tous les déploiements en production.

🗓️ Parcours d'évaluation

Un calendrier structuré pour les organisations qui évaluent Hawiyati pour un déploiement en production. Chaque phase s'appuie sur la précédente pour donner une image réaliste de la plateforme dans des conditions réelles.

Jour 1

Installer et explorer

  • Compléter l'installation du démarrage rapide
  • Se connecter à la console d'administration et explorer le tableau de bord
  • Créer 3 à 5 utilisateurs de test avec différentes configurations de justificatifs
  • Tester une connexion réussie via la démo SAML SP
  • Tester une connexion réussie via la démo OIDC SP
  • Examiner le journal d'audit pour voir les événements de vos connexions de test
Semaine 1

Intégrer une vraie application FdS

  • Enregistrer votre premier FdS de production (SAML ou OIDC)
  • Mapper les attributs/revendications pour correspondre aux exigences de votre FdS
  • Inscrire des utilisateurs de test avec TOTP AMF
  • Configurer une politique d'authentification de base (exiger l'AMF pour toutes les connexions)
  • Tester les flux SAML initié par FdS et initié par FdI
  • Tester le flux OIDC Authorization Code + PKCE de bout en bout
Semaine 2

Configurer les politiques, tester l'AMF, examiner l'audit

  • Configurer les zones réseau (plage IP d'entreprise vs. externe)
  • Créer une deuxième politique d'authentification : exiger l'AMF hors de la zone d'entreprise
  • Tester l'inscription et la connexion FIDO2/passkey (nécessite un appareil avec biométrie ou une clé matérielle)
  • Tester le moteur de risque adaptatif : se connecter depuis un nouvel appareil et observer la réponse au risque MEDIUM/HIGH
  • Exporter les journaux d'audit au format CSV pour révision par votre équipe de conformité
  • Configurer le provisionnement SCIM depuis un système RH de test ou un simulateur LDAP
Semaine 3

Test de charge, durcissement, planification de la production

  • Exécuter des tests de charge contre le point de terminaison de connexion (recommandé : 100+ sessions simultanées)
  • Examiner le guide de durcissement de la sécurité et appliquer les recommandations
  • Tester la révocation de session, le verrouillage de compte et la réinitialisation forcée de mot de passe par l'administrateur
  • Planifier le déploiement en production (infrastructure, HA, sauvegarde, gestion des secrets)
  • Compléter la liste de contrôle d'évaluation ci-dessous
  • Contacter l'équipe Hawiyati pour une revue de préparation à la production

Liste de contrôle d'évaluation

  • La connexion SAML 2.0 initiée par FdS réussit avec un vrai FdS configuré
  • Le flux OIDC Authorization Code + PKCE réussit de bout en bout
  • L'inscription et la connexion TOTP AMF testées avec Google Authenticator ou Authy
  • L'inscription et la connexion passkey FIDO2 testées (le cas échéant)
  • Politique d'authentification testée : mot de passe seul sur IP d'entreprise, AMF requis sur IP externe
  • Moteur de risque testé : un nouvel appareil déclenche la réponse au risque MEDIUM
  • Verrouillage de compte testé : les tentatives de connexion échouées déclenchent le seuil de verrouillage
  • Révocation de session testée : l'administrateur révoque une session et l'utilisateur est déconnecté
  • Provisionnement SCIM testé : l'utilisateur créé via SCIM apparaît dans la console d'administration
  • Journal d'audit exporté au format CSV et examiné pour son exhaustivité
  • Test de charge complété : aucune erreur sous 100 sessions de connexion simultanées
  • Liste de contrôle de durcissement de la sécurité examinée et lacunes documentées

Critères de préparation à la production

Avant de déployer Hawiyati dans un environnement de production, vérifiez tout ce qui suit :

Pas encore prêt pour la production (durcissement requis) Les éléments suivants sont fonctionnels mais nécessitent un travail supplémentaire avant la production :
  • mTLS gRPC mutuel entre les services internes (actuellement gRPC en clair en développement)
  • Intégration de gestion des secrets (HashiCorp Vault ou équivalent ; actuellement secrets dans les fichiers de configuration)
  • Pipeline de déploiement automatisé complet et automatisation des sauvegardes
  • Évaluation de sécurité formelle et tests de pénétration
  • Flux de verrouillage de connexion et de récupération de compte (fonctionnels, nécessitent une validation par pen-test)
CritèreExigenceStatut
TLS partoutTous les points de terminaison HTTP via HTTPS ; mTLS gRPC mutuel entre servicesPartiel
Gestion des secretsAucun secret dans les fichiers de configuration ; utiliser Vault ou équivalentFeuille de route
Automatisation des sauvegardesSauvegarde quotidienne automatisée de PostgreSQL avec procédure de restauration testéeFeuille de route
Tests de pénétrationÉvaluation formelle des vulnérabilités par une équipe de sécurité qualifiéeRequis
Fédération SSOSAML 2.0 et OIDC testés de bout en bout avec au moins un vrai FdSDisponible
Couverture AMFAu minimum TOTP déployé ; FIDO2 si une haute assurance est requiseDisponible
Journalisation d'auditJournal d'audit structuré configuré avec politique de rétention et transfert SIEMDisponible
RBAC administrateurLes opérateurs administrateurs ont des rôles appropriés ; aucun compte administrateur partagéDisponible

➡️ Pour aller plus loin

Maintenant qu'Hawiyati est opérationnel, explorez la documentation complète pour comprendre comment configurer, intégrer et sécuriser votre déploiement.

Besoin d'aide ? Pour des questions sur l'évaluation, les engagements de preuve de concept ou la planification du déploiement en production, contactez l'équipe Hawiyati via le canal de support de votre organisation. Incluez les détails de votre environnement (OS, version Java, version de la base de données) dans toute demande de support.
HawiyatiDocumentation · v2026 · Spring Boot 3.5