Criar um serviço de chaves personalizado para usar a criptografia do lado do cliente

É possível usar suas próprias chaves para criptografar os dados da organização, em vez de usar a criptografia que o Google Workspace oferece. Com a criptografia do lado do cliente (CSE) do Google Workspace, a criptografia de arquivos é processada no navegador do cliente antes de ser armazenada no armazenamento baseado em nuvem do Drive. Dessa forma, os servidores do Google não podem acessar suas chaves de criptografia e, portanto, não podem descriptografar seus dados. Saiba mais em Sobre a criptografia do lado do cliente.

Essa API permite controlar as chaves de criptografia de nível superior que protegem seus dados com um serviço de chaves externo personalizado. Depois de criar um serviço de chaves externo com essa API, os administradores do Google Workspace podem se conectar a ele e ativar a CSE para os usuários.

Terminologia importante

Confira abaixo uma lista de termos comuns usados na API Google Workspace Client-side Encryption:

Criptografia do lado do cliente (CSE)
Criptografia que é processada no navegador do cliente antes de ser armazenado na nuvem. Isso impede que o arquivo seja lido pelo provedor de armazenamento. Saiba mais
Serviço de lista de controle de acesso a chaves (KACLS, na sigla em inglês)
O serviço de chaves externo que usa essa API para controlar o acesso a chaves de criptografia armazenadas em um sistema externo.
Provedor de identidade (IdP)
O serviço que autentica os usuários antes de eles criptografarem arquivos ou acessarem arquivos criptografados.

Criptografia e descriptografia

Chave de criptografia de dados (DEK)
A chave usada pelo Google Workspace no cliente do navegador para criptografar os próprios dados.
Chave de criptografia de chaves (KEK, na sigla em inglês)
Uma chave do seu serviço que é usada para criptografar uma chave de criptografia de dados (DEK, na sigla em inglês).

Controle de acesso

Lista de controle de acesso (ACL)
Uma lista de usuários ou grupos que podem abrir ou ler um arquivo.
JSON Web Token (JWT) de autenticação
Token do portador (JWT: RFC 7516) emitido pelo parceiro de identidade (IdP) para atestar a identidade de um usuário.
Autorização JSON Web Token (JWT)
Token do portador (JWT: RFC 7516) emitido pelo Google para verificar se o autor da chamada está autorizado a criptografar ou descriptografar um recurso.
Conjunto de chaves JSON da Web (JWKS)
Um URL de endpoint somente leitura que aponta para uma lista de chaves públicas usadas para verificar JSON Web Tokens (JWT).
Perímetro
Verificações adicionais realizadas nos tokens de autenticação e autorização no KACLS para controle de acesso.

Processo de criptografia do lado do cliente

Depois que um administrador ativa a CSE na organização, os usuários com esse recurso ativado podem criar documentos criptografados usando as ferramentas colaborativas de criação de conteúdo do Google Workspace, como os apps Documentos e Planilhas, ou criptografar arquivos enviados para o Google Drive, como PDFs.

Depois que o usuário criptografa um documento ou arquivo:

  1. O Google Workspace gera uma DEK no navegador do cliente para criptografar o conteúdo.

  2. O Google Workspace envia a DEK e os tokens de autenticação ao CACL de terceiros para criptografia usando um URL fornecido por você ao administrador da organização do Google Workspace.

  3. O KACLS usa essa API para criptografar a DEK e, em seguida, envia a DEK ofuscada e criptografada de volta para o Google Workspace.

  4. O Google Workspace armazena os dados ofuscados e criptografados na nuvem. Apenas usuários com acesso ao seu KACLS podem acessar os dados.

Confira mais detalhes em Criptografar e descriptografar arquivos.

Próximas etapas