Prerequisites

Before you can perform client side encryption:

1. Make sure you have a stable release of Google Chrome or Microsoft Edge installed and running.

2. Make sure your access to KACLS is not blocked by web filters, for example, Zscaler.

3. Make sure you have the CCKM Admins rights to perform Google Workspace CSE operations on the CipherTrust Manager.

4. Make sure that an identity provider system is set up correctly. For this, the identity provider admin uses either of following methods:

   Using .well-known File Configuration

   1. Host the cse-configuration JSON file on a Web server. A sample JSON file looks like this:

      {
        "name": "CSE IDP",
        "client_id": "<authenticationAud>",
        "discovery_uri": "<openidConfigurationURL>",
        "audience": "cse-test"
      }
      

      Here,

      • <authenticationAud> is the ID of the third-party identity provider. For example, for Auth0, it is represented by the Client ID.

      • <openidConfigurationURL> is the identity provider configuration URL. For example, for Auth0, it can be https://demo.auth0.com/.well-known/openid-configuration.

   2. Create a sub-domain on the Google domain portal for the hosted Web server. Navigate to the Google domain > DNS > Customer resource records and add the IP address of the Web server with the name cse.

   Using IdP Fallback Settings

   1. On the Google Admin Console, set identity provider configuration.

   2. Specify the following fields:

      • Name: Name for the identity provider.

      • Client ID: The ID of the third-party identity provider. For example, for Auth0 and STA, it is represented by the Client ID.

      • Discovery URI: The identity provider configuration URL. For example, for Auth0, it can be https://demo.auth0.com/.well-known/openid-configuration, and for STA, it is represented by WELL KNOWN CONFIGURATION URL.

      • Grant type: Set as Implicit.

   3. Test and save the settings.

5. (Applicable when a valid public DNS for the CipherTrust Manager is unavailable.) Create a subdomain for Thales key service (KACLS) on Google domain. Refer to Creating a Subdomain on Google Domain.

6. Create a URL to access the KACLS. This URL is referred to as KACLS Endpoint URL in this document. Refer to Creating a KACLS Endpoint URL below.

7. Configure Google Workspace connection to KACLS. Refer to Configure Google Workspace Connection to KACLS for details.

Creating a Subdomain on Google Domain

1. Log on to Google domain as a super admin for the user domain.

2. Navigate to DNS > Custom resource records.

3. Create a subdomain for the KACLS. Specify a name for your subdomain and the IP address or hostname of the KACLS.

Creating a KACLS Endpoint URL

A KACLS URL is needed to access the Thales key service. Google Workspace administrators use this URL to configure Google Workspace to communicate with the KACLS. Creating a KACLS URL requires an identity provider and a KACLS endpoint.

To create a KACLS endpoint URL:

1. Create an identity provider.

   • GUI: Refer to Creating Identity Providers.

   • API: Refer to Creating Identity Providers.

2. Create a KACLS endpoint.

   • GUI: Refer to Creating KACLS Endpoints.

   • API: Refer to Creating KACLS Endpoints.

Configure Google Workspace Connection to KACLS

To configure the Google Workspace connection to KACLS:

1. Open the Google Admin console, http://admin.google.com.

2. Log on as a super admin for the user domain.

3. Navigate to CSE settings: Security > Client Side Encryption.

   

4. Click Add external key service.

5. Specify Name of external key service. This name will appear in error messages if Google Workspace cannot contact the key service.

6. Enter URL of external key service. This URL was created in Creating a KACLS Endpoint URL.

   

7. Click TEST CONNECTION to test that Google Workspace can communicate with the KACLS.

   If the connection fails, correct the KACLS endpoint URL, ensure the Internet connectivity, and retry.

8. Click CONTINUE.

9. Click SAVE. The Google Workspace connection to KACLS is configured.

Google Workspace can communicate with KACLS for encryption and decryption of files on Google Drive. Whenever a new file (Blank encrypted document) is created or updated, its data is encrypted automatically.

Also, when a new file is uploaded (using File upload > Encrypt and upload), the file is encrypted and uploaded.

When an existing encrypted file is opened, its data is decrypted for authenticated end users.