Connect Google services to your OneCampus instance.
Using the Connector tool, OneCampus Administrators can seamlessly connect Google to their OneCampus instance. Once the connection is authorized by the individual end users, their recently opened Google Drive files will get pulled, their Calendar events for the current day and next day, and their latest emails from Gmail. The connector can be accessed by clicking on the three dots “•••” in the header and it would open a sidebar area
IMPORTANT: Prior to following the configuration steps below, you will need to register an application in Google Cloud Platform, in order to obtain the required values for the configuration. You also need to specify this URL https://{your onecampus domain}/connectors/oauthConnectorCallback as the Redirect URI.
Use the Google Connector
- Begin by clicking the Advanced menu, then click Connectors.
- On the Connectors page, click the Configure button next to Google Connector.
- From the Configure Google Connector page, you can determine the status of the Google Connector by switching it on or off. For example, you may leave it off while you are finalizing your configurations and then turn it on when you are ready to go live with your end users. The default status is off.
- Next, begin your configurations by entering your Google Client ID and Google Secret. [Required]
- The Google Client ID and Google Secret come from your project within Google Cloud Platform. Talk to your Google admin to obtain these. - Indicate what you want the Sections Labels to say. [Required]
- This step controls the text that is displayed in the title of each section that informs the individual end users which section is being viewed
- The default labels are “Google Drive”, “Calendar”, and “Gmail”.
- Indicate what you want the Oauth Redirect Modal Title to say. [Required]
- This step controls the text that is displayed in the title of the modal window that informs the individual end users that they need to authorize the Google connection.
- The default oauth redirect modal title is “Authorize OneCampus to Access Google”. - Indicate what you want the Oauth Message to say. [Required]
- This step controls the text that is displayed within the modal window that informs the individual end users that they need to authorize the Google connection.
- The default oauth message is “Google and OneCampus are now connected but you need to authorize the connection. Do you want to authorize the connection?” - Indicate what you want the Oauth Deauthorization Message to say. [Required]
- This step controls the text that is displayed within the deauthorization modal window that informs the individual end users of what they are about to do should they click the deauthorize button located within their options button.
- The default oauth deauthorization message is “Do you want deauthorize the connection? This will remove the Google Connector from the store page but you can re-authorize in the Preferences panel if you change your mind.” - Configure an ACL Expression/s. [Optional]
- Leaving the ACL section empty will allow everyone access to the connector.
- Administrators can add ACL expressions to restrict this connector to specific users. Only those identified users will see the connector authorization modal windows as well as see their data pull through onto the OneCampus main page.
* Select Or from ACL Expression drop down
* Click the green [+] sign
* Select Condition from Expression Type
* Select a unique identifier from the Value dropdown
* In the Is Equal To box, enter the data that matches the Value selected
* Click Add - Click Save. (Once the configurations have been saved, and if the status switch described in step three is turned on, your end users will be presented with the Google Authorization modal window upon their next login)
- You also have options to Cancel or Delete the configurations at this point.
* Clicking cancel before clicking save will discard anything you entered, however, if an existing configuration had been saved previously, that saved configuration will NOT be changed OR discarded.
* Clicking Delete will remove the configurations you have set up and disable the Google Connection.
Notes:
- Once an end user confirms that they want to authorize the Google Connection, they will be presented with a Google login page and an authorization prompt.
* Consenting to the required permissions on this prompt is the final step and will cause their Google data to be pulled on the main OneCampus page, in the Widgets area.
- If an end user inadvertently dismisses the Google Authorization modal window, they can authorize the Google connection by clicking the “Authorize” button that is located within their Preferences section beneath the sign in drop down.
- If an end user clicks the gear icon next to the connector title, they will be presented with options to “Deauthorize” their Microsoft connection, order the sections that are being displayed, and enable/disable sections by clicking on them.
- Only one of the Widgets connectors can be enabled at a time.
- Please refer to the Quick Start Guide for the Connectors Error Log for additional information in regards to connector related errors that your end users might be receiving.
- Please refer to the Quick Start Guide for the Users Report for additional information in regards to how a OneCampus Administrator can deauthorize the Google Connector for a specific user.
Related to
Updated