Configuring Calendar Integration with KloudHybrid

  1. In this step, we will guide you through the process of connecting your organization’s calendar to KloudHybrid. By establishing this connection, you can effortlessly synchronize meeting details, ensuring a seamless experience across the KloudHybrid application, including the homepage and My Schedule section.

  2. To begin, it is essential to connect your preferred calendar system to KloudHybrid. Currently, KloudHybrid supports two calendar providers: Microsoft Outlook Calendar and Google Calendar. You can choose the one that suits your organization’s needs best.

  3. Please note that only one calendar can be displayed at a time in KloudHybrid. Carefully consider your requirements and preferences before proceeding with the configuration.

  4. For Microsoft Outlook Calendar integration, refer to the comprehensive Microsoft Graph API document given below. This document contains detailed instructions on how to configure the integration successfully.

  5. Alternatively, if you opt for Google Calendar integration, refer to the dedicated [Google Calendar Integration document(/kloudhybrid/adminguide1/step2/calendarintegration/googlecalendar/)] given below. This guide will walk you through the steps to seamlessly configure the integration.

Table of content

Subsections of Configuring Calendar Integration with KloudHybrid

Microsoft Graph API

  1. Integration with the Microsoft Graph API is required for integration with user calendars. Without this integration, upcoming user meetings will not show up on the home page, conference room bookings made in ‘Kloudspot Hybrid Work’ will not sync to a user’s Outlook calendar, and vice versa.

  2. To find the App integration page, navigate to the Advanced Settings Page, then go to Configuration -> Hybrid Settings-> Application Integrations.

image

Integrating With the Graph API

  1. Log in to your Microsoft Azure portal on https://portal.azure.com/
  2. Click on Azure Activity Directory from the Azure services options as shown below.
image
  1. Locate and click on the App Registration on the menu bar.
image
  1. Click on +New registration on the page.
image

  1. Enter the information in the blanks to create a new registration.

    • Name: enter a name for the application.
    • Supported account types: Select the option as shown in the figure below.

  2. Click on Register.

image

  1. Go back to the home page and click on Overview for login information on the new application created. Copy information from the Essentials and paste it into the KloudHybrid configuration.

    • The Directory (Tenant ID) and Application (Client) Id in KloudHybrid will be the same as those on the Azure portal.
image
  1. Next, we will create a client secret in Azure and past that into KloudHybrid.
image
  • To create a Client Secret, go to the Azure portal, click on Certificates & secrets and then click on + New client secret.
  • Enter the description and click on Add.
image
  • Copy the Value and paste it into the Client secret section in Microsoft Graph API Access in KloudHybrid.
image

Creating API Permissions

  1. Go to the Azure portal, click on API Permissions and then click on + Add permission.
  2. The Request API permissions tab will open. in that, Click on the Microsoft graph button.
image

  1. In the window that appears, select the Applications permissions option.

  2. A list of permissions will appear. Scroll down and check the calendar ReadWrite option from the calendars dropdown menu.

  3. Click on Add permissions button to add calendar permission.

  4. Scroll down again and check the Place Read All options in the place dropdown menu.

  5. Click on Add permissions button to add place permission.

image

  1. The newly added permissions are visible in the configured permission list. To authorize newly added permissions. Click on the Grant Admin Consent button and click Yes in the popup window that appears.

  2. Then the permission status will be changed from not granted to Granted.

  3. Calendar has been successfully configured.

image
  1. Once the calendar is added. The information that is added to the calendar will be displayed in the KloudHybrid.
image

Google Calender Integration

Overview:

This comprehensive document serves as a step-by-step guide to seamlessly integrate Google Calendar into the KloudHybrid application. It provides the necessary information on prerequisites and integration steps.

Scope:

The integration focuses on leveraging the powerful features of the Google Calendar API to empower users in accessing, events within the application effortlessly.

Intended Audience:

This documentation is intended for experienced developers and technical personnel who are responsible for integrating the Google Calendar functionality into KloudHybrid. Familiarity with web development and API integration is assumed.

Prerequisites:

Google Workspace Admin Account: To begin the integration process, you must have administrative access to a Google Workspace account with the necessary permissions to add users and manage settings.

Google Cloud Platform Account: You will need a Google Cloud Platform account to create a project and a service account for accessing the Google Calendar API. KloudHybrid Admin Account: Access to the KloudHybrid admin account is required to configure the integration settings and enable the usage of the Google Calendar API within KloudHybrid.

Integration Steps:

Follow the step-by-step instructions below to successfully integrate Google Calendar into KloudHybrid.

Step 1: Add Users in Google Workspace Admin Console:

