Create and Test an OAuth-Based Riva Google Connection

To create and test an OAuth-based Riva Google connection:

1. Ensure that the system requirements are met.
2. Create a Google connection that relies on OAuth.
3. Test the OAuth-based Google connection.

Step 1: Ensure That the System Requirements Are Met

• Supported Google Versions: G Suite Business, G Suite for Education, G Suite Basic, and Gmail.

• Google Web Services: Riva connects to Google Web Service via API to establish a connection.

• Riva Connection Mailbox User: Riva requires a fully enabled Google Administrator account and a Google Developer account to establish a connection.

Step 2: Create a Google Connection that Relies on OAuth

A Google connection that uses OAuth cannot be impersonated by other connections. It is a direct connection for one user. In a Riva Google deployment, every OAuth user has an individual connection.

To create and configure an OAuth-based Google connection within the Riva Manager application:

1. Open the Riva Manager application.

2. If your version of Riva has a horizontal menu bar, select Setup.

3. In the left pane, below Connections, select Add Email, and then choose Google from the drop-down list.

4. On the wizard's Welcome page, select Next.

5. Select OAuth.

   If you select Service Account, refer to the instructions at Create and test a Riva Enterprise Google connection.

   

   • Client ID, Client Secret, and Redirect URL: Enter the values generated or configured at step 4 of Preparing Google for the Web Application Client Approach for Riva On-Premise.

   • Scopes to Authorize: For each module, determine the access level by selecting the corresponding radio button. To authorize other scopes, select Custom Scopes.

   • Custom Scopes: Opens the Custom Scopes window to authorize other modules for the Google connection.

   • Use Proxy: If proxy options are required to access the Redirect URL, select Use Proxy to specify a unique http or https proxy setting that will apply to the Google connection.

   • Advanced options: Opens the Advanced Options window, where you can add advanced or custom options to the Google connection. For instructions, see Configure advanced or custom options for a connection object.

6. Select Next.

7. In the windows that appear, provide your Google credentials.

8. In the window titled [your first name] would like to, select Allow.

9. On the wizard's last page, select Finish.

   The Riva Manager application generates a Google connection object.

   

Step 3: Test an OAuth-Based Google Connection

To test the connection:

1. If your version of Riva has a horizontal menu bar, select Setup.

2. In any version of Riva, in the right pane, double-click the Google connection to edit it.

3. Select General, and confirm that the connection credentials look correct.

   

4. To test the Riva connection user: Select Connection Test. Note that the User E-mail text box already contains the email address and is read-only. Select Run Test.

   

   The system tests that the connection host and credentials work.

5. In the Test Succeeded message box that appears, select OK.

6. In the bottom right corner, select Cancel to close the CRM Connection Edit window.