Skip to main content
Version: 15.0

Force Specific Authentication Mechanism

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

Force Specific Connector​

In order to force a specific connector:

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

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

In order to force a specific connector:

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

In order to force a specific connector type:

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