Nesta página, descrevemos as chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) para o Spanner. Para mais informações sobre CMEK em geral, como quando e por que ativar, consulte a documentação do Cloud Key Management Service.
Por padrão, o Spanner criptografa o conteúdo do cliente em repouso. O Spanner executa a criptografia, e você não precisa fazer nada. Essa opção é chamada de criptografia padrão do Google.
Se você quiser controlar suas chaves de criptografia, use chaves de criptografia gerenciadas pelo cliente (CMEKs) no Cloud KMS com serviços integrados a CMEKs, incluindo o Spanner. Ao usar chaves do Cloud KMS, é possível controlar o nível de proteção, o local, a programação de rotação, as permissões de uso e acesso e os limites criptográficos. Com o Cloud KMS, também é possível ver registros de auditoria e controlar ciclos de vida de chaves. Em vez de o Google ser proprietário e responsável pelo gerenciamento das chaves de criptografia de chaves (KEKs) simétricas que protegem seus dados, você controla e gerencia essas chaves no Cloud KMS.
Depois de configurar os recursos com CMEKs, a experiência de acesso aos recursos do Spanner é semelhante à criptografia padrão do Google. Para saber mais sobre suas opções de criptografia, consulte Chaves de criptografia gerenciadas pelo cliente (CMEK).
Para saber como usar CMEKs criadas manualmente para proteger seus recursos do Spanner, consulte Proteger um banco de dados com CMEK.
Recursos
- Controle de acesso a dados: os administradores podem alternar, gerenciar o acesso e desativar ou destruir a chave usada para proteger dados em repouso no Spanner.
- Auditabilidade: se você ativar a geração de registros de auditoria para a API Cloud KMS no seu projeto, todas as ações na chave, incluindo as realizadas pelo Spanner, serão registradas e visualizáveis no Cloud Logging. As chaves do Cloud EKM são compatíveis com a Justificativas de acesso às chaves, que adiciona um campo de justificativa a todas as solicitações de chaves. Os parceiros de gerenciamento de chaves externos permitem aprovar ou negar automaticamente essas solicitações com base na justificativa.
- Desempenho: o uso de CMEK não altera o desempenho do Spanner nem o contrato de nível de serviço .
- Suporte a várias chaves regionais: é possível criar várias chaves regionais (região única) do Cloud KMS para proteger um banco de dados em uma configuração de instância personalizada, birregional ou multirregional do Spanner.
Preços
O Spanner cobra os bancos de dados com CMEK ativada da mesma forma que qualquer outro banco de dados. Não há custos adicionais do Spanner para ativar a CMEK. Para mais informações, consulte os preços do Spanner.
O Cloud KMS cobra pelo custo da chave e de todas as operações criptográficas executadas usando essa chave (sempre que o Spanner usa a chave para criptografia/descriptografia). Esperamos que esses custos sejam mínimos com base no número esperado de operações criptográficas geradas pelo Spanner. Para mais informações, consulte os preços do Cloud KMS.
O que é protegido com a CMEK
Em um banco de dados com CMEK ativada, o Spanner usa suas chaves do Cloud KMS para proteger dados em repouso. Isso inclui dados em um banco de dados armazenados em disco ou flash.
Veja a seguir algumas exceções. Os seguintes tipos de dados são protegidos pela criptografia em repouso padrão do Google, e não pela chave CMEK:
- Um subconjunto de chaves de linha que marcam os limites do intervalo
- Como depurar dados, incluindo dumps de núcleo e registros operacionais
- Dados em trânsito ou memória
- Metadados do banco de dados
No Spanner, há três camadas de criptografia. Os dados em repouso são divididos em grupos de subarquivos para serem armazenados, e cada um deles é criptografado no nível de armazenamento com uma chave individual. A chave utilizada para criptografar os dados em um bloco é chamada de chave de criptografia de dados (DEK, na sigla em inglês). Devido ao grande volume de chaves no Google e à necessidade de baixa latência e alta disponibilidade, essas chaves são armazenadas próximas aos dados criptografados. As DEKs são criptografadas com (ou encapsuladas por) uma chave de criptografia de chaves (KEK). Por fim, cada KEK é criptografada com sua CMEK.
Quando você alterna a chave CMEK, o Spanner criptografa novamente apenas as KEKs intermediárias com a versão principal mais recente da chave CMEK. Depois que a nova criptografia for concluída, a desativação ou a exclusão das versões anteriores da chave CMEK não desativará o acesso ao banco de dados. Também é possível visualizar as versões de chave que estão sendo usadas para proteger um banco de dados ou alterar a configuração de criptografia do banco de dados para usar chaves diferentes do Cloud KMS ou um Google-owned and Google-managed encryption key.
Com a CMEK

