O operador do AlloyDB Omni Kubernetes automatiza o ciclo de vida dos clusters de criptografia de dados transparente (TDE, na sigla em inglês) usando o recurso personalizado TdeConfig. Esse recurso armazena detalhes de conexão do serviço de gerenciamento de chaves (KMS), permitindo que o operador insira com segurança as credenciais necessárias nos pods de banco de dados.
Antes de começar
- Configure o mecanismo de secrets KV-V2 do HashiCorp Vault para garantir que o caminho da chave de criptografia de chave (KEK, na sigla em inglês) e o JSON Web Token (JWT) estejam disponíveis.
- Verifique se o AlloyDB Omni tem permissão para ler o arquivo de token JWT.
Opcional: para implantar um cluster ativado para TDE no OpenShift, conceda a restrição de contexto de segurança (SCC, na sigla em inglês)
hostmount-anyuidà conta de serviçoDBClusterque executa o cluster de banco de dados.oc adm policy add-scc-to-user hostmount-anyuid -z DBCLUSTER_NAME-sa -n DBCLUSTER_NAMESPACE
Substitua DBCLUSTER_NAME pelo nome do
DBClustere DBCLUSTER_NAMESPACE pelo namespace em que você quer criar o recursoDBCluster.
Configurar o acesso ao Vault
Crie um recurso secreto que contenha o caminho da KEK e as credenciais de autenticação.
apiVersion: v1
kind: ConfigMap
metadata:
name: CONFIG_MAP_NAME
data:
kek_url: "KEK_URL"
token_path: "JWT_TOKEN_PATH"
Substitua:
CONFIG_MAP_NAME: nome do mapa de configuração. Os valores definidos emkek_urletoken_pathsão usados na definição do recursoTdeConfig.KEK_URL: o URL totalmente qualificado para a KEK no HashiCorp Vault. Usevaultcomo o protocolo para especificar o HashiCorp Vault como o provedor de KMS. Por exemplo,vault://vault.default.svc:8200/v1/secrets/data/alloydb_kek.JWT_TOKEN_PATH: caminho para o token JWT no nó. Por exemplo,/tmp/token. O caminho de acesso ao token JWT precisa ser consistente em todos os nós do cluster.
Criar um secret TLS
Para criar um secret TLS para armazenar seus certificados, execute os seguintes 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
Substitua VAULT_SECRET_NAME por um nome para o secret TLS. Você usa esse nome secreto ao criar o recurso personalizado TdeConfig.
Criar o CRD TdeConfig
Crie um recurso TdeConfig que defina como o AlloyDB Omni se comunica com o Vault para recuperar a KEK. O único tipo de autenticação compatível é jwt. Crie o recurso TdeConfig no mesmo namespace que o recurso DbCluster.
Verifique se o caminho para o token JWT está acessível ao usuário postgres e se a instância do Vault pode ser acessada pela rede.
Para criar o recurso TdeConfig, siga estas etapas:
Crie e aplique um manifesto para o 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"
Substitua:
TDE_CONFIG_NAME: nome do recursoTdeConfig.JWT_AUTH_MOUNT_PATH: caminho em que o mecanismo de autenticação é montado no HashiCorp Vault, conforme definido pela configuração. Por exemplo,auth/kms.- (Opcional)
VAULT_ROLE: o papel do cliente definido na sua configuração do Vault. O papel do cliente valida o JWT e reflete os direitos de acesso e a identidade específicos que o papel recebe no HashiCorp Vault. VAULT_SECRET_NAME: nome do secret que contém os certificados para a conexão do Vault. Por exemplo,vault-secret.
Implantar o DBCluster
Crie e aplique um manifesto para criar um recurso
DBClusterque faça referência ao recursoTdeConfig. Para mais informações sobre como criar um cluster de banco de dados, consulte Criar um cluster de banco de dados.apiVersion: alloydbomni.dbadmin.goog/v1 kind: DBCluster metadata: name: "DBCLUSTER_NAME" spec: databaseVersion: "18.1.0" features: transparentDataEncryption: tdeConfigRef: name: "TDE_CONFIG_NAME" [...]Substitua
TDE_CONFIG_NAMEpelo nome do recursoTdeConfigeDBCLUSTER_NAMEpelo nome doDBClusterque você quer criar.Opcional: se você estiver implantando
DBClusterem um ambiente do Openshift, anote o recursoDBClustercom a anotaçãohostmount-anyuid.kubectl annotate dbclusters.alloydbomni.dbadmin.goog `DBCLUSTER_NAME` -n `DBCLUSTER_NAMESPACE` openshift.io/scc=anyuidSubstitua
DBCLUSTER_NAMEpelo nome do seu recursoDBClustereDBCLUSTER_NAMESPACEpelo namespace em que você quer criar o recursoDBCluster.
Conferir métricas de TDE
Depois que o cluster for inicializado, siga estas etapas para verificar se o TDE está ativado e conferir as métricas relacionadas.
- Conecte-se ao banco de dados usando
psqlou o cliente de sua preferência. Para instruções detalhadas sobre como se conectar às instâncias, consulte Executar e conectar-se ao AlloyDB Omni. Execute este comando:
select * FROM pgsnap.g$tde_stats;Se o TDE estiver ativado, a saída vai mostrar métricas de TDE, como se o TDE está ativado, o URL da KEK, a versão da KEK e o carimbo de data/hora de criação da KEK.
A tabela a seguir explica o que cada métrica significa.
Nome Descrição Rótulo Unidade Tipo alloydb_omni_database_tde_data_blocks_decrypted_count_totalNúmero de blocos de dados descriptografados. Não relevante Contador alloydb_omni_database_tde_data_blocks_encrypted_count_totalNúmero de blocos de dados criptografados. Não relevante Contador alloydb_omni_database_tde_data_decryption_time_us_totalTempo total gasto na descriptografia de blocos de dados. Não relevante microssegundos Contador alloydb_omni_database_tde_data_encryption_time_us_totalTempo total gasto na criptografia de blocos de dados. Não relevante microssegundos Contador alloydb_omni_database_tde_enabledStatus ativado do TDE. Não relevante medidor alloydb_omni_database_tde_kek_infoInformações da KEK do TDE. kek_version: versão da KEK
em uso para encapsulamento de chaves.kek_url: caminho totalmente qualificado
para a KEK no KMSkek_creation_timestamp:
hora de criação da versão da KEK em uso.
medidor alloydb_omni_database_tde_temp_blocks_decrypted_count_totalNúmero de blocos temporários descriptografados. Não relevante Contador alloydb_omni_database_tde_temp_blocks_encrypted_count_totalNúmero de blocos temporários criptografados. Não relevante Contador alloydb_omni_database_tde_temp_decryption_time_us_totalTempo total gasto na descriptografia de blocos temporários. Não relevante microssegundos Contador alloydb_omni_database_tde_temp_encryption_time_us_totalTempo total gasto na criptografia de blocos temporários. Não relevante microssegundos Contador alloydb_omni_database_tde_wal_blocks_decrypted_count_totalNúmero de blocos WAL descriptografados. Não relevante Contador alloydb_omni_database_tde_wal_blocks_encrypted_count_totalNúmero de blocos WAL criptografados. Não relevante Contador alloydb_omni_database_tde_wal_decryption_time_us_totalTempo total gasto na descriptografia de blocos WAL. Não relevante microssegundos Contador alloydb_omni_database_tde_wal_encryption_time_us_totalTempo total gasto na criptografia de blocos WAL. Não relevante microssegundos Contador