Guide de diagnostic
Les dix erreurs de configuration les plus courantes, leurs symptômes, causes et corrections.
Note de confidentialité : Aucun contenu d’assertion SAML, cookie de session ni attribut personnel ne doit figurer dans les sorties de diagnostic ou les journaux serveur.
1. Entity ID SP ou IdP incorrect
Symptôme : L’IdP affiche une page d’erreur après la redirection du SP vers l’URL SSO. Message Hawiyati : « Fournisseur de services inconnu » ou « SP non enregistré ».
Cause : L’entity-id configuré dans le SDK ne correspond pas à l’entity ID enregistré dans la console d’administration Hawiyati.
Correction : Vérifiez que les deux valeurs sont identiques octet pour octet (les entity IDs sont des URI sensibles à la casse).
Entrée de journal : SamlValidationException: Issuer does not match trusted IdP entity ID
2. Incompatibilité du certificat de signature
Symptôme : Le callback ACS renvoie HTTP 403 — « Validation de signature échouée ». Le flux SSO se termine correctement côté IdP mais échoue côté SP.
Correction : Téléchargez le certificat de signature actuel de l’IdP depuis Admin → IdP → Certificats → Télécharger PEM et remplacez le fichier référencé dans votre configuration.
3. Décalage horaire supérieur à la tolérance
Symptôme : L’authentification échoue avec « Assertion expirée » ou « Assertion pas encore valide ».
Correction : Synchronisez les deux serveurs avec NTP. En solution temporaire uniquement, augmentez clock-skew-seconds jusqu’à 300.
7. Échec de connexion au store Redis
Symptôme : Le démarrage du SP échoue avec « Cannot connect to Redis » ou l’authentification échoue de manière intermittente.
Correction : Vérifiez que Redis est accessible (redis-cli ping) et que les paramètres de connexion sont corrects. N’utilisez jamais les stores en mémoire dans un cluster multi-instances.