Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Click on the Clients menu item on the left-side menu, this should load a list of authentication clients

  2. Click on Edit (or click on the name link) on the item labelled dashboard in order to load the client

  3. Open the dropdown for Login Theme and select the theme created for your reseller (E.g. my-reseller-theme)

  4. Update the Valid Redirect URIs to include the URL you have configured for the Dashboard UI (remember to click the + plus icon after entering the value).
    This will allow Keycloak to redirect back to your Dashboard UI after authenticating

  5. Update the Web Origins to include the URL you have configured for the Dashboard UI (remember to click the + plus icon after entering the value).
    This will allow CORS endpoint calls to Keycloak from the Dashboard UI.

  6. Click the Save button at the bottom of the screen

(Required for Synergy) Setting up

...

Steps #1 Keycloak authentication flow

  1. Go to Authentication β†’ Flow.

  2. Choose

Direct Grant, press the copy button and specify some name (i.e. X509 Direct Grant).

...

  1. Remove everything apart from

Username Validation by selecting Actions -> Delete

...

  1. Press

Add execution and select X509/Validate Username from the dropdown, and then press save.

...

  1. You should get a view the same as below.

...

  1. Navigate to

X509/Validate Username β†’ Actions β†’ Config.

Specify the name of the config.

...

Set User Identity Source to Subject's e-mail and User mapping method to Username or email.

...

Image Removed

Save it.

...

(Required for Synergy) Setting up a default Agent user

Steps #2 Keycloak client and user

This step is important and required for the agent to work correctly.

...

  1. Click on the Users menu item on the left-side menu, this should load the Users list

  2. Click the Add user button in the top right to open the Add user screen

  3. It’s only necessary to complete two fields on this form; The Username field should contain agent, and the Email field should contain agent@gv.com:

  4. Click the Save button at the bottom of the screen

(Required for Synergy) Setting up a default Agent user authentication

Steps #3 Keycloak client and user authentication

Go to Clients and select agent and choose Edit.

...

If agentdoes not exist, then press create, and specify Client ID as agent.

...

...

(Optional) Completing the Agent Client Configuration

...

Usually any issues which occur during the LDAP Active Directory configuration process above will be related to Network accessibility concerns or authentication credentials being incorrect.

Another way to troubleshoot your configuration is to check our Keycloak Manual Installation Guide, this configuration covers the entire Keycloak configuration process. This quick installation manual skips a lot of the manual installation steps which are included via the automatic import of the default configured realm on Keycloak installation.

However, if you require any additional support or your problem is not easily resolved by troubleshooting Network communications and authentication details, please reach out to our support at support@getvisibility.com

...