MultiAuth module
The MultiAuth module provides a method for users to choosebetween a list of authentication sources. There is only one authentication module:
multiauth:MultiAuth- Authenticate the user against a list of authentication sources.
1 multiauth:MultiAuth
This module is useful when you want to let the users decide which
authentication source fits better their needs at any scenario. For
example, they can choose the saml authentication source in most
cases and then switch to the admin authentication source when
'saml' is down for some reason.
To create a MultiAuth authentication source, open
config/authsources.php in a text editor, and add an entry for the
authentication source:
'example-multi' => array(
'multiauth:MultiAuth',
/*
* The available authentication sources.
* They must be defined in this authsources.php file.
*/
'sources' => array('example-saml', 'example-admin'),
),
'example-saml' => array(
'saml:SP',
'entityId' => 'my-entity-id',
'idp' => 'my-idp',
),
'example-admin' => array(
'core:AdminPassword',
),
You should update the name of this authentication source
(example-multi), and the authentication sources it references,
to have a name which makes sense to your organization.
The MultiAuth authentication sources only has an option: the
sources option, and it is required. It is an array of other
authentication sources defined in the config/authsources.php
file. The order in this array does not matter since the user
is the one that decides which one to use.
I is possible to add the parameter source to the calling URL,
when accessing a service, to allow the user to preselect the
authsource to be used. This can be handy if you support different
authentication types for differen types of users and you want the
users to have a direct link to the service and not want them to
select the correct authentication source.
For example:
htttps://example.com/service/?source=saml
will take you directly to the SAML authentication source, instead of hitting the multiauth select page.
