Installation - DonutsNL/glpisaml GitHub Wiki

Prerequisites

GLPISAML has some prerequisites in order to function optimal. GLPISAML is written exclusively for GLPI10, PHP8 and later versions of both. Using earlier versions 'might' actually work, but we will not be able to help you with any issues. Simply put, if it breaks you are on your own. Anywayz, running older versions is a bad idea, so please dont and consider upgrading as soon as possible.

GLPISAML uses the openssl library to validate provided certificates. Openssl IS NOT a php module, but should be included in the PHP binairy at compile time. You can check its availability using phpinfo(); in a PHP script or # php -i | grep openssl. Search for something simular to: 'libSSH Version => libssh/0.10.5/openssl/zlib`

GLPI Marketplace

Installation should be as easy as clicking the GLPISAML plugin in the GLPI marketplace. Be aware there are multiple versions of the GLPI marketplace. Paying customers use a (whitelisted) GLPI validated marketplace where opensource users use an unvalidated generic marketplace. We will do our best to get and stay published on both marketplaces but we cant guarantee it.

Manual installation

If you cant use the marketplace for what ever reason, manual installation is also possible. For manual installation, download the latest published version (zipped) version from this repository and place its contents inside the GLPI_ROOT/marketplace/glpisaml directory. Make sure the webinstance has access to the created directory. If the files are placed correctly and are accessible by the webserver, the plugin should show up in the GLPI plugin page.

The plugin might work correctly inside the plugins directory but dont put it there. The plugin is coded and maintained in the marketplace directory and will certainly work.

image

After that open the GLPI instance, login as administrator, navigate to Setup => Plugins and 'click' the GLPI install button.

image

The plugin will report the installation process in the installation popup. If the installation was successfull the plugin configuration options should become available in the GLPI menu.

image

Advanced - IDP Templates

GLPISAML is shipped with a configuration template. If you prefer coded configuration you can alter the template in the PLUGIN_ROOT/src/Config/ConfigDefaultTpl.php file. In the future we consider providing multiple templates for multiple identity providers. The current template is focussed on Microsoft Entra. The template file is used with the add button in the IdP configuration.