Sem CMEK

Ativar a CMEK
É possível ativar a CMEK para um banco de dados do Spanner
criando o banco de dados ou
atualizando um banco de dados atual.
O Spanner pode acessar a chave em seu nome depois que você concede
o papel de criptografador/descriptografador de CryptoKey do Cloud KMS
(roles/cloudkms.cryptoKeyEncrypterDecrypter) a uma
conta de serviço do Spanner gerenciada pelo Google.
Para instruções detalhadas, consulte Proteger um banco de dados com CMEK.
As APIs de acesso a dados do Spanner, como aquelas usadas para gerenciar sessões e executar transações em dados, são exatamente as mesmas para chaves de criptografia CMEK e Google-owned and Google-managed encryption keys. Os aplicativos não precisam especificar chaves ou configurações de criptografia ao ler ou gravar dados. Toda a criptografia é processada pelo serviço.
Mudar a configuração de criptografia do banco de dados
É possível mudar a configuração de criptografia de um banco de dados do Spanner no local, sem tempo de inatividade. As seguintes opções de configuração de criptografia são compatíveis:
- Ative a CMEK em um banco de dados que usa uma Google-owned and Google-managed encryption key.
- Alterar as chaves do Cloud KMS em um banco de dados com CMEK, incluindo alternar entre uma chave multirregional e várias chaves regionais ou substituir uma ou mais chaves regionais.
- Remover a CMEK e reverter um banco de dados para um Google-owned and Google-managed encryption key.
Quando você atualiza a configuração de criptografia de um banco de dados, o Spanner
atualiza o campo encryption_config do banco de dados e criptografa novamente
os dados do banco de dados em segundo plano. A nova criptografia em segundo plano pode levar
várias horas para ser concluída. Enquanto a nova criptografia em segundo plano está em andamento, o campo encryption_info do banco de dados lista as versões de chave ainda em uso, que podem incluir as chaves anteriores. Para mais informações, consulte
Verificar a conclusão da nova criptografia em segundo plano.
Durante a recriptografia em segundo plano, um pequeno número de transações pode falhar
com um erro ABORTED que pode ser repetido. As bibliotecas de cliente do Spanner tentam realizar essas transações novamente de modo automático.
Esse processo não criptografa novamente os backups. Os backups criados antes ou durante a nova criptografia ainda podem usar as chaves anteriores. Portanto, mantenha essas chaves até que você não precise mais desses backups. Para mais informações, consulte Alterar a configuração de criptografia do banco de dados.
Gerenciar chaves
As operações de gerenciamento de chaves são executadas com o Cloud KMS. O Spanner não pode detectar nem agir em relação a mudanças de chave até que elas sejam propagadas pelo Cloud KMS. Algumas operações, como desativar ou destruir uma chave, podem levar até três horas para serem propagadas. As alterações nas permissões geralmente são propagadas muito mais rápido.
Depois que o banco de dados é criado, o Spanner chama o Cloud KMS aproximadamente a cada cinco minutos para garantir que a chave ainda seja válida.
Se o Spanner detectar que sua chave do Cloud KMS foi desativada ou destruída, uma operação para tornar seu banco de dados inacessível será iniciada imediatamente. Todas as chamadas subsequentes ao banco de dados, incluindo sessões, leituras e gravações, retornam um erro FAILED_PRECONDITION: KMS key required by the
Spanner resource is not accessible. Se as chamadas do Spanner para o Cloud KMS detectarem que uma chave anteriormente desativada foi reativada, o Cloud KMS vai restaurar o acesso ao banco de dados do Spanner automaticamente.
Além disso, se um banco de dados estiver protegido por várias chaves regionais e todas as chaves
forem desativadas ou destruídas, o Spanner começará imediatamente a
tornar o banco de dados inacessível. Se o Spanner detectar que apenas um
subconjunto das chaves do banco de dados está desativado ou destruído, ele desativará o
banco de dados por um período de até 12 horas. Não é recomendável desativar ou destruir apenas um subconjunto de chaves em um banco de dados ativado para CMEK, porque isso pode resultar em um comportamento incerto. Para evitar que isso aconteça, use a
métrica de chaves CMEK do Spanner
(instance/replica/cmek/total_keys) para acionar um alerta se um subconjunto de chaves for
desativado ou destruído. Para mais informações, consulte
Criar alerta para desativar um subconjunto de CMEK.
Criar alerta para desativar um subconjunto de CMEK
Use a métrica
Chaves CMEK do Spanner
(/instance/replica/cmek/total_keys) para acionar um alerta se um subconjunto de CMEKs
for desativado ou destruído. Para criar essa política de alertas, expanda as seguintes etapas e
configurações:
Configurações da política de alertas de CMEK.
| Novo estado Campo |
Valor |
|---|---|
| Recurso e métrica | No menu Recursos, selecione Instância do Spanner. No menu Categorias de métrica, selecione Instância. No menu Métricas, selecione Chaves CMEK. (O metric.type é spanner.googleapis.com/instance/replica/cmek/total_keys).
|
| Filtrar | instance_id = INSTANCE_IDis_key_revoked = TRUE |
| Séries cruzadas Série temporal agrupada por |
database |
| Várias séries Agregação de série temporal |
sum |
| Janela contínua | 10 m |
| Função de janela contínua | mean |
| Campo Configurar gatilho de alerta |
Valor |
|---|---|
| Tipo de condição | Threshold |
| Acionador de alerta | Any time series violates |
| Posição do limite | Above threshold |
| Limite | 0
|
| Teste a janela novamente | 1 hr |
| Novo estado Campo |
Valor |
|---|---|
| Recurso e métrica | No menu Recursos, selecione Instância do Spanner. No menu Categorias de métrica, selecione Instância. No menu Métricas, selecione Chaves CMEK. (O metric.type é spanner.googleapis.com/instance/replica/cmek/total_keys).
|
| Filtrar | instance_id = INSTANCE_IDis_key_revoked = FALSE |
| Séries cruzadas Série temporal agrupada por |
database |
| Várias séries Agregação de série temporal |
sum |
| Janela contínua | 10 m |
| Função de janela contínua | mean |
| Campo Configurar gatilho de alerta |
Valor |
|---|---|
| Tipo de condição | Threshold |
| Acionador de alerta | Any time series violates |
| Posição do limite | Above threshold |
| Limite | 0
|
| Teste a janela novamente | 1 hr |
| Campo Configurar gatilho de alerta |
Valor |
|---|---|
| Gatilho de várias condições | All conditions are met |
Depois que você criar o alerta, se o Spanner detectar que um subconjunto de CMEK foi desativado, um item de resumo de incidente vai aparecer na tabela Incidentes na página Detalhes da política do alerta. Também é possível configurar canais de notificação opcionais. Para saber mais, consulte Criar e gerenciar canais de notificação.
Como um status de chave indisponível é tratado
Em cenários raros, como durante períodos em que o Cloud KMS está indisponível, o Spanner pode não conseguir recuperar o status da chave do Cloud KMS.
Se o banco de dados do Spanner estiver protegido por uma chave ativada no momento em que o Spanner não conseguir se comunicar com o Cloud KMS, o Spanner vai continuar oferecendo suporte a operações completas de banco de dados da melhor forma possível por um período de até uma hora, para minimizar o impacto de qualquer incidente desse tipo na sua carga de trabalho. Depois de uma hora, se o Spanner ainda não conseguir se conectar ao Cloud KMS, ele vai começar a colocar o banco de dados off-line como uma medida de proteção. Os dados no banco de dados do Spanner permanecem inacessíveis até que o banco de dados possa ser reconectado com o Cloud KMS, e o Cloud KMS responde que a chave está ativa.
Por outro lado, se o banco de dados do Spanner estiver protegido por uma chave desativada no momento em que o Spanner não conseguir se comunicar com o Cloud KMS, o banco de dados permanecerá inacessível até conseguir se reconectar ao Cloud KMS e reativar sua chave.
Se você estiver usando várias chaves regionais para proteger um banco de dados do Spanner, somente as réplicas protegidas por uma chave que reside no Cloud KMS regional indisponível serão afetadas pela indisponibilidade.
Considerações sobre chaves externas
Quando você usa uma chave do Cloud EKM, o Google não tem controle sobre a disponibilidade da sua chave gerenciada externamente no sistema de parceiros de gerenciamento de chaves externas.
Se uma chave gerenciada externamente não estiver disponível, o Spanner continuará
oferecendo suporte a operações completas de banco de dados da melhor forma possível por até uma hora.
Depois de uma hora, se o Spanner ainda não conseguir se conectar ao Cloud KMS, ele vai começar a colocar o banco de dados off-line como uma medida de proteção. As chamadas para o banco de dados vão falhar com um erro FAILED_PRECONDITION: External key error: Could not find a key resource
at the key URI.
Se você estiver usando várias chaves do Cloud EKM para proteger seu banco de dados do Spanner, somente as réplicas protegidas pela chave indisponível serão afetadas pela indisponibilidade.
Para mais considerações ao usar chaves externas, consulte a documentação do Cloud External Key Manager.
Backup e restauração
É possível usar CMEK ou Google-owned and Google-managed encryption keys para proteger os backups do Spanner. Por padrão, um backup usa a mesma configuração de criptografia do banco de dados, mas é possível modificar esse comportamento especificando uma configuração de criptografia diferente ao criar o backup. Se o backup estiver ativado para a CMEK, ele será criptografado usando a versão primária da chave KMS no momento da criação do backup. Depois que o backup é criado, a chave e a versão dela não podem ser modificadas, mesmo que a chave do KMS seja alternada ou que a configuração de criptografia do banco de dados seja alterada. Para mais informações, consulte Fazer backup de um banco de dados.
Quando você restaura um banco de dados de um backup, por padrão, o banco de dados restaurado usa a mesma configuração de criptografia do backup. É possível substituir esse comportamento especificando uma configuração de criptografia diferente ao restaurar o banco de dados. Para restaurar um backup ativado para CMEK, a chave e a versão de chave usadas para criptografar o backup precisam estar disponíveis. Para mais informações, consulte Restaurar de um backup.
É possível realizar operações de backup, como criar, copiar e restaurar, em um banco de dados criptografado com várias chaves regionais.
Todos os backups criados por programações de backup podem ser protegidos por CMEK ou Google-owned and Google-managed encryption keys. Se você mudar a configuração de criptografia de um banco de dados cuja programação de backup incremental herda essa criptografia, o Spanner vai criar um novo backup completo com a configuração atualizada e iniciar uma nova cadeia de backup incremental.
Particionamento geográfico
É possível usar CMEK ou Google-owned and Google-managed encryption keys para proteger bancos de dados do Spanner que usam particionamento geográfico. Ao usar o particionamento geográfico, é necessário usar uma chave regional do Cloud KMS para cada local de réplica de instância, incluindo aquelas na configuração de partição da instância. Não há suporte para chaves multirregionais. Cada chave regional do Cloud KMS precisa estar localizada na mesma região que a réplica da instância do Spanner ou o local da partição da instância correspondente.
Por exemplo, se o banco de dados do Spanner estiver na configuração de instância multirregional nam3, com partições de instância localizadas em europe-west1 e europe-west2, será necessário criar chaves do Cloud KMS nas seguintes regiões:
us-east4(parte denam3)us-east1(parte denam3)us-central1(parte denam3)europe-west1(local da partição da instância)europe-west2(local da partição da instância)
Para mais informações, consulte Proteger um banco de dados com CMEK.
Logging
É possível auditar as solicitações que o Spanner envia ao Cloud KMS em seu nome no Logging, se você tiver ativado a geração de registros de auditoria para a API Cloud KMS no seu projeto. Essas entradas de registro do Cloud KMS ficam visíveis no Logging.
Exigir ou limitar CMEK na sua organização
É possível definir políticas para toda a organização sobre o uso da proteção de CMEK em vários produtos do Google Cloud , incluindo o Spanner. Com essas políticas, é possível:
Exigir que os novos bancos de dados do Spanner criados pela sua organização usem a proteção de CMEK.
Limitar quais chaves do Cloud KMS da sua organização estão disponíveis para proteção com CMEK.
Para mais informações, consulte Políticas da organização de CMEK.
A seguir
- Saiba como proteger um banco de dados com CMEK.