Using Google Calendar / Google Workspace

Warning

Prerequisites for Google Calendar Integration:

If you plan to integrate SOPS with Google Calendar, please do not add your Hubs or Displays to the system yet.

You must first configure a valid public domain name and install a valid SSL certificate (issued by a trusted third-party authority) on the SOPS Web Portal.

Navigate to https://<SOPS-LAN-IP>/settings/security to configure the domain and enable HTTPS.

Summary

To integrate Google Calendar or Google Workspace with SyncSign On-Premise Server (SOPS), please complete the following steps:

  1. Create Project: Create a new project in Google Cloud Console.

  2. Enable APIs: Enable Google Calendar and People APIs.

  3. Configure OAuth Screen: Set up branding, audience, and data access (Scopes).

  4. Create Credentials: Generate OAuth 2.0 Client ID and Secret.

  5. Connect SOPS: Configure credentials and authorize your Google account.

Note

Enterprise vs. Personal Accounts: Enterprise (Google Workspace) users configuring an Internal app can usually skip the “Add Test Users” part within the OAuth Screen setup.

Create Project

Official Link: Google Cloud Console - Project Creation

  1. Create a Google Project.

  2. Enter a descriptive Project name, select your organization or location, and click Create to initialize your new Google Cloud project.

../_images/google1.png ../_images/google2.png

Enable APIs

Official Link: Google Cloud API Library

  1. Search for Google Calendar API in the API Library and click Enable to activate the service for your project.

  2. Repeat the same steps to search for Google People API and click Enable.

../_images/google3.png ../_images/google7.png ../_images/google21.png

Configure OAuth Screen

Official Link: OAuth Consent Screen Configuration

  1. Navigate to the OAuth consent screen tab and click Get started to begin.

  2. Complete the Branding and Audience settings:

    • App Information: Provide your App name and User support email.

    • Audience: Select Internal (for organization-only use) or External (for testing/personal accounts).

    • Contact Information: Enter a valid email in the Developer contact information field.

    • Authorized Domains: Add your application’s domain (e.g., sopstestdemo.com).

  3. Add Scopes (Data Access): Click Add or remove scopes. Search for and select the required Google Calendar API and Google People API scopes, then click Update and Save.

  4. Add Test Users (External Only): If your User Type is set to External and Status is Testing, click Add Users and enter your testing Gmail address.

Note

Selecting “Internal” limits authorization to accounts within your own organization. External mode may require subsequent app verification.

../_images/google10.png ../_images/google11.png ../_images/google22.png ../_images/google18.png ../_images/google20.png

Create Credentials

Official Link: Google Cloud Credentials Manager

  1. Navigate to Create credentials > OAuth client ID.

  2. Set the Application type to Web application and configure your Authorized JavaScript origins and Redirect URIs.

  3. Click Create to generate your Client ID and Client Secret, or download the JSON credentials file.

Important

Ensure that the “Authorized redirect URIs” exactly match your server’s domain and callback paths.

../_images/google14.png ../_images/google16.png ../_images/google17.png

Connect SOPS

  1. Enter Credentials: Go to https://<Your-SOPS-Domain>/m, navigate to Settings > Integration > Google App > Edit. Fill in the Client Id and Client Secret and hit Save.

  2. Authorize Account: Navigate to Settings > Integration > Google Workspace > Connect. You will be redirected to the Google Login page to complete the authorization.

  3. Finish: Once connected, you can link your displays to Google Calendar resources in the SOPS dashboard.

Note

Domain Verification is required for Webhook notifications to enable real-time calendar updates.