El operador de AlloyDB Omni Kubernetes automatiza el ciclo de vida de los clústeres de encriptación de datos transparente (TDE) con el recurso personalizado TdeConfig. Este recurso almacena los detalles de conexión del servicio de administración de claves (KMS), lo que permite que el operador inserte de forma segura las credenciales requeridas en los pods de la base de datos.
Antes de comenzar
- Configura el motor de secretos KV-V2 de HashiCorp Vault para asegurarte de que la ruta de acceso de la clave de encriptación de claves (KEK) y el token web JSON (JWT) estén disponibles.
- Asegúrate de que AlloyDB Omni tenga permiso para leer el archivo de token JWT.
Opcional: Para implementar un clúster habilitado para TDE en OpenShift, otorga la restricción del contexto de seguridad (SCC)
hostmount-anyuida la cuenta de servicioDBClusterque ejecuta el clúster de base de datos.oc adm policy add-scc-to-user hostmount-anyuid -z DBCLUSTER_NAME-sa -n DBCLUSTER_NAMESPACE
Reemplaza DBCLUSTER_NAME por el nombre de
DBClustery DBCLUSTER_NAMESPACE por el espacio de nombres en el que deseas crear el recursoDBCluster.
Configura el acceso a Vault
Crea un recurso secreto que contenga tu ruta de acceso de KEK y las credenciales de autenticación.
apiVersion: v1
kind: ConfigMap
metadata:
name: CONFIG_MAP_NAME
data:
kek_url: "KEK_URL"
token_path: "JWT_TOKEN_PATH"
Reemplaza lo siguiente:
CONFIG_MAP_NAME: Es el nombre del mapa de configuración. Los valores definidos enkek_urlytoken_pathse usan en la definición del recursoTdeConfig.KEK_URL: Es la URL completamente calificada de la KEK en HashiCorp Vault. Usavaultcomo protocolo para especificar HashiCorp Vault como proveedor de KMS, por ejemplo,vault://vault.default.svc:8200/v1/secrets/data/alloydb_kek.JWT_TOKEN_PATH: Es la ruta de acceso al token JWT en el nodo. Por ejemplo,/tmp/token. La ruta de acceso al token JWT debe ser coherente en todos los nodos del clúster.
Crea un secreto de TLS
Para crear un secreto de TLS para almacenar tus certificados, ejecuta los siguientes comandos:
kubectl create secret tls VAULT_SECRET_NAME \
--cert=vault.crt \
--key=vault.key
kubectl patch secret VAULT_SECRET_NAME \
-p '{"data":{"ca.crt":"'$(base64 -w 0 vault.crt)'"}}' \
--type=merge
Reemplaza VAULT_SECRET_NAME por un nombre para el secreto de TLS. Usas este nombre secreto cuando creas el recurso personalizado TdeConfig.
Crea la CRD de TdeConfig
Crea un recurso TdeConfig que defina cómo AlloyDB Omni se comunica con Vault para recuperar la KEK. El único tipo de autenticación compatible es jwt. Asegúrate de crear el recurso TdeConfig en el mismo espacio de nombres que el recurso DbCluster.
Asegúrate de que el usuario postgres pueda acceder a la ruta de acceso a tu token JWT y que se pueda acceder a tu instancia de Vault a través de la red.
Para crear el recurso TdeConfig, sigue estos pasos:
Crea y aplica un manifiesto para el recurso TdeConfig.
apiVersion: alloydbomni.dbadmin.goog/v1
kind: TdeConfig
metadata:
name: TDE_CONFIG_NAME
spec:
kekUrlRef:
name: CONFIG_MAP_NAME
key: kek_url
kmsProvider:
vault:
authType: "jwt"
authMount: "JWT_AUTH_MOUNT_PATH"
jwt:
pathRef:
name: "CONFIG_MAP_NAME"
key: "token_path"
role: "VAULT_ROLE"
tls:
certSecret:
name: "VAULT_SECRET_NAME"
Reemplaza lo siguiente:
TDE_CONFIG_NAME: Es el nombre del recursoTdeConfig.JWT_AUTH_MOUNT_PATH: Es la ruta de acceso en la que se une el motor de autenticación dentro de HashiCorp Vault, según lo define tu configuración. Por ejemplo,auth/kms.- (Opcional)
VAULT_ROLE: Es el rol de cliente definido en la configuración de Vault. El rol de cliente valida el JWT y refleja los derechos de acceso y la identidad específicos que se otorgan al rol dentro de HashiCorp Vault. VAULT_SECRET_NAME: Es el nombre del secreto que contiene los certificados para la conexión de Vault. Por ejemplo,vault-secret.
Implementa el DBCluster
Crea y aplica un manifiesto para crear un recurso
DBClusterque haga referencia a tu recursoTdeConfig. Para obtener más información sobre la creación de un clúster de base de datos, consulta Crea un clúster de base de datos.apiVersion: alloydbomni.dbadmin.goog/v1 kind: DBCluster metadata: name: "DBCLUSTER_NAME" spec: databaseVersion: "18.1.0" features: transparentDataEncryption: tdeConfigRef: name: "TDE_CONFIG_NAME" [...]Reemplaza
TDE_CONFIG_NAMEpor el nombre de tu recursoTdeConfigyDBCLUSTER_NAMEpor el nombre delDBClusterque deseas crear.Opcional: Si implementas
DBClusteren un entorno de Openshift, debes anotar el recursoDBClustercon la anotaciónhostmount-anyuid.kubectl annotate dbclusters.alloydbomni.dbadmin.goog `DBCLUSTER_NAME` -n `DBCLUSTER_NAMESPACE` openshift.io/scc=anyuidReemplaza
DBCLUSTER_NAMEpor el nombre de tuDBClusterrecurso yDBCLUSTER_NAMESPACEpor el espacio de nombres en el que deseas crear el recursoDBCluster.
Visualiza las métricas de TDE
Una vez que se inicializa el clúster, completa los siguientes pasos para verificar que TDE esté habilitado y ver las métricas de TDE relacionadas.
- Conéctate a tu base de datos con
psqlo tu cliente preferido. Para obtener instrucciones detalladas sobre cómo conectarte a tus instancias, consulta Ejecuta AlloyDB Omni y conéctate a él. Ejecuta el siguiente comando:
select * FROM pgsnap.g$tde_stats;Si TDE se habilita correctamente, el resultado muestra métricas de TDE, como si TDE está habilitado, la URL de KEK, la versión de KEK y la marca de tiempo de creación de KEK.
En la siguiente tabla, se explica qué significa cada métrica.
Nombre Descripción Etiqueta Unidad Tipo alloydb_omni_database_tde_data_blocks_decrypted_count_totalCantidad de bloques de datos desencriptados. No aplicable contador alloydb_omni_database_tde_data_blocks_encrypted_count_totalCantidad de bloques de datos encriptados. No aplicable contador alloydb_omni_database_tde_data_decryption_time_us_totalTiempo total dedicado a la desencriptación de bloques de datos. No aplicable microsegundos contador alloydb_omni_database_tde_data_encryption_time_us_totalTiempo total dedicado a la encriptación de bloques de datos. No aplicable microsegundos contador alloydb_omni_database_tde_enabledEstado de TDE habilitado. No aplicable indicador alloydb_omni_database_tde_kek_infoInformación de KEK de TDE. kek_version: Versión de la KEK
que se usa para el ajuste de claves.kek_url: Ruta de acceso completamente calificada
a la KEK en KMS.kek_creation_timestamp:
Hora de creación de la versión de KEK en uso.
indicador alloydb_omni_database_tde_temp_blocks_decrypted_count_totalCantidad de bloques temporales desencriptados. No aplicable contador alloydb_omni_database_tde_temp_blocks_encrypted_count_totalCantidad de bloques temporales encriptados. No aplicable contador alloydb_omni_database_tde_temp_decryption_time_us_totalTiempo total dedicado a la desencriptación de bloques temporales. No aplicable microsegundos contador alloydb_omni_database_tde_temp_encryption_time_us_totalTiempo total dedicado a la encriptación de bloques temporales. No aplicable microsegundos contador alloydb_omni_database_tde_wal_blocks_decrypted_count_totalCantidad de bloques de WAL desencriptados. No aplicable contador alloydb_omni_database_tde_wal_blocks_encrypted_count_totalCantidad de bloques de WAL encriptados. No aplicable contador alloydb_omni_database_tde_wal_decryption_time_us_totalTiempo total dedicado a la desencriptación de bloques de WAL. No aplicable microsegundos contador alloydb_omni_database_tde_wal_encryption_time_us_totalTiempo total dedicado a la encriptación de bloques de WAL. No aplicable microsegundos contador