Os colaboradores de dados precisam configurar os seguintes recursos para que os dados confidenciais fiquem acessíveis para uma carga de trabalho:
Dados criptografados, armazenados em Google Cloud.
Um pool de Identidade da carga de trabalho (WIP) para autorizar a carga de trabalho. Depois que uma carga de trabalho é autorizada por um WIP, ela pode acessar e operar os dados confidenciais dos colaboradores de dados.
Além disso, os colaboradores de dados precisam escolher onde os resultados da carga de trabalho do Confidential Space são armazenados e se esses resultados são exclusivos para cada colaborador ou compartilhados. Por exemplo, é possível enviar o mesmo resultado para vários buckets do Cloud Storage que pertencem a cada colaborador de dados.
Armazenar seus dados criptografados
É possível usar qualquer serviço do Google Cloud que armazene dados para hospedar seus dados confidenciais. Por exemplo, é possível usar um dos seguintes serviços:
Verifique se esses dados estão criptografados em repouso, seja usando recursos integrados ou algo como o Cloud Key Management Service (Cloud KMS).
Autorizar a carga de trabalho com um WIP
Um WIP é o mecanismo que o Confidential Space usa para permitir que uma carga de trabalho externa acesse e trabalhe com seus dados confidenciais como uma identidade federada. Uma identidade federada é uma entidade externa tratada como se fosse um principal no seu próprio projeto, permitindo que você conceda papéis do IAM a ela para dar acesso a recursos específicos ou personificar contas de serviço para fazer o mesmo.
Como colaborador de dados, você configura um provedor dentro de um WIP que define as regras para entidades que se autenticam como uma identidade federada. Para o Confidential Space, é preciso definir o seguinte em um provedor:
Um serviço de atestado: esse serviço verifica se a carga de trabalho é uma instância de VM confidencial e, por fim, retorna um token de atestado do OpenID Connect (OIDC) ao provedor do WIP. O operador de carga de trabalho define o serviço de atestado usado, que precisa corresponder ao serviço de atestado adicionado ao provedor de WIP para que o acesso seja concedido.
Mapeamentos de atributos: atributos em tokens de acesso do Security Token Service que são mapeados para declarações feitas pela entidade de autenticação. Nesse caso, a instância de VM que está executando a carga de trabalho. As declarações são feitas pela própria instância de VM, pela imagem do Confidential Space e pelo contêiner de carga de trabalho, e transmitidas ao provedor de WIP pela carga de trabalho. Esses atributos são usados para itens como trilhas de auditoria no Cloud Logging e para conceder papéis pelo IAM com base em declarações de entidade de autenticação, como resumos de contêineres de imagem de carga de trabalho. Leia mais sobre mapeamentos de atributos.
Uma política de atestado: uma série de condições que as entidades de autenticação precisam transmitir para receber acesso, com base nas declarações que fazem.
Quando uma carga de trabalho é iniciada, o Confidential Space Launcher envia o relatório de atestação para um serviço de atestação definido pelo operador da carga de trabalho, que verifica a instância de VM confidencial e retorna um token de atestação OIDC. Esse token dura uma hora e é atualizado automaticamente.
O token de atestação é transmitido ao provedor do WIP pela carga de trabalho, e o provedor o usa para verificar se as declarações passam na política de atestação definida no provedor. Se isso acontecer, a carga de trabalho poderá acessar os recursos confidenciais.
Acesso a cargas de trabalho externas
Antes de configurar um WIP e um provedor, é preciso escolher como a carga de trabalho vai acessar seus recursos: acesso direto a recursos ou identidade temporária de conta de serviço.
Acesso direto a recursos
Recomendamos o método de acesso direto a recursos para cargas de trabalho.
Esse método envolve a configuração de uma identidade federada em um provedor de WIP vinculado às declarações de uma entidade de autenticação. Dessa forma, uma carga de trabalho pode ser autorizada a acessar recursos diretamente por meio de vinculações do IAM, com base em atributos como o resumo da imagem do contêiner da carga de trabalho.
O acesso direto a recursos tem as seguintes vantagens:
A configuração de um ambiente do Confidential Space requer menos etapas, já que os colaboradores de dados não precisam configurar contas de serviço para que uma conta de serviço de carga de trabalho as represente.
A carga de trabalho só pode acessar recursos específicos, conforme determinado pelo IAM. Esse método é mais seguro do que a identidade temporária de conta de serviço, em que contas de serviço com permissões excessivas ou direitos de identidade temporária podem fornecer a um usuário malicioso mais acesso do que o pretendido.
Cada acesso a recursos é registrado com uma identidade federada da instância de VM de carga de trabalho, em vez de uma identidade de conta de serviço representada que pode ser compartilhada por várias cargas de trabalho. A identidade de uma instância de VM de carga de trabalho pode incluir detalhes como o resumo da imagem de um contêiner, o número do projeto em que a carga de trabalho está operando e o ID da instância de VM que executa a carga de trabalho, fornecendo uma trilha de auditoria mais detalhada.
Não é necessário mapear a propriedade
selfLinkda instância de VM para o atributogoogle.subjectem um provedor de WIP. Valores muito longos deselfLinkpodem exceder o limite de 127 bytes desse atributo, fazendo com que a autenticação do provedor de WIP falhe.
Identidade temporária de conta de serviço
O método de identidade temporária de conta de serviço envolve cada colaborador de dados configurando uma conta de serviço para descriptografar os dados particulares e, em seguida, anexando essa conta de serviço ao próprio WIP. Eles também especificam a conta de serviço da carga de trabalho no provedor de WIP, o que permite que ela represente as contas de serviço dos colaboradores de dados para recuperar e operar os dados confidenciais deles.
A identidade temporária de conta de serviço só deve ser usada nos seguintes cenários:
Quando você precisa usar assinaturas de imagem como uma credencial de autenticação, já que a sintaxe usada pelas assinaturas não funciona com mapeamentos de atributos.
Ao acessar APIs que não são compatíveis com identidades federadas.
O método de identidade temporária de conta de serviço pode falhar ao autenticar em um provedor
de WIP se uma instância de VM tiver uma propriedade
selfLink
muito longa. Isso ocorre porque a declaração sub no token de atestado, que
é definida como o valor selfLink, é mapeada no provedor WIP para o
atributo google.subject, que tem um limite de 127 bytes.
Para valores de selfLink de instância de VM que excedem 127 bytes, renomeie as instâncias de VM para encurtar o selfLink ou use o método de acesso direto a recursos.
Configurar um WIP e um provedor
As etapas para configurar um provedor mudam dependendo se você usa o acesso direto a recursos ou a identidade temporária de conta de serviço.
Acesso direto a recursos
O método de acesso direto a recursos envolve a configuração de um WIP e de um provedor, além da configuração de papéis do IAM com base em um resumo de imagem do contêiner de carga de trabalho específico.
Configurar um WIP e um provedor
Para configurar um WIP e um provedor, siga estas instruções:
Crie o WIP:
gcloud iam workload-identity-pools create DATA_COLLABORATOR_POOL_NAME \ --location=globalCrie um provedor OIDC no WIP:
gcloud iam workload-identity-pools providers create-oidc attestation-verifier \ --location=global \ --workload-identity-pool=DATA_COLLABORATOR_POOL_NAME \ --issuer-uri="ISSUER_URI" \ --allowed-audiences="https://sts.googleapis.com" \ --attribute-mapping="google.subject=\"gcpcs::\"+assertion.submods.container.image_digest+\"::\"+assertion.submods.gce.project_number+\"::\"+assertion.submods.gce.instance_id,attribute.image_digest=assertion.submods.container.image_digest" \ --attribute-condition="assertion.swname == 'CONFIDENTIAL_SPACE' \ && 'STABLE' in assertion.submods.confidential_space.support_attributes"Este exemplo usa os seguintes valores:
Um
issuer-urique corresponde ao serviço de atestação que você está usando:Google Cloud Attestation:
https://confidentialcomputing.googleapis.comIntel Trust Authority:
https://portal.trustauthority.intel.com
Um
allowed-audiencesdehttps://sts.googleapis.com. Esse é o Security Token Service do Google, que troca credenciais por tokens de acesso.Um
attribute-mappingdegoogle.subject, com o seguinte valor:\"gcpcs::\"+assertion.submods.container.image_digest+\"::\"+assertion.submods.gce.project_number+\"::\"+assertion.submods.gce.instance_id,attribute.image_digest=assertion.submods.container.image_digestEsse valor é construído usando a Common Expression Language (CEL). Os valores a seguir são atribuídos ao atributo
gcpcse aparecem no Cloud Logging sempre que a carga de trabalho acessa recursos:assertion.submods.container.image_digest: o resumo da imagem do contêiner da carga de trabalho.assertion.submods.gce.project_number: o número do projeto da instância de VM.assertion.submods.gce.instance_id: o ID da instância de VM.
Além disso,
attribute.image_digesté definido comoassertion.submods.container.image_digest, o resumo da imagem do contêiner da carga de trabalho. Esse atributo é mapeado para que você possa conceder os papéis do IAM de identidade federada com base em um resumo de imagem específico.É possível mapear qualquer uma das declarações de carga de trabalho disponíveis, desde que o tamanho total do valor
google.subjectseja menor que 127 bytes.Os
attribute-conditionsa seguir, que formam uma política de atestado. Se essas condições corresponderem às declarações da carga de trabalho, ela poderá acessar os recursos confidenciais como uma identidade federada:assertion.swname == 'CONFIDENTIAL_SPACE': verifica se o Confidential Space é o software em execução na VM, com todas as garantias de segurança integradas.'STABLE' in assertion.submods.confidential_space.support_attributes: verifica se a imagem de produção do Confidential Space está sendo usada e tem o atributo de suporteSTABLE.
Para mais condições de atributo que podem ser usadas, consulte Criar uma política de atestado.
Conceder os papéis do IAM de identidade federada
Depois de criar um provedor de WIP, é possível conceder à identidade federada um papel do IAM com base em se o resumo do contêiner de imagem da carga de trabalho da identidade corresponde a um valor esperado.
O exemplo a seguir demonstra como conceder a uma identidade federada a capacidade de descriptografar uma chave específica do Cloud Key Management Service:
gcloud kms keys add-iam-policy-binding \
projects/DATA_COLLABORATOR_PROJECT_ID/locations/global/keyRings/DATA_COLLABORATOR_KEYRING_NAME/cryptoKeys/DATA_COLLABORATOR_KEY_NAME \
--member="principalSet://iam.googleapis.com/projects/DATA_COLLABORATOR_PROJECT_NUMBER/locations/global/workloadIdentityPools/DATA_COLLABORATOR_POOL_NAME/attribute.image_digest/WORKLOAD_CONTAINER_IMAGE_DIGEST" \
--role=roles/cloudkms.cryptoKeyDecrypter
Identidade temporária de conta de serviço
O método de identidade temporária de conta de serviço envolve o seguinte:
Criar contas de serviço em cada um dos projetos de colaboradores de dados e conceder a elas permissão para descriptografar os dados confidenciais.
Criar WIPs em cada um dos projetos de colaboradores de dados e, em seguida, anexar a conta de serviço recém-criada de cada projeto ao WIP.
Criar provedores de WIP em cada WIP, que especificam a conta de serviço da carga de trabalho como a conta que tem permissão para representar as contas de serviço do colaborador de dados.
Configurar contas de serviço para descriptografar dados confidenciais
Crie as contas de serviço nos projetos de colaborador de dados:
gcloud iam service-accounts create DATA_COLLABORATOR_SERVICE_ACCOUNT_NAMEConceda às contas de serviço as permissões necessárias para descriptografar os dados confidenciais. Por exemplo, é possível criptografar arquivos confidenciais no Cloud Storage com o Cloud KMS. Portanto, é necessário conceder à conta de serviço permissão para descriptografar esses dados:
gcloud kms keys add-iam-policy-binding \ projects/DATA_COLLABORATOR_PROJECT_ID/locations/global/keyRings/DATA_COLLABORATOR_KEYRING_NAME/cryptoKeys/DATA_COLLABORATOR_KEY_NAME \ --member=serviceAccount:DATA_COLLABORATOR_SERVICE_ACCOUNT_NAME@DATA_COLLABORATOR_PROJECT_ID.iam.gserviceaccount.com \ --role=roles/cloudkms.cryptoKeyDecrypter
Configurar um WIP e um provedor
Para configurar um WIP e um provedor, siga estas instruções em cada projeto de colaborador de dados:
Crie o WIP:
gcloud iam workload-identity-pools create DATA_COLLABORATOR_POOL_NAME \ --location=globalAnexe a conta de serviço que será personificada ao WIP, com o papel
roles/iam.workloadIdentityUser:gcloud iam service-accounts add-iam-policy-binding \ DATA_COLLABORATOR_SERVICE_ACCOUNT_NAME@DATA_COLLABORATOR_PROJECT_ID.iam.gserviceaccount.com \ --member="principalSet://iam.googleapis.com/projects/DATA_COLLABORATOR_PROJECT_NUMBER/locations/global/workloadIdentityPools/DATA_COLLABORATOR_POOL_NAME/*" \ --role=roles/iam.workloadIdentityUserCrie um provedor OIDC no WIP e defina a conta de serviço da carga de trabalho nele para que ela possa personificar a conta de serviço do colaborador de dados:
gcloud iam workload-identity-pools providers create-oidc attestation-verifier \ --location=global \ --workload-identity-pool=DATA_COLLABORATOR_POOL_NAME \ --issuer-uri="https://confidentialcomputing.googleapis.com/" \ --allowed-audiences="https://sts.googleapis.com" \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="assertion.submods.container.image_digest == 'WORKLOAD_CONTAINER_IMAGE_DIGEST' \ && 'WORKLOAD_SERVICE_ACCOUNT_NAME@WORKLOAD_OPERATOR_PROJECT_ID.iam.gserviceaccount.com' in assertion.google_service_accounts \ && assertion.swname == 'CONFIDENTIAL_SPACE' \ && 'STABLE' in assertion.submods.confidential_space.support_attributes"Este exemplo usa os seguintes valores:
Um
issuer-uridehttps://confidentialcomputing.googleapis.com/, o que significa que o Google Cloud Attestation é usado como o serviço de atestação.Um
allowed-audiencesdehttps://sts.googleapis.com. Esse é o Security Token Service do Google, que troca credenciais por tokens de acesso.Um
attribute-mappingdegoogle.subject, com o valorassertion.sub. Esse é oselfLinkda instância de VM, conforme definido na declaraçãosubno token de atestado.A instância de VM
selfLinkaparece no Cloud Logging sempre que a carga de trabalho acessa recursos.Os
attribute-conditionsa seguir, que formam uma política de atestado. Se essas condições corresponderem às declarações da carga de trabalho, ela poderá acessar recursos como uma identidade federada:assertion.submods.container.image_digest == 'WORKLOAD_CONTAINER_IMAGE_DIGEST': verifica se o resumo da imagem do contêiner da carga de trabalho corresponde ao valor esperado.'WORKLOAD_SERVICE_ACCOUNT_NAME@WORKLOAD_PROJECT_ID.iam.gserviceaccount.com' in assertion.google_service_accounts: verifica se a conta de serviço anexada à carga de trabalho corresponde à conta de serviço esperada e a usa para representar a conta de serviço do colaborador de dados.assertion.swname == 'CONFIDENTIAL_SPACE': verifica se o Confidential Space é o software em execução na VM, com todas as garantias de segurança integradas.'STABLE' in assertion.submods.confidential_space.support_attributes: verifica se a imagem de produção do Confidential Space está sendo usada e tem o atributo de suporteSTABLE.
Para mais condições de atributo que podem ser usadas, consulte Criar uma política de atestado.
Criar uma política de atestado
Como parte da criação de um WIP, você precisa criar uma política de atestado. As declarações de uma entidade de autenticação precisam corresponder à sua política para que ela possa acessar seus dados.
As políticas são escritas em
Common Expression Language
(CEL) e são compostas por uma série de instruções que podem ser encadeadas
com o operador &&.
As instruções usam declarações da imagem do Confidential Space, da imagem do contêiner de carga de trabalho ou da instância de VM como variáveis, e o valor especificado como a expressão.
Por exemplo, veja uma política que impõe que a carga de trabalho use o
Confidential Space, use uma
imagem do Confidential Space STABLE
e que a zona em que a instância de VM da carga de trabalho está em execução seja
us-central1-a:
assertion.swname == 'CONFIDENTIAL_SPACE' \
&& 'STABLE' in assertion.submods.confidential_space.support_attributes" \
&& assertion.submods.gce.zone == "us-central1-a"
Consulte declarações de atestado para mais informações.
Declarações de atestado
As declarações disponíveis para criar uma política de atestado são detalhadas na tabela a seguir. As políticas podem validar declarações feitas pela imagem do Confidential Space, pelo contêiner de carga de trabalho e pela instância de VM.
Declarações de imagem
| Declaração | Tipo | Descrição | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Interage com:
|
Enumeração |
Verifica se a imagem do Confidential Space é a versão de depuração ou produção. Os valores válidos são os seguintes:
ExemplosO código a seguir verifica se a versão de depuração da imagem do Confidential Space está sendo usada: O código a seguir verifica se a versão de produção da imagem do Confidential Space está sendo usada: |
||||||||||
assertion.submods.confidential_space.support_attributes
|
Matriz de strings |
Verifica se a versão de segurança do TEE é uma imagem de produção do Confidential Space. As imagens de depuração do Confidential Space não têm um atributo de suporte definido. A tabela a seguir descreve os atributos de suporte encontrados nas imagens de produção do Confidential Space.
Recomendamos manter a imagem do Confidential Space atualizada. Para saber como atualizar sua imagem do Confidential Space, consulte Atualizar imagens do Confidential Space. ExemploO código a seguir verifica se uma versão estável da imagem do Confidential Space está sendo usada: |
||||||||||
assertion.swname |
Enumeração |
Verifica o software em execução na entidade de atestado. O valor sempre é Exemplo |
||||||||||
assertion.swversion |
Matriz de strings |
Verifica a versão do software da imagem do Confidential Space. Recomendamos
usar
Exemplo |
Declarações de contêiner
| Declaração | Tipo | Descrição |
|---|---|---|
|
Interage com:
|
Matriz de strings |
Verifica os comandos e parâmetros do CMD usados na imagem da carga de trabalho. ExemplosO código a seguir verifica se o CMD da imagem da carga de trabalho não foi substituído:
O código a seguir verifica se |
|
Interage com:
|
objeto JSON |
Verifica se as variáveis de ambiente e os respectivos valores foram transmitidos explicitamente para o contêiner. Exemplo
O código a seguir verifica se a variável de ambiente
|
|
Interage com:
|
String |
Verifica se o operador de carga de trabalho substituiu as variáveis de ambiente no contêiner. Exemplos
O código a seguir verifica se o operador de carga de trabalho não
substituiu a variável de ambiente O código a seguir verifica se o operador da carga de trabalho não substituiu nenhuma variável de ambiente: |
assertion.submods.container.image_digest |
String |
Verifica o resumo da imagem do contêiner da carga de trabalho. Especificar essa condição permite que várias partes concordem com uma carga de trabalho autorizada que tenha permissão para acessar os dados delas. Exemplo |
assertion.submods.container.image_id |
String |
Verifica o ID da imagem do contêiner da carga de trabalho. Exemplo |
|
Interage com:
|
String |
Verifica o local do contêiner de carga de trabalho em execução sobre a imagem do Confidential Space. Exemplo |
|
Interage com:
|
objeto JSON |
Verifica se a imagem tem uma determinada assinatura ou se é assinada por uma chave pública e um algoritmo de assinatura. Especificar essa condição permite que várias partes concordem com uma carga de trabalho autorizada que tenha permissão para acessar os dados delas. A declaração pode incluir os seguintes elementos:
Exemplo |
|
Interage com:
|
Enumeração |
Verifica a política de reinicialização do inicializador do contêiner para quando a carga de trabalho é interrompida. Os valores válidos são os seguintes:
Exemplo |
Declarações de VM
| Declaração | Tipo | Descrição |
|---|---|---|
|
Interage com:
|
Matriz de strings |
Verifica se uma conta de serviço especificada está conectada à VM
que está executando a carga de trabalho ou se foi listada usando
Exemplo |
assertion.hwmodel |
String |
Verifica a tecnologia de Computação Confidencial. As plataformas compatíveis são as seguintes:
Exemplo |
|
Interage com:
|
Booleano |
Verifica o estado de monitoramento na entidade de atestado. Exemplo |
assertion.submods.gce.instance_id |
String |
Verifica o ID da instância de VM. Exemplo |
assertion.submods.gce.instance_name |
String |
Verifica o nome da instância de VM. Exemplo |
assertion.submods.gce.project_id |
String |
Verifica se a VM está executando um projeto do Google Cloud com o ID do projeto especificado. Exemplo |
assertion.submods.gce.project_number |
String |
Verifica se a VM está em execução em um projeto do Google Cloud com o número de projeto especificado. Exemplo |
|
Interage com:
|
String |
Verifica se a VM está em execução na zona especificada. Exemplo |
|
Interage com:
|
Enumeração |
Verifica os recursos de Computação Confidencial compatíveis com uma
GPU NVIDIA. Somente o modo de passagem de GPU única (SPT, na sigla em inglês) é compatível
com o Confidential Space. Portanto, o valor é sempre Para mais informações sobre o suporte à Computação Confidencial da NVIDIA, consulte Soluções de computação confiável da NVIDIA (PDF). Exemplo |
|
Interage com:
|
Enumeração |
Verifica o status do driver de Computação Confidencial da NVIDIA. Os valores válidos são os seguintes:
Exemplo |
|
Interage com:
|
Matriz de objetos |
Verifica as declarações de cada GPU NVIDIA atestada. O Confidential Space aceita apenas uma declaração de GPU. Um objeto { "hwmodel": "GCP_NVIDIA_H100", "ueid": "490457405999046854973671575630853621547794591064", "l4_serial_number": "1216669666319372030078", "driver_version": "570.00", "vbios_version": "96.00.9F.00.01" } ExemplosO código a seguir verifica se o primeiro modelo de hardware de GPU é uma NVIDIA H100 em execução no Google Cloud: O código a seguir verifica se a declaração de atestado tem declarações relacionadas à GPU: |