Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Neste artigo, utiliza a CLI do Azure para implementar um cluster do Azure Kubernetes Service (AKS) e configurar contentores confidenciais (pré-visualização) com uma política de segurança gerada automaticamente. Em seguida, você implanta um aplicativo como um contêiner confidencial. Para saber mais, leia a Visão Geral dos contentores AKS Confidential.
De um modo geral, começar com os contentores AKS Confidential envolve os seguintes passos.
- Implemente ou atualize um cluster AKS usando a CLI do Azure.
- Adicione uma anotação ao manifesto YAML do seu pod para assinalar que o pod utiliza contentores confidenciais.
- Adicione uma política de segurança ao manifesto YAML do seu pod.
- Implemente a sua aplicação em computação confidencial.
Importante
A partir de 30 de novembro de 2025, o Azure Kubernetes Service (AKS) deixou de suportar nem fornecer atualizações de segurança para o Azure Linux 2.0. A imagem do nó Azure Linux 2.0 está congelada no 202512.06.0 lançamento. A partir de 31 de outubro de 2026, as imagens dos nós serão removidas e não poderá escalar os seus pools de nós. Migre para uma versão Azure Linux suportada atualizando os seus pools de nós para uma versão Kubernetes suportada ou migrando para o osSku AzureLinux3. Para mais informações, consulte a edição do Retirement GitHub e o anúncio de reforma do Azure Updates. Para se manter informado sobre anúncios e atualizações, siga as notas de lançamento do AKS.
Pré-requisitos
- A versão mais recente do CLI do Azure. Execute
az versionpara localizar a versão e executeaz upgradepara atualizar a versão. Se precisar de instalar ou atualizar, veja Install CLI do Azure (Instalar o CLI do Azure). - A versão mais recente da extensão CLI do
aks-previewAzure. - A versão mais recente da
confcomextensão Confidential Container CLI do Azure.confcomé necessário para gerar uma política de segurança. - Uma identidade de carga de trabalho e uma credencial de identidade federada. A credencial de identidade de carga de trabalho permite que os aplicativos Kubernetes acessem os recursos do Azure com segurança com uma ID do Microsoft Entra com base em contas de serviço anotadas. Se você não estiver familiarizado com o ID de Carga de Trabalho do Microsoft Entra, consulte a Visão geral do ID de Carga de Trabalho do Microsoft Entra e analise como a Identidade da Carga de Trabalho funciona com o AKS.
- A identidade que você está usando para criar seu cluster tem as permissões mínimas apropriadas. Para obter mais informações sobre acesso e identidade para AKS, consulte Opções de acesso e identidade para o Serviço Kubernetes do Azure (AKS).
- Para gerir um cluster Kubernetes, utilize o cliente de linha de comandos do Kubernetes kubectl. O Azure Cloud Shell vem com
kubectl. Podes instalarkubectllocalmente usando oaz aks install-clicomando. - Os contentores confidenciais no AKS fornecem um contentor sidecar de código aberto para atestado e libertação segura de chaves. O sidecar integra-se com um KMS (Serviço de Gerenciamento de Chaves), como o Azure Key Vault, para liberar uma chave para o grupo de contêineres após a conclusão da validação. A implantação de um HSM (Módulo de Segurança de Hardware) gerenciado pelo Azure Key Vault é opcional, mas recomendada para dar suporte à integridade e ao atestado no nível do contêiner. Consulte Aprovisionar e ativar um Managed HSM para implementar o Managed HSM.
Instala a extensão aks-preview CLI do Azure
Importante
As funcionalidades de pré-visualização do AKS estão disponíveis num regime de autosserviço e de adesão voluntária. As visualizações prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões de pré-visualização do AKS são apenas parcialmente abrangidas pelo suporte ao cliente, na medida do possível. Como tal, estas funcionalidades não se destinam a utilização em produção. Para obter mais informações, consulte os seguintes artigos de suporte:
Execute o seguinte comando para instalar a
aks-previewextensão:az extension add --name aks-previewExecute o seguinte comando para atualizar para a versão mais recente da extensão:
az extension update --name aks-preview
Instala a extensão confcom CLI do Azure
Execute o seguinte comando para instalar a
confcomextensão:az extension add --name confcomExecute o seguinte comando para atualizar para a versão mais recente da extensão:
az extension update --name confcom
Registar o sinalizador de funcionalidade KataCcIsolationPreview
Execute o comando
az feature registerpara registar o sinalizador de funcionalidadeKataCcIsolationPreview, conforme ilustrado no exemplo seguinte:az feature register --namespace "Microsoft.ContainerService" --name "KataCcIsolationPreview"Espere alguns minutos até que o estado apareça como Registado. Execute o
az feature showcomando para verificar o estado do registo:az feature show --namespace "Microsoft.ContainerService" --name "KataCcIsolationPreview"Quando o estado mostrar Registado, execute o comando
az provider registerpara atualizar o registo do fornecedor de recursos Microsoft.ContainerService:az provider register --namespace "Microsoft.ContainerService"
Crie um cluster com contentores Confidenciais ativados
Crie um cluster AKS usando o
az aks createcomando. Especifique os parâmetros seguintes:- --os-sku: AzureLinux. Apenas o Azure Linux os-sku suporta esta funcionalidade nesta versão de pré-visualização.
- --node-vm-size: Qualquer tamanho de VM do Azure que suporte virtualização aninhada para VMs filhas protegidas por AMD SEV-SNP funciona. Por exemplo, Standard_DC8as_cc_v5 VMs.
- --enable-workload-identity: Permite criar um ID de carga de trabalho Microsoft Entra para que os pods possam usar uma identidade Kubernetes.
- --enable-oidc-issuer: Habilita o emissor OpenID Connect (OIDC). Permite que um Microsoft Entra ID ou outra plataforma de gestão de identidade e acesso de fornecedor cloud descubra as chaves públicas de assinatura do servidor API.
- --workload-runtime: Especifique KataCcIsolation para ativar a funcionalidade de contentores confidenciais no conjunto de nós.
az aks create --resource-group myResourceGroup --name myAKSCluster --os-sku AzureLinux --node-vm-size Standard_DC8as_cc_v5 --workload-runtime KataCcIsolation --node-count 1 --enable-oidc-issuer --enable-workload-identity --generate-ssh-keysApós alguns minutos, o comando termina e devolve informação em formato JSON sobre o cluster.
Quando o cluster estiver pronto, obtenha as credenciais do cluster usando o
az aks get-credentialscomando.az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
Ativar contentores Confidenciais num cluster existente
Para usar esse recurso com um cluster AKS existente, os seguintes requisitos devem ser atendidos:
- Siga os passos para registar o
KataCcIsolationPreviewindicador de funcionalidade. - Ative a identidade da carga de trabalho no cluster, caso ainda não esteja ativada.
Adicionar um pool de nós com contentores confidenciais ativados
Utilize o seguinte comando para ativar os Contentores Confidenciais (pré-visualização), criando um pool de nós para os alojar.
Adiciona um conjunto de nós ao teu cluster AKS usando o
az aks nodepool addcomando. Especifique os parâmetros seguintes:- --resource-group: Insira o nome de um grupo de recursos existente para criar o cluster AKS.
- --cluster-name: Insira um nome exclusivo para o cluster AKS, como myAKSCluster.
- --name: Introduza um nome único para o pool de nós do seu cluster, como nodepool2.
-
--workload-runtime: Especifique KataCcIsolation para habilitar a funcionalidade no pool de nós. Juntamente com o
--workload-runtimeparâmetro, estes outros parâmetros satisfazem os seguintes requisitos. Caso contrário, o comando falha e reporta um problema com os parâmetros correspondentes. - --os-sku: AzureLinux. Apenas o Azure Linux os-sku suporta esta funcionalidade nesta versão de pré-visualização.
- --node-vm-size: Qualquer tamanho de VM do Azure que suporte virtualização aninhada para VMs filhas protegidas por AMD SEV-SNP funciona. Por exemplo, Standard_DC8as_cc_v5 VMs.
O exemplo a seguir adiciona um pool de nós de usuário a myAKSCluster com dois nós em nodepool2 no myResourceGroup:
az aks nodepool add --resource-group myResourceGroup --name nodepool2 --cluster-name myAKSCluster --node-count 2 --os-sku AzureLinux --node-vm-size Standard_DC8as_cc_v5 --workload-runtime KataCcIsolationApós alguns minutos, o comando conclui e retorna informações formatadas em JSON sobre o cluster.
Execute o
az aks updatecomando para reconciliar a configuração do cluster após adicionar o pool de nós dos containers Confidential.az aks update --name myAKSCluster --resource-group myResourceGroupApós alguns minutos, o comando conclui e retorna informações formatadas em JSON sobre o cluster.
Quando o cluster estiver pronto, obtenha as credenciais do cluster usando o
az aks get-credentialscomando.az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
Implementar e configurar a identidade da carga de trabalho
Antes de configurar o acesso ao Cofre da Chave do Azure e ao segredo e implantar um aplicativo como um contêiner Confidencial, você precisa concluir a configuração da identidade da carga de trabalho.
Para configurar a identidade da carga de trabalho, execute as seguintes etapas descritas no artigo Implantar e configurar a identidade da carga de trabalho:
- Recuperar o URL do emissor OIDC
- Criar uma identidade gerenciada
- Criar conta de serviço do Kubernetes
- Estabelecer credencial de identidade federada
Importante
Para continuar este tutorial, defina as variáveis de ambiente da secção Exportar variáveis ambientais no artigo Deployment and configure workload identity . Defina a variável SERVICE_ACCOUNT_NAMESPACE para kafka, e execute o comando kubectl create namespace kafka antes de configurar a identidade da carga de trabalho.
Implante um aplicativo confiável com kata-cc e contêiner de atestado
Os passos seguintes configuram a encriptação de ponta a ponta para mensagens Kafka usando chaves de encriptação geridas pelos Módulos de Segurança de Hardware Geridos do Azure (HSM Geridos). A chave só é disponibilizada quando o consumidor do Kafka é executado num Contentor Confidencial com um contentor de aprovisionamento de segredos de atestação do Azure injetado no pod.
Esta configuração baseia-se nos seguintes três componentes:
- Cluster Kafka: um cluster Kafka simples implantado no namespace Kafka no cluster.
- Kafka Producer: Um produtor Kafka a executar como um pod Kubernetes simples que envia mensagens encriptadas definidas pelo utilizador utilizando uma chave pública para um tópico Kafka.
- Consumidor Kafka: Um pod consumidor Kafka que é executado com o ambiente de execução kata-cc, recupera a chave privada de um contentor seguro de disponibilização de chaves para desencriptar mensagens do Kafka e apresenta as mensagens numa interface web.
Para esta versão de visualização, recomendamos para fins de teste e avaliação criar ou usar um recurso de camada Premium existente do Azure Key Vault para dar suporte ao armazenamento de chaves em um módulo de segurança de hardware (HSM). Não recomendamos utilizar o cofre de chaves de produção. Se você não tiver um Cofre de Chaves do Azure, consulte Criar um cofre de chaves usando a CLI do Azure.
Conceda acesso ao Key Vault à identidade gerida que criou anteriormente e à sua conta. Atribua a ambas as identidades as funções Key Vault Crypto Officer e Key Vault Crypto User do Azure RBAC.
Nota
A identidade gerenciada é o valor atribuído à
USER_ASSIGNED_IDENTITY_NAMEvariável.Para adicionar atribuições de função, você deve ter
Microsoft.Authorization/roleAssignments/writeeMicrosoft.Authorization/roleAssignments/deletepermissões, como Administrador de Acesso a Dados do Cofre de Chaves, Administrador de Acesso de Usuário ou Proprietário.Você deve usar o Key Vault Premium SKU para suportar chaves protegidas por HSM.
Execute o seguinte comando para definir o escopo:
AKV_SCOPE=$(az keyvault show --name <AZURE_AKV_RESOURCE_NAME> --query id --output tsv)Execute o seguinte comando para atribuir a função Key Vault Crypto Officer .
az role assignment create --role "Key Vault Crypto Officer" --assignee "${USER_ASSIGNED_IDENTITY_NAME}" --scope $AKV_SCOPEExecute o seguinte comando para atribuir a função Key Vault Crypto User .
az role assignment create --role "Key Vault Crypto User" --assignee "${USER_ASSIGNED_IDENTITY_NAME}" --scope $AKV_SCOPEInstale o cluster Kafka no namespace kafka executando o seguinte comando:
kubectl create -f 'https://strimzi.io/install/latest?namespace=kafka' -n kafkaExecute o comando seguinte para aplicar o ficheiro CR do cluster
kafka.kubectl apply -f https://strimzi.io/examples/latest/kafka/kafka-persistent-single.yaml -n kafkaPrepare a chave de encriptação/desencriptação RSA utilizando o script bash para o workload do GitHub. Guarde o ficheiro como
setup-key.sh.Defina a variável de ambiente
MAA_ENDPOINTcom o FQDN da URI de atestação, ao executar o seguinte comando.export MAA_ENDPOINT="$(az attestation show --name "myattestationprovider" --resource-group "MyResourceGroup" --query 'attestUri' -o tsv | cut -c 9-)"Verifique se o FQDN do URI do Attest está no formato correto (o MAA_ENDPOINT não deve incluir o prefixo "https://"):
echo $MAA_ENDPOINTNota
Para configurar o Atestado do Microsoft Azure, consulte Guia de início rápido: configurar o Atestado do Azure com a CLI do Azure.
Copie o seguinte manifesto YAML e salve-o como
consumer.yaml.apiVersion: v1 kind: Pod metadata: name: kafka-golang-consumer namespace: kafka labels: azure.workload.identity/use: "true" app.kubernetes.io/name: kafka-golang-consumer spec: serviceAccountName: workload-identity-sa runtimeClassName: kata-cc-isolation containers: - image: "mcr.microsoft.com/aci/skr:2.7" imagePullPolicy: Always name: skr env: - name: SkrSideCarArgs value: ewogICAgImNlcnRjYWNoZSI6IHsKCQkiZW5kcG9pbnRfdHlwZSI6ICJMb2NhbFRISU0iLAoJCSJlbmRwb2ludCI6ICIxNjkuMjU0LjE2OS4yNTQvbWV0YWRhdGEvVEhJTS9hbWQvY2VydGlmaWNhdGlvbiIKCX0gIAp9 command: - /bin/skr volumeMounts: - mountPath: /opt/confidential-containers/share/kata-containers/reference-info-base64 name: endor-loc - image: "mcr.microsoft.com/acc/samples/kafka/consumer:1.0" imagePullPolicy: Always name: kafka-golang-consumer env: - name: SkrClientKID value: kafka-encryption-demo - name: SkrClientMAAEndpoint value: sharedeus2.eus2.test.attest.azure.net - name: SkrClientAKVEndpoint value: "myKeyVault.vault.azure.net" - name: TOPIC value: kafka-demo-topic command: - /consume ports: - containerPort: 3333 name: kafka-consumer resources: limits: memory: 1Gi cpu: 200m volumes: - name: endor-loc hostPath: path: /opt/confidential-containers/share/kata-containers/reference-info-base64 --- apiVersion: v1 kind: Service metadata: name: consumer namespace: kafka spec: type: LoadBalancer selector: app.kubernetes.io/name: kafka-golang-consumer ports: - protocol: TCP port: 80 targetPort: kafka-consumerNota
Atualize o valor da variável
SkrClientAKVEndpointde ambiente pod para corresponder à URL do seu Cofre da Chave do Azure, excluindo o valorhttps://do protocolo . O valor atual do marcador de posição émyKeyVault.vault.azure.net. Atualize o valor da variávelSkrClientMAAEndpointde ambiente pod com o valor deMAA_ENDPOINT. Você pode encontrar o valor deMAA_ENDPOINTexecutando o comandoecho $MAA_ENDPOINTou o comandoaz attestation show --name "myattestationprovider" --resource-group "MyResourceGroup" --query 'attestUri' -o tsv | cut -c 9-.Gere a política de segurança para o manifesto YAML do consumidor Kafka e obtenha o hash da política de segurança armazenada na
WORKLOAD_MEASUREMENTvariável executando o seguinte comando:export WORKLOAD_MEASUREMENT=$(az confcom katapolicygen -y consumer.yaml --print-policy | base64 -d | sha256sum | cut -d' ' -f1)Para gerar um par de chaves assimétricas RSA (chaves pública e privada), execute o
setup-key.shscript usando o seguinte comando. O<Azure Key Vault URL>valor deve ser<your-unique-keyvault-name>.vault.azure.netexport MANAGED_IDENTITY=${USER_ASSIGNED_CLIENT_ID} bash setup-key.sh "kafka-encryption-demo" <Azure Key Vault URL>Nota
O script
setup-key.shBash requer a variável de ambienteMANAGED_IDENTITY.A chave pública será guardada como
kafka-encryption-demo-pub.pemapós a execução do script Bash.
Importante
Se receber o erro
ForbiddenByRbac, espere até 24 horas. Os serviços de bastidor para identidades geridas mantêm uma cache por cada URI de recurso durante até 24 horas. Para obter mais informações, consulte Solucionar problemas do Azure RBAC.Para verificar se as chaves foram carregadas com êxito no cofre de chaves, execute os seguintes comandos:
az account set --subscription <Subscription ID> az keyvault key list --vault-name <KeyVault Name> -o tableCopie o seguinte manifesto YAML e salve-o como
producer.yaml.apiVersion: v1 kind: Pod metadata: name: kafka-producer namespace: kafka spec: containers: - image: "mcr.microsoft.com/acc/samples/kafka/producer:1.0" name: kafka-producer command: - /produce env: - name: TOPIC value: kafka-demo-topic - name: MSG value: "Azure Confidential Computing" - name: PUBKEY value: |- -----BEGIN PUBLIC KEY----- MIIBojAN***AE= -----END PUBLIC KEY----- resources: limits: memory: 1Gi cpu: 200mNota
Atualize o valor que começa com a cadeia de caracteres
-----BEGIN PUBLIC KEY-----e termina com a cadeia de caracteres-----END PUBLIC KEY-----com o conteúdo dekafka-encryption-demo-pub.pem, que foi criado no passo anterior.Implemente os manifestos YAML
consumereproducerutilizando os ficheiros que guardou anteriormente.kubectl apply -f consumer.yamlkubectl apply -f producer.yamlObtenha o endereço IP do serviço Web usando o seguinte comando:
kubectl get svc consumer -n kafkaCopie e cole o endereço IP externo do serviço ao consumidor no seu navegador e observe a mensagem desencriptada.
O exemplo a seguir é semelhante à saída do comando:
Welcome to Confidential containers on AKS! Encrypted Kafka Message: Msg 1: Azure Confidential ComputingTambém deve tentar executar o consumidor como um pod normal do Kubernetes, removendo a especificação
skr containerekata-cc runtime class. Como não está a executar o consumidor com a classe de execução kata-cc, já não precisa da política.Remova toda a política e observe as mensagens novamente no navegador após reimplantar a carga de trabalho. As mensagens aparecem como texto cifrado codificado em base64 porque a chave de criptografia privada não pode ser recuperada. A chave não pode ser recuperada porque o consumidor já não está em execução num ambiente confidencial e falta o
skr container, o que impede a desencriptação das mensagens.
Limpeza de recursos
Quando terminares de avaliar esta funcionalidade, limpa recursos desnecessários para evitar encargos do Azure. Se implementou um novo cluster como parte da sua avaliação ou teste, pode eliminar o cluster usando o az aks delete comando.
az aks delete --resource-group myResourceGroup --name myAKSCluster
Se ativaste os contentores Confidenciais (pré-visualização) num cluster existente, podes remover os pods usando o kubectl delete pod comando.
kubectl delete pod <pod-name>
Próximos passos
Saiba mais sobre Azure Dedicated Hosts para nós no seu cluster AKS, para utilizar o isolamento de hardware e o controlo sobre os eventos de manutenção da plataforma do Azure.