Versions Compared

Key

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

...

...

...

...

...

...

...

...

...

...


Section


Column

The Google Connector supports Oauth2 - Open Standard for authorization. This requires the account holder to provide consent to the Google connector to access data on their behalf. This is a manual process and must be done for each Google account associated with the connector.

Cloud Customers

Cloud customers using the Google Connector for the first time will need to:

In-house Customers

In-house customers will need to:


Column
width350px

On this page:

Table of Contents
maxLevel3


...

Follow these steps to install the Google Connector: These instructions assume that you have an in-house installation of v9frevvo v9.0+ up and running.

Download the Connector

  1. Make sure the version of  is frevvo is compatible with the version of the Google Connector you are installing. View the compatibility matrix to check the versions. If you are not using the correct version of frevvo, first upgrade your server frevvo server software.  

  2. Stop frevvo.

  3. Download the compatible version of the Google Connector from our frevvo Software Download Directory. Rename  Extract the .zip file to a temporary location. Copy the google.war and copy it to cto c:\<frevvo-home>\tomcat\webapps. 

  4. If you are running  on frevvo on your local machine, you must set a domain name for your machine - otherwise you can skip this step. 

...

Note

If you are currently using a previous version of the Google Connector and you want to upgrade, follow these steps if you are using the Tomcat bundle:

  1. Ensure you have downloaded the supported version of OpenJDK. Check Supported Platforms before beginning.

  2. Stop Stop frevvo

  3. Download the Google Connector.

  4. Rename the google-connector-2.3.1.war to google.war and replace the existing one in <frevvo-home>\tomcat\webapps.

  5. Delete the <frevvo-home>\tomcat\webapps\google directory. If this directory is not deleted then the Google Connector will run from the old directory and the newer version won't take effect.

  6. Continue with step 5.

    Ex: For Windows edit the C:\WINDOWS\system32\drivers\etc\hosts file as an administrator and modify the 127.0.0.1 entry with a domain name:  

    Code Block
    127.0.0.1 example.com


...

  1. If you do not have a file named frevvo-config.properties in <frevvo-home>\tomcat\conf, you can rename the JSON file to frevvo-config.properties.
    1.  Edit the file and append the prefix client.secrets= to the file content.

      Code Block
      client.secrets={"web":{"client_id":"1042723840399-112fedk6nurt8j657rl4etl8441m3evf.apps.googleusercontent.com","project_id":"maryann-domain","auth_uri":"https://accounts.google.com/o/oauth2/auth","token_uri":"https://accounts.google.com/o/oauth2/token","auth_provider_x509_cert_url":"https://www.googleapis.com/oauth2/v1/certs","client_secret":"E1P4VRTudW7mXZ7Pps5hsm5C","redirect_uris":["http://maryann.com/google/credential"]}}


    2. Save the file. Make sure the file type is changed from json to properties.
  2. If you already have a file named frevvo-config.properties in <frevvo-home>\tomcat\conf directory, then copy the information from the json file and add it to your existing frevvo-config.properties file.
    1.  Append the prefix client.secrets= to the pasted content from the json file

      Code Block
      client.secrets={"web":{"client_id":"1042723840399-112fedk6nurt8j657rl4etl8441m3evf.apps.googleusercontent.com","project_id":"maryann-domain","auth_uri":"https://accounts.google.com/o/oauth2/auth","token_uri":"https://accounts.google.com/o/oauth2/token","auth_provider_x509_cert_url":"https://www.googleapis.com/oauth2/v1/certs","client_secret":"E1P4VRTudW7mXZ7Pps5hsm5C","redirect_uris":["http://maryann.com/google/credential"]}}


    2. Save the file. Make sure the file type is changed from json to properties
  3. You can also
    1. Rename the JSON file as client_secrets.json
    2. Copy it to tomcat/lib folder
    3. Create/edit the frevvo-config.properties in <frevvo-home>\tomcat\conf directory. Add the client.secrets= property to this file without a value e.g. client.secrets=


...

Configure Connector Location


If your  external your frevvo external HTTP port is any port other than Port 8082, you must add the frevvo.google.connector.url property to the frevvo-config.properties file in <frevvo-home>\tomcat\conf directory to set the location of the connector. This property defaults to frevvo.google.connector.url=http://localhost:8082/google. For example, if your external HTTP port is Port 80, add this property:

...

  1. Start the Insight server, then start  start frevvo
  2. Paste this url in your browser: http://<DOMAIN_ NAME>/google/health to check the Google Connector status. Provide your domain name and the port number if you are running locally. You should see a {"status":"UP"} message.

...

The Google connector logfile defaults to INFO loglevel. To configure DEBUG level logging for the Google connector log:

  1. Stop Stop frevvo
  2. Create/edit a frevvo-config.properties file in <frevvo-home>\tomcat\conf
  3. Add the logging.level.com.frevvo.connectors.google=DEBUG property to the file or add the logging.level.=DEBUG to see DEBUG messages in the frevvo and any connector logs.
  4. Save the file
  5. Restart Restart frevvo

Code Block
logging.level.com.frevvo.connector.google=DEBUG

...