To initiate the integration, proceed with adding the required users to the Google Workspace admin console, following these steps:

  1. Access the Google Workspace admin console by navigating to admin.google.com.
  2. Utilize administrative privileges to add the designated users who will utilize the Google Calendar functionality within KloudHybrid.

Step 2: Create a Project in Google Cloud Console:

After adding the necessary users, continue with the following steps to create a project in the Google Cloud console:

  1. Visit the Google Cloud console at: https://console.cloud.google.com/

  2. Click on the menu icon (three horizontal lines) located at the top left corner of the page.

  3. Select “IAM and Admin” > Projects > “NEW PROJECT”.

  1. Provide a descriptive name for your project in the “Project Name” field.

  2. Select “Organisation” from the dropdown list.

  3. Click “Browse” in the “Location” field to view the available project locations.

  4. Once you have made the necessary selections, click “Create”.

  1. Your project will be created within a few minutes, and you will be redirected to the project’s Dashboard page.

Step 3: Create a Service Account in the Project:

To create a service account within the project, follow these instructions:

  1. Select the project in which you want to create the service account.

  2. Click on the menu icon (three horizontal lines) located at the top left corner of the page.

  3. Choose “IAM & Admin” > “Service accounts”.

  4. Click the “Create service account” button.

  1. Enter a descriptive name for your service account in the “Service account name” field.

  2. Optionally, provide a description of the service account.

  3. If you don’t want to configure access controls at this moment, click “Done” to complete the service account creation.

  1. The service account will be successfully created, and you will be redirected to the Service Accounts page.

Step 4: Create JSON Key File:

To authenticate your access to Google Cloud services, create a JSON key file for the service account using the following instructions:

  1. Go to the Service Accounts page.

  2. Click on the menu button (three vertical dots) at the right end of the service account name.

  3. Select the “Manage key” option from the dropdown list.

  1. Click the “Add key” dropdown menu and choose “Create new key”.

  2. Select “JSON” as the key type and click “Create”.

  1. The JSON key file will be downloaded to your computer.

Note: • Treat the JSON key file as sensitive information and store it securely. • Do not share the JSON key file with anyone.

Step 5: Integrate JSON Key File in KloudHybrid:

To integrate the JSON key file into KloudHybrid for Google Calendar integration, follow these steps:

  1. Access the KloudHybrid admin account.

  2. Navigate to Configuration > Hybrid settings > Application integration.

  3. In the window that appears, select “Google” as the service provider.

  4. Paste the downloaded JSON key file contents into the “Google Calendar API access” box.

  5. Save the changes by clicking the “Save” button.

Enable Required Permissions:

To ensure seamless functionality of the integrated Google Calendar within KloudHybrid, it is necessary to configure the following permissions.

Configure the integration on the admin side.

To further configure the integration on the admin side, follow the steps below:

  1. Log in to the Google Workspace admin console using the admin account credentials.
  1. Navigate to “Apps” > “Google Workspace” > “Calendar” to access the Calendar settings.
  1. In the Calendar settings window, locate and click on the “External sharing option for the primary calendars”.
  1. Configure the sharing settings as shown in the image below:

Sharing Settings

  1. Next, we need to enter the client ID and scope in the API controls.

  2. Navigate to “Security” > “Access and data control” > “API controls”.

  3. In the API controls window, click on the “Manage Domain-Wide Delegation” button.

  1. In the Domain-Wide Delegation window, click on the "+ Add a filter” button to add the client ID and scope.

  2. Copy the client ID from the JSON key file and paste it into the “Client ID” column.

  3. Copy the scopes provided below and paste them in the “Scope” column:

These steps ensure that the necessary configurations are made on the admin side to enable seamless integration of Google Calendar into KloudHybrid.

Making a Calendar Available to the Public:

To make a calendar available to the public, follow these steps:

Note: This step is mandatory for all users and admins to complete.

  1. Open the Google Calendar.

  2. Navigate to “Settings and sharing” from “My Calendar”.

  1. In the opened window, select the “Make available to public” option.

  2. Choose the desired level of access you wish to grant to the public. For example, selecting “See all event details”.

Sharing a Calendar with Specific People or Groups:

To share a calendar with specific individuals or groups, perform the following actions:

  1. Scroll down and click on the "+ Add people and group" button.

  1. In the popup window, copy and paste the client email obtained from the JSON key file into the email column.

  2. From the permissions dropdown list, select either “See all event details” or “Make changes and manage sharing”.

  3. Click the “Send” button to finalize the sharing process.

After all these configurations you can see Google calendar events on your Hybrid homepage and calendar page.