Skip to main content
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Trident Linux Unified Key Setup (LUKS)

Colaboradores netapp-aruldeepa juliantap joan-ing netapp-mwallis

Linux Unified Key Setup (LUKS) es una especificación de cifrado de discos. Trident utiliza LUKS para proporcionar cifrado por volumen en el host para los volúmenes de ONTAP SAN y ONTAP SAN ECONOMY, con soporte para la rotación de frases de contraseña y la ampliación de volúmenes.

En Trident, los volúmenes cifrados con LUKS utilizan el cifrado y el modo aes-xts-plain64, como recomienda "NIST".

Nota El cifrado LUKS no es compatible con los sistemas ASA r2. Para obtener información sobre los sistemas ASA r2, consulte "Obtenga información sobre los sistemas de almacenamiento R2 de ASA" .
Antes de empezar
  • Los nodos de trabajo deben tener instalado cryptsetup 2.1 o superior (pero inferior a 3.0). Si desea más información, visite "Gitlab: Cryptsetup".

  • Por motivos de rendimiento, NetApp recomienda que los nodos de trabajo admitan las instrucciones nuevas estándar de cifrado avanzado (AES-NI). Para verificar el soporte de AES-ni, ejecute el siguiente comando:

    grep "aes" /proc/cpuinfo

    Si no se devuelve nada, su procesador no admite AES-ni. Para obtener más información sobre AES-ni, visite: "Intel: Instrucciones estándar de cifrado avanzado (AES-ni)".

Active el cifrado LUKS

Puede habilitar el cifrado por volumen en el lado del host usando la configuración de clave unificada de Linux (LUKS) para SAN de ONTAP y volúmenes DE ECONOMÍA SAN de ONTAP.

Pasos
  1. Defina los atributos de cifrado LUKS en la configuración de backend. Para obtener más información sobre las opciones de configuración del back-end para SAN de ONTAP, consulte "Opciones de configuración DE SAN de ONTAP".

    {
      "storage": [
        {
          "labels": {
            "luks": "true"
          },
          "zone": "us_east_1a",
          "defaults": {
            "luksEncryption": "true"
          }
        },
        {
          "labels": {
            "luks": "false"
          },
          "zone": "us_east_1a",
          "defaults": {
            "luksEncryption": "false"
          }
        }
      ]
    }
  2. Uso parameters.selector Para definir los pools de almacenamiento mediante el cifrado LUKS. Por ejemplo:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: luks
    provisioner: csi.trident.netapp.io
    parameters:
      selector: "luks=true"
      csi.storage.k8s.io/node-stage-secret-name: luks-${pvc.name}
      csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace}
  3. Cree un secreto que contenga la frase de paso LUKS. Por ejemplo:

    kubectl -n trident create -f luks-pvc1.yaml
    apiVersion: v1
    kind: Secret
    metadata:
      name: luks-pvc1
    stringData:
      luks-passphrase-name: A
      luks-passphrase: secretA

Utilizar LUKS con volúmenes de bloque sin formato RWX

A partir de Trident 26.10, puedes usar el cifrado LUKS con volúmenes de bloque sin formato respaldados por iSCSI que están conectados a varios nodos de Kubernetes mediante el modo de acceso ReadWriteMany (RWX). Esto es útil para cargas de trabajo como las máquinas virtuales KubeVirt, que necesitan conectar el mismo volumen cifrado en un nodo de destino mientras sigue conectado al nodo de origen durante la migración en vivo.

La compatibilidad con LUKS en modo RWX se limita a los volúmenes de bloques sin formato. Los volúmenes RWX LUKS en modo de sistema de archivos no son compatibles. La aplicación se encarga de coordinar el acceso simultáneo a los datos descifrados; Trident solo coordina las operaciones de LUKS.

Configura LUKS en el backend, la StorageClass y el Secret de frase de contraseña, tal como se describe en Active el cifrado LUKS. A continuación, crea un PVC con volumeMode: Block y ReadWriteMany:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-rwx-pvc
  namespace: my-app
