1. Haiilo Support Center
  2. Add-ons & integrations
  3. Google

Google Integration: Setup

In order to be able to use the functions of the Google integration to the full extent, the basis for a login via Google must first be created.

Note:

These instructions and steps are necessary for you to complete this guide.

Configuration in Google (Part 1)

To configure the Google integration with Haiilo, you must first complete the following steps as an admin within Google Administration.

  1. Log in with a Google Admin account at https://console.cloud.google.com/
  2. Click on the projects in the upper left corner
  3. Creates a new project
  4. Selects the newly created project
  5. Selects "APIs & Services" from the left menu
  6. Selects "Library" from the left menu
    1. Search for the API "Google Drive API"
    2. Enable this API for your project
    3. Search for the API "Google Calendar API"
    4. Enable this API for your project
  7. Selects "OAuth Consent screen" from the left menu
    1. Select either "Internal" (only for your organization) or "External" (for everyone) as "User type"
    2. Write a "App name"
    3. Search for a "User support email"
    4. Add your Haiilo domain in "Authorized domain" (in the cloud this is usually "coyocloud.com".)
    5. Write a email address for "Developer contact information"
    6. Add these scopes with "Add or remove scopes"
      1. /auth/userinfo.email
      2. /auth/userinfo.profile
      3. openid
      4. /auth/drive
      5. /auth/calendar.events
    7. If you have selected the option "External" for "User type", you still have to define "Test users".
    8. Selects "Credentials" from the left menu
      1. Select "Create credentials"
      2. Select "OAuth client ID"
      3. Select "Web application" as "Application type"
      4. Write a "Name"
      5. Choose as "Authorized JavaScript origins" the URL of your Haiilo
      6. Copy "Client ID" and "Client secret" manual or download it as .json file

For now, you are done with the configuration within Google and now continue with configuration in Haiilo. Since you will need to access Google Administration again later, you should leave the tab open.

Configuration in Haiilo (Part 1)

To further configure the Google integration with Haiilo, the next step you need to do is to perform the following steps within Haiilo Administration as an admin.

    1. Log in to your Haiilo with a Haiilo admin account
    2. Click on "Administration" at the top right of your profile picture
    3. Select "Authentication" from the left menu
      1. Create a new authentication provider
      2. Write a "Name"
      3. Choose as "Type" the option "OpenID Connect"
      4. Set "Active" if you want to activate the new authentication provider
      5. Choose as "Presets" the option "Google IdP + Integration"
      6. Leave "email" as "Mapping-ID"
      7. Write the "Client ID" from the Google Administration into "Client-ID"
      8. Write the "Client secret" from the Google Administration into "Client-Secret"
      9. Save the new authentication provider
  2. Edits the newly created authentication provider
    1. Copies the new automatically created "Redirect-URL"

For now, you are done with the configuration within Haiilo and now switch back to the configuration in Google.

Configuration in Google (Part 2)

After configuring the authentication provider in Haiilo, you will need to complete the following steps within Google Administration.

  1. Log in with a Google Admin account at https://console.cloud.google.com/
  2. Click on the projects in the upper left corner
  3. Selects the newly created project
  4. Selects "APIs & Services" from the left menu
  5. Selects "Credentials" from the left menu
  6. Select the newly created OAuth 2.0 Client IDs
    1. Enter the previously created redirect URL from Haiilo under "Authorized redirect URIs"
    2. Save

Now you are done with the configuration within Google and switch back to the configuration in Haiilo.

Configuration in Haiilo (Part 2)

After the last configuration in Google, you need to perform the following steps within Haiilo Administration.

  1. Log in to your Haiilo with a Haiilo admin account
  2. Click on "Administration" at the top right of your profile picture
  3. Select "System settings" from the left menu
    1. Choose "Google Workspace" for the option "Activate integration"
    2. Save the system settings
  4. Select "User management" from the left menu
    1. Choose the tab "Roles"
    2. Edit one of your roles
    3. Activate the permission "Activate Google Workspace" in the area "Integrations"
    4. Save the role

From now on, all users who have this role and log in via Google can access the functions of the Google integration.

For this, they still have to ensure the requested access through Google when logging in with Google.

Was this article helpful?