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 Agent authentication flow

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 Added

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.

...

Go to the very bottom of the page to the Authentication Flow Overrides , then to Direct Grant Flow and set it to X509 Direct Grant. Save.

...

(Optional) Completing the Agent Client Configuration

...