H· Hawiyati Documentation

Référence de configuration

Référence faisant autorité pour toutes les clés de configuration des trois implémentations du SDK. Pour les guides de mise en œuvre, consultez les guides d’intégration par plateforme.

1. Java/Spring Boot (hawiyati.saml.sp.*)

Préfixe de liaison : hawiyati.saml.sp — Source : SamlSpProperties.java

PropriétéTypeDéfautRequisDescription
entity-idString—OuiURI d’entity ID du SP. Doit correspondre à la valeur enregistrée dans Hawiyati.
acs-urlString—OuiURL du service de consommation d’assertions (ACS). Doit commencer par https://.
clock-skew-secondsint60NonTolérance de décalage horaire en secondes. Maximum : 300.
protected-pathsList<String>[]NonPréfixes de chemin URL à protéger. Vide = tous les chemins.
idp.entity-idString—OuiURI d’entity ID de l’IdP.
idp.sso-urlString—OuiURL SSO de l’IdP pour la liaison HTTP-Redirect.
idp.signing-cert-pathsList<String>[]OuiChemins vers les certificats X.509 PEM utilisés par l’IdP pour signer les assertions.

2. .NET/ASP.NET Core

PropriétéTypeDéfautDescription
ConfigSamlSpConfig(requis)Configuration SAML SP principale.
LocalAccountResolverILocalAccountResolver?nullHook optionnel après validation de l’assertion.
CorrelationCookieMaxAgeMinutesint15Durée de vie du cookie de corrélation en minutes.

3. PHP (constructeur SamlSpConfig)

ParamètreTypeDéfautRequisDescription
entityIdstring—OuiURI d’entity ID du SP.
acsUrlstring—OuiURL ACS. Doit commencer par https://.
clockSkewSecondsint120NonTolérance de décalage horaire. Maximum : 300.
maxResponseBytesint524288NonTaille maximale de la réponse SAML en octets.

4. Notes de sécurité communes

  • Les certificats de signature IdP doivent être stockés en dehors des arborescences sources suivies par le SCM.
  • Les clés privées SP (optionnelles) ne doivent jamais apparaître en clair dans les fichiers de configuration.
  • Les URL ACS doivent commencer par https://. Le SDK rejette les configurations avec des URL ACS en http://.
  • Le décalage horaire ne doit pas dépasser 300 secondes. Une tolérance excessive affaiblit la protection contre la relecture.