Guide d’intégration PHP
Intégrez le SDK SAML2 SP Hawiyati avec vos applications PHP 8.2+. Couvre l’installation Composer, la configuration minimale, le PHP natif et l’adaptateur Laravel, le callback ACS, la déconnexion et l’enregistrement SP.
Limitation connue : PHP 8.2+ et Composer n’étaient pas installés dans l’environnement de développement lors de la v1.0.0. Exécutez
composer test avant tout passage en production.
1. Prérequis
| Prérequis | Version minimale |
|---|---|
| PHP | 8.2 |
| Extensions | openssl, dom, libxml |
| Hawiyati IdP | 2.0 |
| Accès réseau | SP → IdP sur le port 443 |
2. Ajout de la dépendance
composer require hawiyati/saml-sp:^1.0.0
3. Configuration minimale
<?php
declare(strict_types=1);
$trustedIdp = new TrustedIdp(
entityId: 'https://idp.hawiyati.org',
ssoUrl: 'https://idp.hawiyati.org/saml2/sso/redirect',
signingCertPem: file_get_contents(getenv('IDP_CERT_PATH'))
);
$config = new SamlSpConfig(
entityId: 'https://app.example.com/saml/metadata',
acsUrl: 'https://app.example.com/saml/acs',
trustedIdp: $trustedIdp,
pendingRequestStore: new RedisPendingRequestStore($redis),
replayStore: new RedisReplayStore($redis)
);
5. Traitement du callback ACS
La régénération de session doit avoir lieu avant l’écriture dans $_SESSION :
<?php
// acs.php
session_start();
$validator = new ResponseValidator($config);
$principal = $validator->validate(
samlResponse: $_POST['SAMLResponse'] ?? '',
pendingId: $_SESSION['saml_pending'] ?? ''
);
session_regenerate_id(true); // Obligatoire AVANT l'écriture
$_SESSION['saml_principal'] = $principal;
header('Location: ' . ($_POST['RelayState'] ?? '/'), true, 302);
exit;
10. Extensions différées (hors périmètre v1.0.0)
| Fonctionnalité | Statut | Comportement de repli |
|---|---|---|
| SAML Single Logout (SLO) | Différé | Destruction de session locale uniquement |
| Connexion initiée par l’IdP | Différé | Uniquement SP-initié |
| Assertions chiffrées | Différé | Seules les assertions signées acceptées |
| Négociation du contexte d’authentification | Différé | Aucun élément RequestedAuthnContext |
| Fédération multi-IdP par SP | Différé | Un seul TrustedIdp par instance |