Inicializar uma VM com segurança

Este documento explica como ativar a inicialização segura ou um módulo de plataforma confiável virtualizado (vTPM) em uma instância de máquina virtual (VM) no appliance isolado do Google Distributed Cloud (GDC).

Este documento é destinado a desenvolvedores em grupos de administradores de plataforma ou operadores de aplicativos que configuram a inicialização segura e os vTPMs em VMs em um ambiente de appliance GDC com isolamento físico.

Sobre a inicialização segura

A inicialização segura é um recurso que garante que o sistema execute apenas softwares autênticos. Para isso, ela verifica a assinatura digital de todos os componentes de inicialização e interrompe o processo se a verificação falhar. Ele usa o firmware da Unified Extensible Firmware Interface (UEFI) para gerenciar certificados e chaves que os fabricantes usam para assinar o firmware do sistema, os carregadores de inicialização e os binários carregados.

Em cada inicialização, o firmware UEFI verifica a assinatura digital de cada componente em relação às chaves aprovadas armazenadas e bloqueia componentes não assinados ou assinados incorretamente. Para ativar a inicialização segura na instância de VM, defina o tipo bootloader da VM como uefi.

Para conferir a documentação oficial da UEFI, acesse https://uefi.org/sites/default/files/resources/UEFI_Secure_Boot_in_Modern_Computer_Security_Solutions_2013.pdf.

Sobre os módulos de plataforma confiável virtual

Um vTPM é um chip de computador virtual especializado que protege as chaves e os certificados usados para autenticar o acesso ao sistema. Consulte https://trustedcomputinggroup.org/trusted-platform-module-tpm-summary/ para mais informações sobre vTPMs.

Também é possível usar um vTPM para proteger chaves secretas por meio de blindagem ou bloqueio. Para mais informações sobre o armazenamento lacrado, consulte https://en.wikipedia.org/wiki/Trusted_Computing#SEALED-STORAGE. Consulte o projeto Go-TPM no GitHub: https://github.com/google/go-tpm (em inglês), para exemplos de linguagem Go que ilustram como usar um vTPM para essa finalidade.

Antes de começar

Para usar os comandos da interface de linha de comando (CLI) gdcloud, verifique se você baixou, instalou e configurou a CLI gdcloud. Todos os comandos para o dispositivo GDC com isolamento físico usam a CLI gdcloud ou kubectl e exigem um ambiente de sistema operacional (SO).

Extrair o caminho do arquivo kubeconfig

Para executar comandos no servidor da API Management, verifique se você tem os seguintes recursos:

  1. Localize o nome do servidor da API Management ou pergunte ao administrador da plataforma (PA) qual é o nome do servidor.

  2. Faça login e gere o arquivo kubeconfig para o servidor da API Management se você não tiver um.

  3. Use o caminho para substituir MANAGEMENT_API_SERVER{"</var>"}} nestas instruções.

Solicitar papéis do IAM

Para ativar a inicialização segura ou o vTPM na VM, entre em contato com o administrador do IAM do projeto e peça a função Administrador de máquinas virtuais do projeto (project-vm-admin).

Todas as funções de VM precisam ser vinculadas ao namespace do projeto em que a VM reside. Siga as etapas para verificar seu acesso.

Ativar a inicialização segura

Ative a inicialização segura para uma VM. Use as instruções a seguir para uma VM chamada VM_NAME no namespace do projeto (PROJECT_NAMESPACE).

  1. Atualize o recurso personalizado da VM para ativar a inicialização segura:

    kubectl --kubeconfig MANAGEMENT_API_SERVER patch virtualmachines.virtualmachine.gdc.goog VM_NAME -n PROJECT_NAMESPACE --type merge --patch $'
    spec:
     shieldConfig:
       bootType: uefi
       enableSecureBoot: true
    '
    
  2. Se a VM estiver em execução, reinicie-a usando as instruções para reiniciar uma VM.

  3. Verifique se você ativou a inicialização segura. Estabeleça uma conexão SSH com a VM e execute o seguinte comando:

    mokutil --sb-state
    

    Se você tiver ativado a inicialização segura, o comando vai retornar SecureBoot enabled.

    Se a ferramenta mokutil informar que você não ativou a inicialização segura, siga as etapas na seção Resolver problemas na configuração da inicialização segura.

Resolver problemas na configuração de inicialização segura

  1. Abra o recurso personalizado da VM em um editor:

    kubectl --kubeconfig MANAGEMENT_API_SERVER edit virtualmachines.virtualmachine.gdc.goog VM_NAME -n PROJECT_NAMESPACE
    
  2. Procure campos ou valores ausentes, conforme mostrado no campo spec em "Execute o seguinte comando". Esses itens são obrigatórios.

  3. Se algum estiver faltando ou incorreto, edite spec para adicionar os campos ausentes e corrigir os valores errados.

  4. Salve o arquivo.

  5. Siga as etapas em Reiniciar a VM.

Se as etapas anteriores não resolverem o problema, consulte a documentação correspondente ao sistema operacional (SO) da VM para verificar se a versão do SO é compatível com a inicialização segura.

Ativar o módulo de plataforma confiável virtual (vTPM)

Ative o vTPM para uma VM. Use as instruções a seguir para uma VM chamada VM_NAME no namespace do projeto (PROJECT_NAMESPACE).

  1. Atualize o recurso personalizado da VM para ativar o vTPM:

    kubectl --kubeconfig MANAGEMENT_API_SERVER patch virtualmachines.virtualmachine.gdc.goog VM_NAME -n PROJECT_NAMESPACE --type merge --patch $'
    spec:
       shieldConfig:
          enableVtpm: true
    '
    
  2. Se a VM estiver em execução, reinicie-a seguindo as instruções para reiniciar uma VM.

  3. Verifique se você ativou o vTPM. Estabeleça uma conexão SSH com sua VM e execute o seguinte comando:

    dmesg | grep -i tpm
    

    Se você tiver ativado o vTPM, o comando vai retornar o módulo TPM como parte das tabelas ACPI. A saída será assim:

    [    7.620985] tpm_tis MSFT0101:00: 2.0 TPM (device-id 0x1, rev-id 1)
    

    Se o ACPI tables não mostrar o módulo TPM, siga as etapas na seção Solução de problemas da configuração do vTPM.

Resolver problemas de configuração do vTPM

  1. Abra o recurso personalizado da VM em um editor:

    kubectl --kubeconfig MANAGEMENT_API_SERVER edit virtualmachines.virtualmachine.gdc.goog VM_NAME -n PROJECT_NAMESPACE
    
  2. Procure campos ou valores ausentes, conforme mostrado no campo spec em Execute o seguinte comando. Esses itens são obrigatórios.

  3. Se algum estiver faltando ou incorreto, edite spec para adicionar os campos ausentes e corrigir os valores errados.

  4. Salve o arquivo.

  5. Siga as etapas em Reiniciar a VM.

Se as etapas anteriores não resolverem o problema, consulte a documentação correspondente ao sistema operacional (SO) da VM para verificar se a versão do SO é compatível com o vTPM.