Políticas da organização de CMEK

O Google Cloud oferece duas restrições de política da organização para ajudar a garantir o uso do CMEK em uma organização:

• O constraints/gcp.restrictNonCmekServices é usado para exigir proteção CMEK.
• constraints/gcp.restrictCmekCryptoKeyProjects é usado para limitar quais chaves do Cloud KMS são usadas para proteção CMEK.

As políticas da organização de CMEK se aplicam apenas aos recursos recém-criados nos serviços do Google Cloud com suporte.

Funções exigidas

Para garantir que cada usuário tenha as permissões necessárias para verificar as políticas da organização ao criar recursos, peça ao administrador para conceder a cada usuário o papel do IAM de Visualizador de políticas da organização (roles/orgpolicy.policyViewer) na organização. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para verificar as políticas da organização ao criar recursos. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para verificar as políticas da organização ao criar recursos:

• Para conferir os detalhes completos da política da organização: orgpolicy.policy.get
• Para verificar a política da organização ao criar recursos: orgpolicy.policies.check

O administrador também pode conceder essa permissão a cada usuário com papéis personalizados ou outros papéis predefinidos.

Quando as políticas da organização estão ativas, a permissão orgpolicy.policies.check é necessária para usuários do console do Google Cloud que criam recursos protegidos por chaves CMEK. Os usuários sem essa permissão podem criar recursos protegidos por CMEK usando o console do Google Cloud, mas podem selecionar uma chave CMEK que não é permitida pela restrição restrictCmekCryptoKeyProjects. Quando uma chave que não atende a essa restrição é selecionada, a criação de recursos falha.

Observação: a permissão orgpolicy.policies.check não está visível no console do Google Cloud, mas foi adicionada a todos os papéis predefinidos que incluem a permissão orgpolicy.policy.get. Se a sua organização usa funções personalizadas e políticas da organização da CMEK, use a CLI gcloud para adicionar a permissão orgpolicy.policies.check a cada função que pode criar recursos. Para mais informações, consulte Como editar um papel personalizado.

Exigir proteção de CMEK

Para exigir a proteção do CMEK para sua organização, configure a política da organização constraints/gcp.restrictNonCmekServices.

Como uma restrição de lista, os valores aceitos são nomes de serviço do Google Cloud (por exemplo, sqladmin.googleapis.com). Use essa restrição fornecendo uma lista de nomes de serviço do Google Cloud e definindo a restrição como Deny. Essa configuração bloqueia a criação de recursos nesses serviços se o recurso não estiver protegido pela CMEK. Em outras palavras, as solicitações para criar um recurso no serviço não são bem-sucedidas sem especificar uma chave do Cloud KMS. Além disso, essa restrição bloqueia a remoção da proteção CMEK dos recursos nesses serviços. Essa restrição só pode ser aplicada a serviços com suporte.

Atenção: a criação de alguns tipos de recursos do Google Cloud pode acionar a criação de um tipo de recurso de um serviço diferente. Tenha cuidado ao configurar essa restrição em um ambiente com serviços que não oferecem suporte ao CMEK. Exigir a proteção de CMEK para um serviço compatível com CMEK pode impedir que um serviço não compatível com CMEK crie recursos e interrompa a funcionalidade normal.

Limitar o uso de chaves do Cloud KMS para CMEK

Para limitar quais chaves do Cloud KMS são usadas para proteção CMEK, configure a restrição constraints/gcp.restrictCmekCryptoKeyProjects.

Como uma restrição de lista, os valores aceitos são indicadores de hierarquia de recursos (por exemplo, projects/PROJECT_ID, under:folders/FOLDER_ID e under:organizations/ORGANIZATION_ID). Use essa restrição configurando uma lista de indicadores de hierarquia de recursos e definindo a restrição como Permitir. Essa configuração restringe os serviços com suporte para que as chaves CMEK possam ser escolhidas apenas nos projetos, pastas e organizações listados. As solicitações para criar recursos protegidos por CMEK em serviços configurados não são bem-sucedidas sem uma chave do Cloud KMS de um dos recursos permitidos. Quando configurada, essa restrição se aplica a todos os serviços com suporte.

Observação: essa restrição por si só não garante o uso de chaves de criptografia gerenciadas pelo cliente em projetos permitidos nos serviços especificados, porque outros métodos de criptografia podem estar disponíveis. Para impor o uso de chaves de criptografia gerenciadas pelo cliente em projetos permitidos, é preciso aplicar essa restrição e a restrição constraints/gcp.restrictNonCmekServices.

Serviços com suporte

Serviço	Valor de restrição ao exigir CMEK
AlloyDB para PostgreSQL	alloydb.googleapis.com
Apigee	apigee.googleapis.com
Application Integration	integrations.googleapis.com
Artifact Registry	artifactregistry.googleapis.com
BigQuery	bigquery.googleapis.com
Bigtable	bigtable.googleapis.com
Cloud Composer	composer.googleapis.com
Cloud Logging	logging.googleapis.com
Cloud Run	run.googleapis.com
Funções do Cloud Run	cloudfunctions.googleapis.com
Cloud SQL	sqladmin.googleapis.com
Cloud Storage	storage.googleapis.com
Cloud Workstations	workstations.googleapis.com
Colab Enterprise	aiplatform.googleapis.com
Compute Engine	compute.googleapis.com
Dataflow	dataflow.googleapis.com
Dataproc	dataproc.googleapis.com
Document AI	documentai.googleapis.com
Filestore	file.googleapis.com
Firestore	firestore.googleapis.com
Google Kubernetes Engine (pré-lançamento)	container.googleapis.com
Memorystore para Redis	redis.googleapis.com
Pub/Sub	pubsub.googleapis.com
Secret Manager	secretmanager.googleapis.com
Secure Source Manager	securesourcemanager.googleapis.com
Spanner	spanner.googleapis.com
Speech-to-Text	speech.googleapis.com
Vertex AI	aiplatform.googleapis.com
Vertex AI Agent Builder	discoveryengine.googleapis.com
Instâncias do Vertex AI Workbench	notebooks.googleapis.com

