H· Hawiyati Documentation

Guide des opérations

Sujets de déploiement en production : confiance TLS, proxies inverses, état partagé multi-instances, comportement au redémarrage, rotation de certificats, comportement lors d’une panne IdP et installation hors ligne.

1. Confiance envers une CA privée

Les déploiements Hawiyati IdP peuvent présenter des certificats TLS émis par une CA privée ou d’entreprise. L’application SP doit faire confiance à cette CA pour les connexions HTTPS sortantes.

# Java — ajout dans le trust store JVM
keytool -importcert -alias hawiyati-idp-ca -cacerts \
  -file /path/to/private-ca.crt -storepass changeit -noprompt

# Linux — niveau système
cp private-ca.crt /usr/local/share/ca-certificates/hawiyati-ca.crt
update-ca-certificates

2. En-têtes de proxy inverse

Lorsque le SP est derrière un proxy inverse, activez la confiance aux en-têtes de transfert pour que les URL ACS soient générées correctement.

# Java application.yml
server:
  forward-headers-strategy: framework

3. État partagé multi-instances

Les stores en mémoire ne sont pas partagés entre les instances de processus. Pour les déploiements multi-instances, utilisez les adaptateurs Redis :

# Java
hawiyati:
  saml:
    sp:
      redis:
        host: redis.internal
        port: 6379
        password: ${REDIS_PASSWORD}
        tls: true

5. Expiration et rotation des certificats

Lors de la rotation du certificat de signature de l’IdP :

  1. Téléchargez le nouveau certificat depuis Admin → IdP → Certificats → Télécharger PEM.
  2. Ajoutez le nouveau certificat à idp.signing-cert-paths en conservant l’ancien — le SDK accepte n’importe quel certificat de la liste. Cela permet une rotation sans interruption de service.
  3. Après expiration de l’ancien certificat, retirez-le de la liste.