spec:
  accessModes:
    - ReadWriteMany
  volumeMode: Block
  storageClassName: san-luks-rwx
  resources:
    requests:
      storage: 10Gi

Los pods de varios nodos pueden conectar este PVC como un dispositivo de bloques sin procesar. Trident formatea el dispositivo con LUKS2 la primera vez que se conecta y abre el volumen cifrado existente en los nodos posteriores. Se admiten las operaciones de LUKS existentes, incluida la rotación de la frase de contraseña y la ampliación del volumen.

Por qué Trident serializa las operaciones de LUKS

LUKS2 almacena copias redundantes de su encabezado de cifrado al principio del dispositivo de bloque. cryptsetup puede reparar un encabezado cuando detecta que las copias difieren, incluso durante comandos que parecen ser de solo lectura. Su bloqueo es local a un nodo y no puede coordinar operaciones en otros nodos. Si un nodo está actualizando el encabezado mientras otro ejecuta cryptsetup, el segundo nodo podría activar la reparación del encabezado e interrumpir la actualización, lo que podría dañar el encabezado.

Para evitar el acceso simultáneo al encabezado, Trident utiliza un Lease de Kubernetes para cada volumen LUKS RWX. Antes de que un nodo ejecute cualquier cryptsetup comando para el volumen, debe tener el Lease. Trident libera el Lease después de que la operación se complete correctamente. Si otro nodo solicita una operación mientras el Lease está en uso, Trident devuelve un error que permite reintentarla y Kubernetes vuelve a intentarlo más tarde. Las operaciones en distintos volúmenes son independientes.

Si falla una operación de cryptsetup, Trident conserva intencionadamente Lease para que solo el mismo nodo pueda volver a intentarlo. Un evento de advertencia con el motivo LeaseRetained registra el fallo. Leases no caducan automáticamente; un administrador solo debe eliminar Lease después de confirmar que no se está ejecutando ninguna operación de cryptsetup en el nodo que la posee. Para ver los pasos de recuperación, consulta "Soluciona un Lease atascado para volúmenes RWX Linux Unified Key Setup (LUKS)".

Dado que los nodos se turnan para abrir el volumen, iniciar cargas de trabajo en muchos nodos diferentes puede llevar más tiempo que con un volumen sin cifrar. Kubernetes reintenta las operaciones que fallan por errores de bloqueo transitorios cuando finaliza la operación actual. Los pods pueden permanecer en ContainerCreating durante más tiempo en escalados horizontales de gran tamaño; las cargas de trabajo en el mismo nodo pueden compartir una única asignación de dispositivo abierto.

Limitaciones

Los volúmenes cifrados LUKS no pueden aprovechar la deduplicación y la compresión de ONTAP.

Configuración de backend para importar volúmenes LUKS

Para importar un volumen LUKS, debe establecer luksEncryption en(true en el backend. luksEncryption`La opción indica a Trident si el volumen es compatible con LUKS (`true) o no con LUKS (false) como se muestra en el siguiente ejemplo.

version: 1
storageDriverName: ontap-san
managementLIF: 10.0.0.1
dataLIF: 10.0.0.2
svm: trident_svm
username: admin
password: password
defaults:
  luksEncryption: 'true'
  spaceAllocation: 'false'
  snapshotPolicy: default
  snapshotReserve: '10'

Configuración de PVC para importar volúmenes LUKS

Para importar volúmenes LUKS dinámicamente, establezca la anotación trident.netapp.io/luksEncryption en true e incluya una clase de almacenamiento habilitada para LUKS en la RVP como se muestra en este ejemplo.

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: luks-pvc
  namespace: trident
  annotations:
    trident.netapp.io/luksEncryption: "true"
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
  storageClassName: luks-sc

Gire una frase de paso LUKS

Puede girar la frase de paso de LUKS y confirmar la rotación.

