H· Hawiyati Documentation

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érequisVersion minimale
PHP8.2
Extensionsopenssl, dom, libxml
Hawiyati IdP2.0
Accès réseauSP → 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éStatutComportement de repli
SAML Single Logout (SLO)DifféréDestruction de session locale uniquement
Connexion initiée par l’IdPDifféréUniquement SP-initié
Assertions chiffréesDifféréSeules les assertions signées acceptées
Négociation du contexte d’authentificationDifféréAucun élément RequestedAuthnContext
Fédération multi-IdP par SPDifféréUn seul TrustedIdp par instance