vpn-documentation/PHP_SAML_SP.md -rw-r--r-- 3.8 KiB
f2cdea6bFrançois Kooman remove Fedora 33 from the list of supported distros a day ago

#title: PHP-SAML-SP description: SAML Authentication using php-saml-sp category: authentication


Very simple, secure SAML SP written in PHP.


This application was written to be (a lot) simpler to use and configure than simpleSAMLphp and only work as a SAML SP supporting only secure cryptographic algorithms, see the project site for more information.


It is easy to install and enable php-saml-sp.


$ sudo yum -y install php-saml-sp
$ sudo systemctl restart httpd


$ sudo dnf -y install php-saml-sp
$ sudo systemctl restart httpd


$ sudo apt -y install php-saml-sp
$ sudo a2enconf php-saml-sp
$ sudo systemctl restart apache2

#Configuring the SP

See /etc/php-saml-sp/config.php.

The metadata URL is https://vpn.example.org/php-saml-sp/metadata. The entityID is the same (by default). You can override this by setting entityId to a value of your choice, e.g. https://vpn.example.org/saml to be vendor neutral in case you want to switch later. Choosing something stable here is important when you use for example eduPersonTargetedID as that identifier is typically bound to the SP entityID.

Copy the IdP(s) metadata to /etc/php-saml-sp/metadata. Make sure the metadata files have the .xml extension and are valid XML.

Make sure you at least configure idpList in /etc/php-saml-sp/config.php with the list of IdPs that have access to this SP. If you don't do this, all IdPs found in the metadata will be allowed access.

To test your SP/IdP configuration, go to https://vpn.example.org/php-saml-sp/ and use the "Test" button.

#Configuring the VPN Service

The configuration is done through /etc/vpn-user-portal/config.php.

Set the authMethod option:

'authMethod' => 'PhpSamlSpAuthentication',

Now the PhpSamlSpAuthentication specific options can be set as well:

'PhpSamlSpAuthentication' => [
    'userIdAttribute' => 'eduPersonTargetedID',
    //'userIdAttribute' => 'eduPersonPrincipalName',
    //'userIdAttribute' => 'uid',

    //'permissionAttribute' => [
    //      'eduPersonEntitlement',
    //      //'eduPersonAffiliation',

    // AuthnContext required for *all* users
    //'authnContext' => ['urn:oasis:names:tc:SAML:2.0:ac:classes:TimesyncToken'],

    // Users with certain permissions obtained through
    // "permissionAttribute" MUST also have ANY of the listed
    // AuthnContexts. If they currently don't, a new authentication is
    // triggered to obtain it
    // **NOTE**: DO NOT USE ON NEW INSTALLATIONS! (see below)
    //'permissionAuthnContext' => [
    //    'http://eduvpn.org/role/admin' => ['urn:oasis:names:tc:SAML:2.0:ac:classes:TimesyncToken'],


The authnContext will request the specified AuthnContext of the IdP, this is to trigger for example MFA/2FA. It integrates with SURFsecureID as well. Setting authnContext means this context will be required for ALL users.

#AuthnContext for Permissions

NOTE: use of this option is DEPRECATED! It will be removed in the next (major) version of eduVPN/Let's Connect!

The permissionAuthnContext is a mapping between "permission" and required authnContext. This can be used to e.g. force MFA/2FA only for a subset of users that have the specified attribute values as obtained through the permissionAttribute. Indirectly this can be used to restrict certain VPN profiles to uses that have a certain "permission" and at the same time enforce MFA/2FA for those users. Note that an AuthnContext is bound to a user, not a VPN profile.