Edit online

How to Set up OAuth Authentication

By default, OAuth login support is disabled. To enable it for Google or Facebook credentials, use the appropriate procedure below.

Notice: If your server is behind a proxy, you must first configure the HTTP proxy.

Google

  1. Register Oxygen Feedback Enterprise with Google:
    1. To use Google’s OAuth 2.0 authentication system for login, you must set up a project in the Google API Console to obtain OAuth 2.0 credentials.
    2. Follow the instructions on the OpenID Connect page, starting in the section, "Setting up OAuth 2.0".

      Step Result: You should have a new OAuth Client with credentials consisting of a Client ID and a Client Secret.

    3. Configure the Oxygen Feedback Enterprise server to point to your newly registered application by adding the oauth.google.client.clientId and oauth.google.client.clientSecret properties in the config/feedback-oauth.properties file:
      #### GOOGLE ####
      oauth.google.client.clientId=google-client-id
      oauth.google.client.clientSecret=google-client-secret
      Note: You need to substitute your client ID and client secret for the placeholder text shown in the example above.
  2. Set the redirect URI. In the Set a redirect URI sub-section, ensure that the Authorized redirect URIs field is set to https://<your-app-base-url>/login/google.

    The OAuth redirect URI is the path in the application that the end-user is redirected back to after they have authenticated with Google and have granted access to the application on the OAuth consent screen page.

Facebook

  1. Register Oxygen Feedback Enterprise with Facebook:
    1. Configure your application’s client ID and client secret (you can obtain them by registering your application with Facebook at https://developers.facebook.com/).
    2. Add the oauth.facebook.client.clientId and oauth.facebook.client.clientSecret properties in the config/feedback-oauth.properties file:
      #### FACEBOOK ####
      oauth.facebook.client.clientId=facebook-client-id
      oauth.facebook.client.clientSecret=facebook-client-secret
      Note: You need to substitute your client ID and client secret for the placeholder text shown in the example above.
  2. Set the redirect URI:
    1. In the App Dashboard, choose your app and scroll to Add a Product.
    2. Click Set Up in the Facebook Login card.
    3. Select Settings in the left side navigation panel and under Client OAuth Settings, enter your redirect URL in the Valid OAuth Redirect URIs field for successful authorization.
    4. Set the Valid OAuth Redirect URIs field to https://<your-app-base-url>/login/facebook.