Page tree

Versions Compared

Key

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

...

To configure translate5 to work with OpenId connect is very simple. Navigate to the clients tab in your translate5 instance, and under the OpenId connect field-set there are OpenId configuration fields that need to be set.

Fill in the fields with the data as explained below. How to obtain the data of the OpenId Connect server is explained by the Google example further below.

translate5 domain:  the used translate5 instance login url (google . The URL that accesses the login page of your translate5 instance (Google configuration example: http://www.translate5-openid.comnet/login). This is also the url which the user will be redirected to after the OpenId authentication.

OpenId server: OpenId authentication server url (google configuration . This is the URL translate5 redirects users for authentication at the OpenId connect server (Google configuration example: https://accounts.google.com)

OpenId user name: OpenId authentication server username (google configuration Google configuration example: "Client ID" see image3)
(the user name that allows the openId client application to connect to the API of the openId server; do NOT mix this up with the username of the user, that wants to authenticate!)

OpenId password: OpenId authentication server password (google configuration Google configuration example: "Client secret" see image3)
(the password that allows the openId client application to connect to the API of the openId server; do NOT mix this up with the password of the user, that wants to authenticate!)

OpenId OAuth URL: OpenId authentication server OAuth url (google configuration example:: . This is the URL translate5 uses in the background to do the server to server authentication mechanism (Google configuration example: https://accounts.google.com/o/oauth2/auth). Also used to fetch the openid server properties (ex: https://accounts.google.com/o/oauth2/auth/.well-known/openid-configuration)

...

Link text on login page:  Label text on the login page of translate5. A click on it redirects the user to the configured openid server for authentication, instead of using translate5 for authentication. If the checbox below the field "Link text on login page" is checked, the user will directly be redirected to the openid server for authentication/authorization and will never see the translate5 login page.

...

Setup the OpenId connect server - the Google example with Google's OAuth 2.0 API

Before your translate5 application can use Google's OAuth 2.0 authentication system for user login, you must set up a project in the Google API Console to obtain OAuth 2.0 credentials, set a redirect URI, and (optionally) customize the branding information that your users see on the user-consent screen.

...

  1. Select an existing OAuth 2.0 credential or open the Credentials page. (see image1)
  2. If you haven't done so already, create your project's OAuth 2.0 credentials by clicking Create credentials > OAuth client ID, and providing the information needed to create the credentials.
    1. click on Create credentials dropdown and select OAuth client ID and fill in the requested data
    2. on the next window Configure consent screen
      1. select Web application in the radio button options
      2. give a name to your your OAuth client ID (this is not the display name of your app) and click create
    3. now the new created client id should be listed in the credentials tab (see image2)
  3. the next step is to set up Authorized domain
    1. navigate to the OAuth consent screen
    2. in the Authorized domains field add you current translate5 domain without protocol (see image4)
    3. click on save in the page bellowbelow
  4. the next step is to add redirect Urls
    1. click on the credentials tab, and click on the openid client
    2. in the field Authorized redirect URIs add your translate5 instacne domain folowed by /login (image3) and click on save
  5. Look for the Client ID in the OAuth 2.0 client IDs section. For details, click the client ID.

...