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:
Localize o nome do servidor da API Management ou pergunte ao administrador da plataforma (PA) qual é o nome do servidor.
Faça login e gere o arquivo kubeconfig para o servidor da API Management se você não tiver um.
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).
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 'Se a VM estiver em execução, reinicie-a usando as instruções para reiniciar uma VM.
Verifique se você ativou a inicialização segura. Estabeleça uma conexão SSH com a VM e execute o seguinte comando:
mokutil --sb-stateSe você tiver ativado a inicialização segura, o comando vai retornar
SecureBoot enabled.Se a ferramenta
mokutilinformar 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
Abra o recurso personalizado da VM em um editor:
kubectl --kubeconfig MANAGEMENT_API_SERVER edit virtualmachines.virtualmachine.gdc.goog VM_NAME -n PROJECT_NAMESPACEProcure campos ou valores ausentes, conforme mostrado no campo
specem "Execute o seguinte comando". Esses itens são obrigatórios.Se algum estiver faltando ou incorreto, edite
specpara adicionar os campos ausentes e corrigir os valores errados.Salve o arquivo.
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).
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 'Se a VM estiver em execução, reinicie-a seguindo as instruções para reiniciar uma VM.
Verifique se você ativou o vTPM. Estabeleça uma conexão SSH com sua VM e execute o seguinte comando:
dmesg | grep -i tpmSe 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 tablesnã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
Abra o recurso personalizado da VM em um editor:
kubectl --kubeconfig MANAGEMENT_API_SERVER edit virtualmachines.virtualmachine.gdc.goog VM_NAME -n PROJECT_NAMESPACEProcure campos ou valores ausentes, conforme mostrado no campo
specem Execute o seguinte comando. Esses itens são obrigatórios.Se algum estiver faltando ou incorreto, edite
specpara adicionar os campos ausentes e corrigir os valores errados.Salve o arquivo.
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.