H· Hawiyati Documentation

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.