Implementar um cluster AKS com contentores Confidenciais e uma política gerada automaticamente

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 version para localizar a versão e execute az upgrade para 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-preview Azure.
  • A versão mais recente da confcom extensã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 instalar kubectl localmente usando o az aks install-cli comando.
  • 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:

  1. Execute o seguinte comando para instalar a aks-preview extensão:

    az extension add --name aks-preview
    
  2. Execute 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

  1. Execute o seguinte comando para instalar a confcom extensão:

    az extension add --name confcom
    
  2. Execute 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

  1. Execute o comando az feature register para registar o sinalizador de funcionalidade KataCcIsolationPreview, conforme ilustrado no exemplo seguinte:

    az feature register --namespace "Microsoft.ContainerService" --name "KataCcIsolationPreview"
    
  2. Espere alguns minutos até que o estado apareça como Registado. Execute o az feature show comando para verificar o estado do registo:

    az feature show --namespace "Microsoft.ContainerService" --name "KataCcIsolationPreview"
    
  3. Quando o estado mostrar Registado, execute o comando az provider register para atualizar o registo do fornecedor de recursos Microsoft.ContainerService:

    az provider register --namespace "Microsoft.ContainerService"
    

Crie um cluster com contentores Confidenciais ativados

  1. Crie um cluster AKS usando o az aks create comando. 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-keys
    

    Após alguns minutos, o comando termina e devolve informação em formato JSON sobre o cluster.

  2. Quando o cluster estiver pronto, obtenha as credenciais do cluster usando o az aks get-credentials comando.

    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:

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.

  1. Adiciona um conjunto de nós ao teu cluster AKS usando o az aks nodepool add comando. 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-runtime parâ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 KataCcIsolation
    

    Após alguns minutos, o comando conclui e retorna informações formatadas em JSON sobre o cluster.

  2. Execute o az aks update comando 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 myResourceGroup
    

    Após alguns minutos, o comando conclui e retorna informações formatadas em JSON sobre o cluster.

  3. Quando o cluster estiver pronto, obtenha as credenciais do cluster usando o az aks get-credentials comando.

    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.

  1. 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_NAME variável.

    • Para adicionar atribuições de função, você deve ter Microsoft.Authorization/roleAssignments/write e Microsoft.Authorization/roleAssignments/delete permissõ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_SCOPE
    

    Execute 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_SCOPE
    
  2. Instale o cluster Kafka no namespace kafka executando o seguinte comando:

    kubectl create -f 'https://strimzi.io/install/latest?namespace=kafka' -n kafka
    
  3. Execute 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 kafka
    
  4. Prepare a chave de encriptação/desencriptação RSA utilizando o script bash para o workload do GitHub. Guarde o ficheiro como setup-key.sh.

  5. Defina a variável de ambiente MAA_ENDPOINT com 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_ENDPOINT
    

    Nota

    Para configurar o Atestado do Microsoft Azure, consulte Guia de início rápido: configurar o Atestado do Azure com a CLI do Azure.

  6. 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-consumer
    

    Nota

    Atualize o valor da variável SkrClientAKVEndpoint de ambiente pod para corresponder à URL do seu Cofre da Chave do Azure, excluindo o valor https://do protocolo . O valor atual do marcador de posição é myKeyVault.vault.azure.net. Atualize o valor da variável SkrClientMAAEndpoint de ambiente pod com o valor de MAA_ENDPOINT. Você pode encontrar o valor de MAA_ENDPOINT executando o comando echo $MAA_ENDPOINT ou o comando az attestation show --name "myattestationprovider" --resource-group "MyResourceGroup" --query 'attestUri' -o tsv | cut -c 9-.

  7. 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_MEASUREMENT variável executando o seguinte comando:

    export WORKLOAD_MEASUREMENT=$(az confcom katapolicygen -y consumer.yaml --print-policy | base64 -d | sha256sum | cut -d' ' -f1)
    
  8. Para gerar um par de chaves assimétricas RSA (chaves pública e privada), execute o setup-key.sh script usando o seguinte comando. O <Azure Key Vault URL> valor deve ser <your-unique-keyvault-name>.vault.azure.net

    export MANAGED_IDENTITY=${USER_ASSIGNED_CLIENT_ID}
    bash setup-key.sh "kafka-encryption-demo" <Azure Key Vault URL>
    

    Nota

    • O script setup-key.sh Bash requer a variável de ambiente MANAGED_IDENTITY.

    • A chave pública será guardada como kafka-encryption-demo-pub.pem apó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.

  9. 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 table
    
  10. Copie 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: 200m
    

    Nota

    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 de kafka-encryption-demo-pub.pem, que foi criado no passo anterior.

  11. Implemente os manifestos YAML consumer e producer utilizando os ficheiros que guardou anteriormente.

    kubectl apply -f consumer.yaml
    
    kubectl apply -f producer.yaml
    
  12. Obtenha o endereço IP do serviço Web usando o seguinte comando:

    kubectl get svc consumer -n kafka
    
  13. Copie 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 Computing
    
  14. Também deve tentar executar o consumidor como um pod normal do Kubernetes, removendo a especificação skr container e kata-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.

  15. 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.