simplesamlphp/simplesamlphp-module-autotest

This module provides an interface to do automatic testing of authentication sources.

v1.2.1 2023-01-10 17:10 UTC

Requires

• php: >=7.4 || ^8.0
• simplesamlphp/composer-module-installer: ^1.3.2
• simplesamlphp/simplesamlphp: ^2.0.0-rc2

Requires (Dev)

• simplesamlphp/simplesamlphp-test-framework: ~1.2.1

LGPL-2.1-or-later

• Andreas Åkre Solberg
• Olav Morken

• modules
• simplesamlphp

README

This module provides an interface to do automatic testing of authentication sources.

Installation

Once you have installed SimpleSAMLphp, installing this module is very simple. Just execute the following command in the root of your SimpleSAMLphp installation:

vendor/bin/composer require simplesamlphp/simplesamlphp-module-autotest:dev-master

where dev-master instructs Composer to install the master branch from the Git repository. See the releases available if you want to use a stable version of the module.

The module is disabled by default. If you want to enable the module once installed, you just have to add it to the module.enable array in your config.php.

Usage

This module provides three web pages:

• SIMPLESAMLPHP_ROOT/module.php/autotest/login
• SIMPLESAMLPHP_ROOT/module.php/autotest/logout
• SIMPLESAMLPHP_ROOT/module.php/autotest/attributes

All the web pages have a mandatory parameter 'SourceID', which is the name of the authentication source.

On success, the web pages print a single line with "OK". The attributes page will also list all the attributes of the user. On error they set the HTTP status code to 500 Internal Server Error, print a line with "ERROR" and then any information about the error.

Note: You still have to parse the login pages to extract the parameters in the login form.