Compila un servicio de claves personalizado para la encriptación del cliente

Puedes usar tus propias claves de encriptación para encriptar los datos de tu organización, en lugar de usar la encriptación que proporciona Google Workspace. Con la encriptación del cliente (CSE) de Google Workspace, la encriptación de archivos se maneja en el navegador del cliente antes de que se almacenen en el almacenamiento basado en la nube de Drive. De esa manera, los servidores de Google no pueden acceder a tus claves de encriptación y, por lo tanto, no pueden desencriptar tus datos. Para obtener más detalles, consulta Acerca de la encriptación del cliente.

Esta API te permite controlar las claves de encriptación de nivel superior que protegen tus datos con un servicio de claves externo personalizado. Después de crear un servicio de claves externo con esta API, los administradores de Google Workspace pueden conectarse a él y habilitar la CSE para sus usuarios.

Terminología importante

A continuación, se muestra una lista de los términos comunes usados en la API de Client-side Encryption de Google Workspace:

Encriptación del cliente (CSE)
Encriptación que se maneja en el navegador del cliente antes de que se almacene en un almacenamiento basado en la nube. Esto evita que el proveedor de almacenamiento lea el archivo. Más información
Servicio de lista de control de acceso a las claves (KACLS)
Tu servicio de claves externo que usa esta API para controlar el acceso a las claves de encriptación almacenadas en un sistema externo.
Proveedor de identidad (IdP)
El servicio que autentica a los usuarios antes de que puedan encriptar archivos o acceder a archivos encriptados.

Encriptación y desencriptación

Clave de encriptación de datos (DEK)
Es la clave que usa Google Workspace en el cliente del navegador para encriptar los datos.
Clave de encriptación de claves (KEK)
Una clave de tu servicio que se utiliza para encriptar una clave de encriptación de datos (DEK).

Control de acceso

Lista de control de acceso (LCA)
Una lista de usuarios o grupos que pueden abrir o leer un archivo.
Token web JSON (JWT) de autenticación
Token del portador (JWT: RFC 7516) que emite el socio de identidad (IdP) para certificar la identidad de un usuario.
Token web JSON (JWT) de autorización
Token del portador (JWT: RFC 7516) que emite Google para verificar que el emisor está autorizado para encriptar o desencriptar un recurso.
Conjunto de claves web JSON (JWKS)
Una URL de extremo de solo lectura que dirige a una lista de claves públicas que se usan para verificar los tokens web JSON (JWT).
Perímetro
Verificaciones adicionales que se realizan en los tokens de autenticación y autorización dentro de KACLS para el control de acceso.

Proceso de encriptación del cliente

Después de que un administrador habilita la CSE en su organización, los usuarios para los que está habilitada pueden optar por crear documentos encriptados con las herramientas de creación de contenido colaborativo de Google Workspace, como Documentos y Hojas de cálculo, o encriptar archivos que suben a Google Drive, como PDF.

Después de que el usuario encripta un documento o archivo, sucede lo siguiente:

  1. Google Workspace genera una DEK en el navegador cliente para encriptar el contenido.

  2. Google Workspace envía la DEK y los tokens de autenticación a tus KACLS de terceros para encriptarlos mediante una URL que le proporcionas al administrador de la organización de Google Workspace.

  3. Tu KACLS usa esta API para encriptar la DEK y, luego, envía la DEK ofuscada y encriptada de vuelta a Google Workspace.

  4. Google Workspace almacena los datos ofuscados y encriptados en la nube. Solo los usuarios con acceso a tus KACLS pueden acceder a los datos.

Para obtener más información, consulta Encripta y desencripta archivos.

Próximos pasos