Políticas da organização de CMEK e o Serviço de transferência do Cloud Storage

Embora o Serviço de transferência do Cloud Storage não tenha uma integração com CMEK, ele pode ser usado com as políticas da organização de CMEK. Se você usa o Serviço de transferência do Cloud Storage e quer garantir que as credenciais do banco de dados armazenadas no Secret Manager sejam protegidas pela CMEK, adicione storagetransfer.googleapis.com e secretmanager.googleapis.com à restrição constraints/gcp.restrictNonCmekServices. Para mais informações, consulte a documentação do CMEK do Serviço de transferência do Cloud Storage.

Cuidado: se você adicionar storagetransfer.googleapis.com a essa restrição, mas não secretmanager.googleapis.com, a política da organização não vai funcionar como esperado.

Exceções de aplicação por tipo de recurso

As restrições de política da organização do CMEK são aplicadas ao criar um novo recurso ou ao alterar (quando disponível) a chave do Cloud KMS em um recurso existente. Geralmente, elas são aplicadas a todos os tipos de recursos de um serviço que oferece suporte a CMEK e são baseadas apenas na configuração do recurso. Confira algumas exceções importantes resumidas aqui:

Tipo de recurso	Exceção de aplicação
bigquery.googleapis.com/Dataset	Parcialmente aplicada à chave padrão do Cloud KMS para o conjunto de dados (somente gcp.restrictCmekCryptoKeyProjects).
bigquery.googleapis.com/Job	Somente jobs de consulta: aplicado à chave do Cloud KMS fornecida com a consulta ou padrão do projeto de faturamento. Consulte também a configuração separada da chave padrão do Cloud KMS do projeto.
bigquerydatatransfer.googleapis.com/TransferConfig	As configurações de transferência usam o nome de serviço do serviço de transferência de dados (bigquerydatatransfer.googleapis.com) para restrições de política da organização do CMEK.
container.googleapis.com/Cluster	(Pré-lançamento) Obrigatória na chave do Cloud KMS apenas para o disco de inicialização do nó. Não é obrigatória para os segredos na camada do aplicativo.
logging.googleapis.com/LogBucket	Aplicado a buckets de registro criados explicitamente. Consulte também a configuração separada necessária para garantir a conformidade dos buckets de registro integrados.
storage.googleapis.com/Bucket	Aplicada à chave padrão do Cloud KMS do bucket
storage.googleapis.com/Object	Aplicado independentemente do bucket. Consulte também a configuração separada da chave padrão do Cloud KMS do bucket.

Exemplos de configuração

Nos exemplos de configuração, suponha que a organização de exemplo tenha a seguinte hierarquia de recursos:

Observação: as políticas da organização CMEK se aplicam apenas aos recursos recém-criados nos serviços com suporte.

Exigir CMEK e limitar chaves para um projeto

Suponha que você queira exigir proteção CMEK para todos os recursos do Cloud Storage em projects/5 e garantir que apenas as chaves provenientes de projects/4 possam ser usadas.

Para exigir a proteção CMEK para todos os novos recursos do Cloud Storage, use a seguinte configuração da política da organização:

• Política da organização: constraints/gcp.restrictNonCmekServices
• Vinculação em: projects/5
• Tipo de política: Negar
• Valor da política: storage.googleapis.com

Para garantir que apenas as chaves de projects/4 sejam usadas, use a seguinte configuração:

• Política da organização: constraints/gcp.restrictCmekCryptoKeyProjects
• Vinculação em: projects/5
• Tipo de política: Permitir
• Valor da política: projects/4

Exigir CMEK e limitar as chaves a uma pasta

Como alternativa, suponha que você espera adicionar outros projetos do Cloud KMS em folders/2 no futuro e quer exigir a CMEK de forma mais ampla em folders/3. Para esse cenário, você precisa de configurações um pouco diferentes.

Para exigir proteção de CMEK adicional para novos recursos do Cloud SQL e do Cloud Storage em qualquer lugar em folders/3:

• Política da organização: constraints/gcp.restrictNonCmekServices
• Vinculação em: folders/3
• Tipo de política: Negar
• Valores da política: sqladmin.googleapis.com, storage.googleapis.com

Para garantir que apenas as chaves dos projetos do Cloud KMS em folders/2 sejam usadas:

• Política da organização: constraints/gcp.restrictCmekCryptoKeyProjects
• Vinculação em: folders/3
• Tipo de política: Permitir
• Valor da política: under:folders/2

Exigir CMEK para uma organização

Para exigir CMEK em todos os lugares da organização (em serviços com suporte), configure a restrição constraints/gcp.restrictNonCmekServices com a seguinte configuração:

• Política da organização: constraints/gcp.restrictNonCmekServices
• Vinculação em: organizations/1
• Tipo de política: Negar
• Valores da política: (todos os serviços com suporte)

Limitações

Se você usar o console do Google Cloud para criar um recurso, talvez não seja possível usar outras opções de criptografia além da CMEK quando constraints/gcp.restrictNonCmekServices estiver configurado para um projeto e serviço. A restrição da política da organização CMEK só fica visível quando a conta do cliente recebe a permissão orgpolicy.policy.get do IAM no projeto.

A seguir

Consulte Introdução ao serviço de política da organização para saber mais sobre os benefícios e casos de uso comuns das políticas da organização.

Para mais exemplos de como criar uma política da organização com restrições específicas, consulte Como usar restrições.