Skip to main content
Version: 19.0

Force Specific Authentication Mechanism

ADONIS users can be forced to log in using a specific authentication mechanism (= connector) with an URL parameter, even though another connector would usually be applied.

note

Check the Authentication page in the ADONIS Administration for connector IDs and types.

Force Specific Connector​

In order to force a specific connector:

  • Enter the URL where ADONIS is available and add ?forceConnector=<CONNECTOR_ID>.
Example

You want to create and distribute a URL which forces the standard connector (<connector id="Standard Login", the standard login page).ADONIS is available at https://pp2****.de.boc-cloud.com. The URL should look like this:

https://pp2****.de.boc-cloud.com?forceConnector=Standard%20Login

URLs cannot contain spaces, therefore the space character is replaced with "%20" in the example above (URL Encoding).

Force Specific Connector Type​

In order to force a specific connector type:

  • Enter the URL where ADONIS is available and add ?forceConnectorType=<CONNECTOR_TYPE>.

The first configured and applicable (not ruled out via constraints) connector of the specified type will be used for authentication.

Example

You want to create and distribute a URL which forces a connector of type "SAML". ADONIS is available at https://pp2****.de.boc-cloud.com. The SAML URL should look like this:

https://pp2****.de.boc-cloud.com?forceConnectorType=SAML

Force Connector/Connector Type for ADONIS Administration​

You can also force the use of a specific connector or connector type to log on to the ADONIS Administration.

In order to force a specific connector:

  • Enter the URL where ADONIS is available and add /admin.view?forceConnector=<CONNECTOR_ID>.

In order to force a specific connector type:

  • Enter the URL where ADONIS is available and add /admin.view?forceConnectorType=<CONNECTOR_TYPE>.

The first configured and applicable (not ruled out via constraints) connector of the specified type will be used for authentication.

Force Refresh of Connection Data​

When using the above parameters, the information about the forced connector is stored in the cache of the browser. Unless all browser windows are closed, this information will be used on any subsequent visits by the user.

To force a refresh of the connection data, the URL parameter forceClear can be used:

  • Enter the URL where ADONIS is available and add ?forceClear=true.