Iniciar una VM de forma segura

En este documento se explica cómo habilitar el arranque seguro o un módulo de plataforma segura virtualizado (vTPM) en una instancia de máquina virtual (VM) en Google Distributed Cloud (GDC) aislado.

Este documento va dirigido a los desarrolladores de grupos de administradores de plataformas u operadores de aplicaciones que configuran el arranque seguro y los vTPMs en VMs en un entorno de GDC. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

Acerca del arranque seguro

El arranque seguro es una función que asegura que el sistema solo ejecute software auténtico, ya que verifica la firma digital de todos los componentes del arranque y detiene el proceso si se produce algún error en la verificación. Utiliza el firmware de la interfaz de firmware extensible unificada (UEFI) para gestionar los certificados y las claves que usan los fabricantes para firmar el firmware del sistema, los cargadores de arranque y los binarios cargados.

En cada arranque, el firmware UEFI verifica la firma digital de cada componente con las claves aprobadas almacenadas y bloquea los componentes que no estén firmados o que no estén firmados correctamente. Para habilitar el arranque seguro en tu instancia de VM, debes definir el campo shieldConfig.bootType de la VM como uefi y shieldConfig.enableSecureBoot como true.

Para consultar la documentación oficial de UEFI, visita https://uefi.org/sites/default/files/resources/UEFI_Secure_Boot_in_Modern_Computer_Security_Solutions_2013.pdf.

Acerca de los módulos de plataforma segura virtuales

Un vTPM es un chip de ordenador virtual especializado que protege las claves y los certificados que se usan para autenticar el acceso al sistema. Consulta https://trustedcomputinggroup.org/trusted-platform-module-tpm-summary/ para obtener más información sobre los vTPMs.

También puedes usar un vTPM para proteger secretos mediante el blindaje o el sellado. Para obtener más información sobre el almacenamiento sellado, consulta https://en.wikipedia.org/wiki/Trusted_Computing#SEALED-STORAGE. Consulta el proyecto Go-TPM en GitHub (https://github.com/google/go-tpm) para ver ejemplos del lenguaje Go que ilustran cómo usar un vTPM con este fin.

Antes de empezar

Para usar los comandos de la interfaz de línea de comandos (CLI) de gdcloud, asegúrate de haber descargado, instalado y configurado la CLI de gdcloud. Todos los comandos de Distributed Cloud usan la CLI gdcloud o kubectl y requieren un entorno de sistema operativo (SO).

Obtener la ruta del archivo kubeconfig

Para ejecutar comandos en el servidor de la API Management, asegúrate de que tienes los siguientes recursos:

  1. Inicia sesión y genera el archivo kubeconfig para el servidor de la API Management si no tienes uno.

  2. Usa la ruta al archivo kubeconfig del servidor de la API Management para sustituir MANAGEMENT_API_SERVER en estas instrucciones.

Solicitar roles de gestión de identidades y accesos

Para obtener los permisos que necesitas para habilitar el arranque seguro o vTPM en tu VM, pide al administrador de proyectos de gestión de identidades y accesos que te conceda el rol de administrador de proyectos de máquinas virtuales (project-vm-admin).

Todos los roles de VM deben vincularse al espacio de nombres del proyecto en el que reside la VM. Sigue los pasos para verificar tu acceso.

Habilitar el arranque seguro

Habilita el arranque seguro en una VM. Sigue estas instrucciones para una VM llamada VM_NAME en el espacio de nombres del proyecto (PROJECT_NAMESPACE).

  1. Si la VM se está ejecutando, detenla antes de aplicar el parche. Si intentas aplicar un parche a shieldConfig mientras la máquina virtual está en ejecución, la API devolverá un error Forbidden: Changes to shieldConfig are not allowed while the VM is running. Para obtener instrucciones, consulta Detener una VM.

  2. Actualiza el recurso personalizado de tu VM para habilitar el arranque seguro:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT_NAMESPACE \
      patch virtualmachines.virtualmachine.gdc.goog VM_NAME \
      --type merge --patch $'
    spec:
      shieldConfig:
        bootType: uefi
        enableSecureBoot: true
    '
    

    Sustituye las siguientes variables:

    • MANAGEMENT_API_SERVER: el archivo kubeconfig del servidor de la API de gestión.
    • PROJECT_NAMESPACE: el espacio de nombres del proyecto en el que reside la VM.
    • VM_NAME: el nombre de la VM.
  3. Una vez que hayas aplicado el parche correctamente, inicia tu VM siguiendo las instrucciones para iniciar una VM.

  4. Comprueba que hayas habilitado el arranque seguro. Establece una conexión SSH con tu VM y ejecuta el siguiente comando:

    mokutil --sb-state
    

    Si has habilitado el arranque seguro correctamente, el comando devolverá SecureBoot enabled.

    Si la herramienta mokutil indica que no has habilitado el arranque seguro, sigue los pasos de la sección Solucionar problemas de configuración del arranque seguro.

