irma/simplesamlphp-module-authirma

Simplesamlphp module for IRMA authentication.

simplesamlphp-module-authirma

SimplesamlPHP module for IRMA authentication, _(*1)

Introduction

This module for simpleSAMLphp allows easy integration of IRMA authentication into an existing simpleSAMLphp setup. This document explains how to install the simpleSAMLphp module and how to configure it., _(*2)

We are going to assume you have a working simpleSAMLphp installation. If you don't, refer to the documentation of simpleSAMLphp itself., _(*3)

Installing the module and required libraries

Install using composer

To install in simplesamlphp, use the composer-based simplesamlphp module installer, _(*4)

composer require irma/simplesamlphp-module-authirma

Manual install

Download the latest version of the simpleSAMLphp IRMA module., _(*5)

Install the module in the modules/ directory of your simpleSAMLphp setup (or symlink it if you want to keep the directory structure clean). The module is enabled by default: no need for a 'touch enable' inside the module directory., _(*6)

Note that authirma depends on php-jwt for encoding and decoding JSON Web Tokens (JWT). Install using composer:, _(*7)

composer require firebase/php-jwt

Configuration

See docs /docs/authirma.md for configuration instructions., _(*8)

Quickstart

Install simplesamlphp, _(*9)

git clone https://github.com/simplesamlphp/simplesamlphp.git
cd simplesamlphp/

Install the IRMA authentication module, _(*10)

composer require irma/simplesamlphp-module-authirma

Copy sample configuration files, _(*11)

cp config-templates/config.php config-templates/authsources.php config 

Edit config/config.php to change the following:, _(*12)

'baseurlpath' => '',

Edit config/authsources.php and add an authentication source named irma of type authirma:IRMA. See docs/authirma., _(*13)

Create a directory for storing certificates and keys:, _(*14)

mkdir -p cert

Put the private key for signing JWT requests and the certificate with the public key of the API server in the cert directory., _(*15)

Start a PHP web server:, _(*16)

php -S 0:8080 -t www 

Point your browser to http://localhost:8080/, _(*17)