Advertencia No olvide una clave de acceso hasta que haya verificado que ya no hace referencia a ningún volumen, snapshot o secreto. Si se pierde una clave de acceso de referencia, es posible que no se pueda montar el volumen y los datos seguirán estando cifrados e inaccesibles.
Acerca de esta tarea

LA rotación DE la frase de paso LUKS se produce cuando se crea un pod que monta el volumen después de especificar una nueva frase de paso LUKS. Cuando se crea un nuevo pod, Trident compara la frase de acceso LUKS del volumen con la frase de acceso activa del secreto.

  • Si la clave de acceso del volumen no coincide con la clave de acceso activa en el secreto, se produce la rotación.

  • Si la clave de acceso del volumen coincide con la clave de acceso activa en el secreto, el previous-luks-passphrase se ignora el parámetro.

Pasos
  1. Añada el node-publish-secret-name y.. node-publish-secret-namespace Parámetros de StorageClass. Por ejemplo:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: csi-san
    provisioner: csi.trident.netapp.io
    parameters:
      trident.netapp.io/backendType: "ontap-san"
      csi.storage.k8s.io/node-stage-secret-name: luks
      csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace}
      csi.storage.k8s.io/node-publish-secret-name: luks
      csi.storage.k8s.io/node-publish-secret-namespace: ${pvc.namespace}
  2. Identifique las bases de datos passhrases existentes en el volumen o la snapshot.

    Volumen
    tridentctl -d get volume luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>
    
    ...luksPassphraseNames:["A"]
    Snapshot
    tridentctl -d get snapshot luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>/<snapshotID>
    
    ...luksPassphraseNames:["A"]
  3. Actualice el secreto LUKS del volumen para especificar las passphrases nuevas y anteriores. Asegúrese previous-luke-passphrase-name y.. previous-luks-passphrase coincidir con la frase de contraseña anterior.

    apiVersion: v1
    kind: Secret
    metadata:
      name: luks-pvc1
    stringData:
      luks-passphrase-name: B
      luks-passphrase: secretB
      previous-luks-passphrase-name: A
      previous-luks-passphrase: secretA
  4. Cree un nuevo pod montando el volumen. Esto es necesario para iniciar la rotación.

  5. Compruebe que se ha girado la frase de paso.

    Volumen
    tridentctl -d get volume luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>
    
    ...luksPassphraseNames:["B"]
    Snapshot
    tridentctl -d get snapshot luks-pvc1
    GET http://127.0.0.1:8000/trident/v1/volume/<volumeID>/<snapshotID>
    
    ...luksPassphraseNames:["B"]
Resultados

La frase de contraseña se giró cuando solo se devuelve la nueva frase de contraseña en el volumen y la instantánea.

Nota Si se devuelven dos passphrasas, por ejemplo luksPassphraseNames: ["B", "A"], la rotación está incompleta. Puede activar un nuevo pod para intentar completar la rotación.

Habilite la expansión de volumen

Es posible habilitar la ampliación de volumen en un volumen cifrado LUKS.

Pasos
  1. Habilite el CSINodeExpandSecret puerta de características (beta 1.25+). Consulte "Kubernetes 1.25: Use Secrets for Node-Driven Expansion of CSI Volumes" para obtener más detalles.

  2. Añada el node-expand-secret-name y.. node-expand-secret-namespace Parámetros de StorageClass. Por ejemplo:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: luks
    provisioner: csi.trident.netapp.io
    parameters:
      selector: "luks=true"
      csi.storage.k8s.io/node-stage-secret-name: luks-${pvc.name}
      csi.storage.k8s.io/node-stage-secret-namespace: ${pvc.namespace}
      csi.storage.k8s.io/node-expand-secret-name: luks-${pvc.name}
      csi.storage.k8s.io/node-expand-secret-namespace: ${pvc.namespace}
    allowVolumeExpansion: true
Resultados

Al iniciar la ampliación de almacenamiento en línea, el kubelet pasa las credenciales adecuadas al controlador.