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.
Développeurs · Actuel · 10 novembre 2026 · SDK 1.0.0
1. Java/Spring Boot (hawiyati.saml.sp.*)
Préfixe de liaison : hawiyati.saml.sp — Source : SamlSpProperties.java
Propriété
Type
Défaut
Requis
Description
entity-id
String
—
Oui
URI d’entity ID du SP. Doit correspondre à la valeur enregistrée dans Hawiyati.
acs-url
String
—
Oui
URL du service de consommation d’assertions (ACS). Doit commencer par https://.
clock-skew-seconds
int
60
Non
Tolérance de décalage horaire en secondes. Maximum : 300.
protected-paths
List<String>
[]
Non
Préfixes de chemin URL à protéger. Vide = tous les chemins.
idp.entity-id
String
—
Oui
URI d’entity ID de l’IdP.
idp.sso-url
String
—
Oui
URL SSO de l’IdP pour la liaison HTTP-Redirect.
idp.signing-cert-paths
List<String>
[]
Oui
Chemins vers les certificats X.509 PEM utilisés par l’IdP pour signer les assertions.
2. .NET/ASP.NET Core
Propriété
Type
Défaut
Description
Config
SamlSpConfig
(requis)
Configuration SAML SP principale.
LocalAccountResolver
ILocalAccountResolver?
null
Hook optionnel après validation de l’assertion.
CorrelationCookieMaxAgeMinutes
int
15
Durée de vie du cookie de corrélation en minutes.
3. PHP (constructeur SamlSpConfig)
Paramètre
Type
Défaut
Requis
Description
entityId
string
—
Oui
URI d’entity ID du SP.
acsUrl
string
—
Oui
URL ACS. Doit commencer par https://.
clockSkewSeconds
int
120
Non
Tolérance de décalage horaire. Maximum : 300.
maxResponseBytes
int
524288
Non
Taille 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.