Create, Test, and Edit a Riva Enterprise Google Connection

Rawan Maarouf
Rawan Maarouf
  • Updated

To create, test, and edit a Riva Enterprise Google connection:

  1. Ensure that the system requirements are met.
  2. Create a Google Enterprise connection.
  3. Test the connection.
  4. Edit the connection.

Step 1: Ensure That the System Requirements Are Met

  • Supported Google Versions: G Suite Business, G Suite for Education, and G Suite Basic.
  • 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 Enterprise Connection (by Using a Google Web Services Connection)

To create and configure a Google Enterprise connection:

  1. Start the Riva Manager application.

    riva-desktop-shortcuts (2).png

  2. On the menu bar, select Setup. In the left pane, select the Google Connection Wizard.
  3. On the wizard's Welcome page, select Next.

  4. Enter the connection details for the Google connection.

    GoogleConectorNew1.png

    • Primary Email: Provide an Administrator account for your Google environment that has access to the groups and their members that will be syncing.
    • Dev Account: Provide the Service Account Email Address generated at step 14 of To create a Google development project.

  5. Select Certificate.

    ClickCertNew.png

  6. To the right of the certificate that appears, select Browse.

    Browse.png

  7. Browse to the location of the certificate generated at step 11 of To create a Google development project, and enter the password displayed at step 12.
  8. Verify the password, and select OK.

  9. Select Next.

    The Riva Manager application generates a Google connection object.

    GoogleComplete(1).png

Step 3: Test a Google Enterprise Connection

Tip: Riva administrators who need to troubleshoot can use these connection tests to confirm that the Riva connection to Google is working.
 

To test the connection to confirm that user impersonation is working:

  1. In the Riva Manager application, on the menu bar, select Setup. In the right pane, double-click the Google Connection object.

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

    GmailConnection.png

  3. To test the Riva connection user: Select Connection Test, leave the User E-mail text box empty, and select Run Test.

    google-conn-test(2).png

    The system tests that the connection host and credentials work.

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

  5. To test impersonation into a Google user that Riva will sync: In the User E-mail field, provide the Google account user name (username@email.domain) for one of the Google accounts that will be synced with the target CRM, and select Run Test.

    google-user-test(1) (1).png

    The system tests that the connection user tested in step 3 is able to impersonate into the target Google user account.

  6. In the Test Succeeded message box, select OK.
  7. In the bottom right corner, select Cancel to close the CRM Connection Edit window.

Step 4: Edit the Google Enterprise Connection

  1. In the Riva Manager application, on the menu bar, select Setup.
  2. In the right pane, double-click the Google Enterprise connection to open the CRM Connection Edit window.
  3. (Riva 2.4.46 or higher is required for this step.) Optional: On the General page, assign a user-friendly Display Name.
  4. Save the connection.