Skip to main content
Version: 21.0

Force Specific Authentication Mechanism

ADOIT 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 ADOIT Administration for connector IDs and types.

Force Specific Connector​

In order to force a specific connector:

  • Enter the URL where ADOIT 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).ADOIT 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 ADOIT 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". ADOIT 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 ADOIT Administration​

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

In order to force a specific connector:

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

In order to force a specific connector type:

  • Enter the URL where ADOIT 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 ADOIT is available and add ?forceClear=true.