Solucionar problemas de configuración del arranque seguro

  1. Abre el recurso personalizado de tu VM en un editor:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT_NAMESPACE \
      edit virtualmachines.virtualmachine.gdc.goog VM_NAME
    

    Sustituye las siguientes variables:

    • MANAGEMENT_API_SERVER: el archivo kubeconfig del servidor de la API de gestión.
    • PROJECT_NAMESPACE: el espacio de nombres del proyecto en el que reside la VM.
    • VM_NAME: el nombre de la VM.
  2. Busca los campos o valores que faltan, tal como se muestra en el campo spec de Habilitar el arranque seguro. Estos campos son obligatorios.

  3. Si falta alguno o es incorrecto, edita spec para añadir los campos que faltan y corregir los valores erróneos.

  4. Guarda el archivo.

  5. Sigue los pasos que se indican en el artículo Reiniciar la máquina virtual.

Si los pasos anteriores no resuelven el problema, consulta la documentación correspondiente al sistema operativo de la VM para verificar que la versión del sistema operativo admite el arranque seguro.

Habilitar vTPM

Habilitar vTPM en una VM. Sigue estas instrucciones para una VM llamada VM_NAME en el espacio de nombres del proyecto (PROJECT_NAMESPACE).

  1. Si la VM se está ejecutando, detenla antes de aplicar el parche. Si intentas aplicar un parche a shieldConfig mientras la máquina virtual está en ejecución, la API devolverá un error Forbidden: Changes to shieldConfig are not allowed while the VM is running. Para obtener instrucciones, consulta Detener una VM.

  2. Actualiza el recurso personalizado de tu VM para habilitar el vTPM:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT_NAMESPACE \
      patch virtualmachines.virtualmachine.gdc.goog VM_NAME \
      --type merge --patch $'
    spec:
      shieldConfig:
        enableVtpm: true
    '
    

    Sustituye las siguientes variables:

    • MANAGEMENT_API_SERVER: el archivo kubeconfig del servidor de la API de gestión.
    • PROJECT_NAMESPACE: el espacio de nombres del proyecto en el que reside la VM.
    • VM_NAME: el nombre de la VM.
  3. Una vez que hayas aplicado el parche correctamente, inicia tu VM siguiendo las instrucciones para iniciar una VM.

  4. Comprueba que has habilitado vTPM. Establece una conexión SSH con tu VM y ejecuta el siguiente comando:

    dmesg | grep -i tpm
    

    Si has habilitado correctamente el vTPM, el comando devuelve el módulo TPM como parte de las tablas ACPI. El resultado debería ser similar al siguiente:

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

    Si la ACPI tables no muestra el módulo TPM, sigue los pasos de la sección Solucionar problemas de configuración de vTPM.

Solucionar problemas de configuración del vTPM

  1. Abre el recurso personalizado de tu VM en un editor:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT_NAMESPACE \
      edit virtualmachines.virtualmachine.gdc.goog VM_NAME
    

    Sustituye las siguientes variables:

    • MANAGEMENT_API_SERVER: el archivo kubeconfig del servidor de la API de gestión.
    • PROJECT_NAMESPACE: el espacio de nombres del proyecto en el que reside la VM.
    • VM_NAME: el nombre de la VM.
  2. Busca los campos o valores que faltan, tal como se muestra en el campo spec de Habilitar vTPM. Estos campos son obligatorios.

  3. Si falta alguno o es incorrecto, edita spec para añadir los campos que faltan y corregir los valores erróneos.

  4. Guarda el archivo.

  5. Sigue los pasos que se indican en el artículo Reiniciar la máquina virtual.

Si los pasos anteriores no resuelven el problema, consulta la documentación correspondiente al sistema operativo de la máquina virtual para verificar que la versión del sistema operativo admite vTPM.