Esta página é uma tradução automática da página em inglês, que é a versão de referência. Ler a página em inglês
Gerenciamento da chave de criptografia de chaves (KEK)
O servidor criptografa os segredos que guarda no banco de dados com uma chave de criptografia de chaves (KEK) que ele nunca armazena ali. Esta página explica como gerar, armazenar, fazer backup e rotacionar a KEK, como mantê-la em um KMS e o que fazer se ela for perdida ou vazar. A referência de configuração lista todas as configurações.
Como funciona
Seção intitulada “Como funciona”- Os segredos guardados no banco de dados, como as chaves privadas dos atores, são criptografados com AES-256-GCM usando uma chave de criptografia de dados (DEK) gerada para cada segredo. A DEK é envolvida com uma chave de criptografia de chaves (KEK) e guardada junto ao texto cifrado (envelope encryption).
- A KEK não é guardada no banco de dados, então um dump vazado do banco de dados sozinho não expõe os segredos.
- Cada texto cifrado traz o ID da chave da KEK que envolveu a DEK dele. Com
key_manager = local, o ID da chave élocal:seguido de 16 dígitos hexadecimais derivados da KEK, então a mesma KEK sempre dá o mesmo ID. Você nunca atribui IDs. - Um texto cifrado fica vinculado ao ID da linha e ao nome da coluna em que é guardado. Copiá-lo para outra linha ou coluna o torna impossível de descriptografar.
- As colunas seladas, com os nomes que
my kek statusimprime, sãolocal_account_private_keys.private_key_enc(chaves privadas dos atores),totp_enrollments.secret_enc(segredos da autenticação em dois fatores),login_provider_secrets.sealed_secret(segredos de cliente dos provedores de login),webhook_secrets.sealed_secret(segredos de assinatura dos webhooks),instance_secrets.sealed_secret(a chave de assinatura do proxy de mídia e a chave das impressões digitais de idempotência),tls_acme_accounts.sealed_private_key(as chaves das contas ACME quando o servidor obtém os próprios certificados) etls_certificates.sealed_private_key(as chaves desses certificados). - O estado de um login com passkey ou de um login por um provedor externo é selado do mesmo modo, mas não é guardado: o navegador o mantém por no máximo 30 minutos.
- A chave de assinatura (HMAC-SHA256) das URLs do proxy de mídia é uma chave aleatória que o servidor gera na primeira inicialização e guarda no banco de dados, criptografada como os outros segredos.
Ela não muda quando você troca a KEK, então as URLs do proxy de mídia continuam funcionando entre as trocas, e
my kek rewrapa envolve de novo junto com os outros segredos. key_managerélocal(o padrão: usa a configuraçãokek),gcpkms(a KEK fica no Google Cloud KMS; veja Google Cloud KMS),awskms(a KEK fica no AWS KMS; veja AWS KMS) ouplugin(a KEK fica com um programa seu; veja Um plugin).
O que acontece se você perder a KEK
Seção intitulada “O que acontece se você perder a KEK”Sem a KEK, restaurar o banco de dados não permite descriptografar as chaves privadas dos atores. Quando uma chave privada se perde, outros servidores não conseguem mais verificar as assinaturas desse ator, e a identidade do ator no fediverso fica quebrada (os relacionamentos dos seguidores não podem ser levados adiante). Trate a KEK com o mesmo cuidado que o banco de dados.
O que não é selado continua legível: publicações, contas, seguimentos e o restante do banco de dados, e os arquivos de mídia no armazenamento.
Todo valor selado falha com o erro unknown key-encryption key: as chaves privadas dos atores, os segredos da autenticação em dois fatores,
os segredos de cliente dos provedores de login, os segredos de assinatura dos webhooks, a chave de assinatura do proxy de mídia e as chaves dos certificados que o próprio servidor obteve.
O mesmo acontece quando outra KEK é definida no lugar da que envolveu os segredos, ou quando a chave do KMS ou a chave do plugin que os envolveu é desativada ou destruída.
Gerar uma KEK
Seção intitulada “Gerar uma KEK”Codifique 32 bytes aleatórios com base64 padrão.
openssl rand -base64 32Onde openssl não estiver disponível, head -c 32 /dev/urandom | base64 também funciona. Não deixe o valor gerado no histórico do terminal nem em tickets.
Armazenar e entregar
Seção intitulada “Armazenar e entregar”A KEK é uma configuração secreta, então só pode ser passada pela variável de ambiente MY_KEK ou por MY_KEK_FILE, o caminho de um arquivo que contém o valor. Colocá-la no arquivo de configuração (TOML) impede a inicialização.
| Destino | Exemplo de como entregá-la |
|---|---|
| Auto-hospedado (binário / systemd) | Coloque-a em um arquivo que só o dono possa ler (chmod 600) e aponte MY_KEK_FILE para ele |
| Docker / Compose | Monte um segredo do Docker em /run/secrets/my_kek e defina MY_KEK_FILE=/run/secrets/my_kek. Os arquivos de deploy/docker fazem isso a partir de secrets/kek (Arquivos do Docker Compose): para rotacionar, substitua esse arquivo e defina MY_KEK_PREVIOUS em .env |
| Kubernetes / microk8s | Monte um Secret como arquivo e aponte MY_KEK_FILE para ele |
| Cloud Run | Exponha um segredo do Secret Manager como arquivo ou como variável de ambiente |
| AWS ECS | Passe-a a partir do Secrets Manager ou do SSM Parameter Store (SecureString) |
- Dê a mesma KEK a todos os processos, como web e worker.
- A KEK nunca aparece em logs nem em mensagens de erro (apenas o ID da chave aparece).
my config checkvalida o formato da KEK (base64 de 32 bytes) e imprime o valor como(redacted). No perfilproduction, ele também falha com uma KEK que não seja aleatória, como todos os bytes zero ou um byte repetido, emy serveregistra um aviso sobre ela (veja a lista de verificação de produção).
Faça o backup
Seção intitulada “Faça o backup”Faça o backup do banco de dados e da KEK, separadamente.
- Mantenha a KEK em um lugar diferente de onde ficam os backups do banco de dados (um gerenciador de senhas, mídia offline, um armazenamento de segredos em outra conta e assim por diante). Se os dois estiverem no mesmo lugar, o vazamento desse lugar torna inútil a criptografia do banco de dados.
- Durante uma rotação, inclua as chaves de
kek_previousno backup enquanto ainda houver no banco de dados texto cifrado envolvido por elas. - Inclua a KEK no seu procedimento de restauração e teste as restaurações regularmente (Backup e restauração). Depois de restaurar um banco de dados, defina a KEK (e
kek_previous) que estava em uso na hora do backup com os mesmos valores. Com uma KEK diferente, tudo o que lê um segredo falha com um errounknown key-encryption keyque nomeia o ID da chave.
Rotacionar a KEK
Seção intitulada “Rotacionar a KEK”Uma KEK em kek_previous é usada apenas para decifrar, e os novos segredos são sempre criptografados com kek.
Para que um deploy gradual, em que processos antigos e novos rodam lado a lado, nunca produza texto cifrado que algum processo não consiga ler, faça a troca em duas etapas.
- Gere uma nova KEK e faça o backup dela.
- Reinicie todos os processos com
MY_KEK=<old KEK>eMY_KEK_PREVIOUS=<new KEK>. Agora todos os processos conseguem decifrar com a nova KEK. - Reinicie todos os processos com
MY_KEK=<new KEK>eMY_KEK_PREVIOUS=<old KEK>. A partir de agora os segredos são envolvidos com a nova KEK, e o texto cifrado da KEK antiga continua legível. - Reenvolva os segredos armazenados com a nova KEK: execute
my kek rewrapuma vez, com a mesma configuração da etapa 3 (veja Reenvolver os segredos armazenados). Quando ele terminar com 0, nenhum segredo no banco de dados precisa mais da KEK antiga. - Espere pelo menos 30 minutos depois da etapa 3, para que os tokens de login de curta duração emitidos com a KEK antiga tenham expirado, e então reinicie todos os processos com
MY_KEK=<new KEK>e semkek_previous. Guarde o backup da KEK antiga enquanto você mantiver backups do banco de dados feitos antes da etapa 4: restaurar um deles volta a precisar dela.
kek_previous aceita várias chaves separadas por vírgula. Listar a mesma chave duas vezes, ou listar a mesma chave que kek, impede a inicialização.
Reenvolver os segredos armazenados
Seção intitulada “Reenvolver os segredos armazenados”my kek rewrap substitui apenas a chave de criptografia de dados envolvida de cada segredo e mantém o texto cifrado dele; nunca grava nem imprime um segredo.
my kek status # count the stored secrets by the key ID of the KEK that wraps them; decrypts nothingmy kek rewrap # re-wrap every secret that a key of kek_previous wraps with kekmy kek statusimprime uma linha por coluna e ID de chave, marca o ID da chave dekekcom(current)e termina informando se algum segredo ainda precisa de uma chave dekek_previous. Um ID de chave que não ékeknem está emkek_previoussignifica que falta uma KEK na configuração.my kek rewraplê os segredos em lotes de 100 e grava cada lote em uma transação curta. Ele imprime, por coluna, quantos segredos reenvolveu e quantos já estavam envolvidos comkek. Pode rodar enquanto o servidor está em operação e é seguro interrompê-lo ou executá-lo de novo a qualquer momento: ele pula os segredos já envolvidos comkek, e um segredo que o servidor reescreveu nesse meio-tempo é deixado como o servidor o gravou.- Um segredo que não pode ser reenvolvido é deixado inalterado e informado com o ID da linha, e o comando termina com 1. Ou a KEK dele não está configurada
(a mensagem nomeia o ID da chave: adicione essa KEK a
kek_previouse execute de novo), ou o valor armazenado está danificado ou foi copiado de outra linha. Não remova uma KEK dekek_previousenquantomy kek statusainda contar segredos sob ela.
Google Cloud KMS
Seção intitulada “Google Cloud KMS”Com key_manager = gcpkms, uma chave simétrica do Cloud KMS (uma CryptoKey com a finalidade ENCRYPT_DECRYPT) envolve as chaves de criptografia de dados, e a KEK nunca sai do Cloud KMS.
Um dump vazado do banco de dados e uma configuração vazada, juntos, ainda não expõem os segredos: decifrá-los exige a permissão para usar a chave.
- Defina
kms_keycom o nome do recurso da chave, sem versão:projects/{project}/locations/{location}/keyRings/{ring}/cryptoKeys/{key}. Nomes com mais de 248 bytes são rejeitados na inicialização. O ID da chave dos segredos armazenados égcpkms:seguido desse nome. - O servidor se autentica com as Application Default Credentials: no Cloud Run, a conta de serviço do serviço; em outros lugares,
GOOGLE_APPLICATION_CREDENTIALS. - Conceda a essa conta de serviço
roles/cloudkms.cryptoKeyEncrypterDecrypterna chave (não no projeto), para todos os processos, como web e worker, e para os comandosmy kek statusemy kek rewrap. Sem isso, a leitura de um segredo falha com um erro que nomeia a função; uma versão de chave ausente ou desativada falha da mesma forma, e esses erros não são repetidos até que a configuração seja corrigida. Um erro de cota ou um Cloud KMS indisponível é temporário, e o trabalho que precisava do segredo é repetido. - O servidor mantém por
kms_dek_cache_ttl(padrão10m) uma chave de criptografia de dados que o Cloud KMS decifrou, então a maioria das leituras de um segredo não chama o Cloud KMS.
Rotacionar a chave no Cloud KMS
Seção intitulada “Rotacionar a chave no Cloud KMS”Uma rotação no Cloud KMS (manual, ou com um período de rotação na chave) adiciona uma nova versão primária e mantém as versões antigas habilitadas.
Os novos segredos são envolvidos com a nova versão, o servidor decifra cada segredo com a versão que o envolveu, e o ID da chave não muda, então uma rotação não precisa de my kek rewrap.
Não desative nem destrua uma versão antiga enquanto ainda houver segredos que dependam dela: um segredo envolvido com uma versão desativada ou destruída não pode mais ser decifrado. O Cloud KMS não informa quais segredos uma versão envolveu, então, para aposentar material de chave, mova primeiro os segredos para uma nova chave:
- Crie uma nova chave (ela pode estar no mesmo key ring) e conceda à conta de serviço a função nela.
- Reinicie todos os processos com
kms_keydefinido com a nova chave ekms_key_previousdefinido com a antiga. A chave antiga agora só decifra. - Execute
my kek rewrap, com a mesma configuração. Quandomy kek statusnão contar mais segredos sob o ID da chave antiga, removakms_key_previouse reinicie. - Só então desative as versões da chave antiga e mantenha-as restauráveis enquanto você mantiver backups do banco de dados feitos antes da etapa 3: restaurar um deles volta a precisar delas.
AWS KMS
Seção intitulada “AWS KMS”Com key_manager = awskms, uma chave simétrica do AWS KMS (key spec SYMMETRIC_DEFAULT, key usage ENCRYPT_DECRYPT, gerenciada pelo cliente) envolve as chaves de criptografia de dados, e a KEK nunca sai do AWS KMS.
Um dump vazado do banco de dados e uma configuração vazada, juntos, ainda não expõem os segredos: decifrá-los exige a permissão para usar a chave.
-
Defina
kms_keycom o ARN da chave (arn:aws:kms:{region}:{account}:key/{key-id}), um alias (alias/{name}ou o ARN dele) ou o ID da chave. Na inicialização, o servidor resolve o nome para o ARN da chave, e o ID da chave dos segredos armazenados éawskms:seguido desse ARN. Apontar um alias para outra chave, portanto, não muda nada até a próxima inicialização, e então apenas para novos segredos: os segredos já armazenados continuam nomeando a chave antiga, então defina-a emkms_key_previous(veja Retirar uma chave do AWS KMS). Chaves gerenciadas pela AWS (alias/aws/...) são rejeitadas; apenas o serviço da AWS que é dono de uma pode usá-la. -
O servidor se autentica com a cadeia de credenciais padrão do AWS SDK: no ECS, a role da tarefa; no EC2, o instance profile; em outros lugares, o ambiente (
AWS_ACCESS_KEY_IDe semelhantes) ou os arquivos de configuração compartilhados. A região é a do ARN da chave; para um alias ou um ID de chave, definaAWS_REGION. -
Permita
kms:Encrypt,kms:Decryptekms:DescribeKeyna chave, para todos os processos, como web e worker, e para os comandosmy kek statusemy kek rewrap. Uma política da role do IAM:{"Effect": "Allow","Action": ["kms:Encrypt", "kms:Decrypt", "kms:DescribeKey"],"Resource": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"}O recurso é o ARN da chave mesmo quando
kms_keyé um alias. A política da chave também deve permitir que as políticas do IAM da conta concedam acesso (a política de chave padrão permite). -
O servidor não inicia quando a chave não existe, está desativada ou pendente de exclusão, ou não é uma chave simétrica de criptografia. Mais tarde, uma permissão ausente ou uma chave desativada faz a leitura de um segredo falhar com um erro que nomeia a causa, e esses erros não são repetidos até que a configuração seja corrigida. Limitação de taxa (
ThrottlingException) ou um AWS KMS indisponível é temporário, e o trabalho que precisava do segredo é repetido. -
O contexto de criptografia de cada chamada contém o ID da linha e o nome da coluna do segredo (
{"my-aad": ...}, em base64url). O CloudTrail o registra em texto simples; ele não contém nenhum segredo. -
Custo: a AWS cobra uma taxa mensal por cada chave gerenciada pelo cliente (USD 1 na data desta escrita, mais o mesmo valor por cada uma das duas primeiras rotações do material da chave) e uma taxa por requisição além de uma camada gratuita mensal (veja os preços do AWS KMS). O servidor mantém por
kms_dek_cache_ttl(padrão10m) uma chave de criptografia de dados que o AWS KMS decifrou, então um servidor com dez atores que entregam o tempo todo faz cerca de 43.000 requisições por mês por processo, alguns centavos além da camada gratuita.
Retirar uma chave do AWS KMS
Seção intitulada “Retirar uma chave do AWS KMS”A rotação automática de chaves no AWS KMS mantém o ARN da chave e o material de chave anterior, então o ID da chave não muda e uma rotação não precisa de my kek rewrap.
Para deixar de usar uma chave, ou para apontar um alias para outra chave, mova primeiro os segredos para a nova chave. Não desative a chave antiga nem agende a exclusão dela enquanto ainda houver segredos que dependam dela: um segredo envolvido com ela não pode mais ser decifrado.
- Crie a nova chave e permita que a role a use.
- Reinicie todos os processos com
kms_keydefinido com a nova chave ekms_key_previousdefinido com a antiga (o ARN dela, não o alias). A chave antiga agora só decifra. - Execute
my kek rewrap, com a mesma configuração. Quandomy kek statusnão contar mais segredos sob o ID da chave antiga, removakms_key_previouse reinicie. - Só então desative a chave antiga e mantenha-a enquanto você mantiver backups do banco de dados feitos antes da etapa 3: restaurar um deles volta a precisar dela.
Um plugin
Seção intitulada “Um plugin”Com key_manager = plugin, um plugin seu guarda a KEK, no Vault, em um HSM ou onde ele escolher, e envolve as chaves de criptografia de dados para o servidor.
O plugin fica no mesmo limite de confiança que a KEK. Ele vê todas as chaves de criptografia de dados em texto simples, então quem o controla, ou controla o host em que ele roda, pode ler todos os segredos do servidor, inclusive as chaves privadas dos atores. Dê a ele a proteção que você dá à KEK. Por isso também nenhuma configuração além do arquivo de configuração e do ambiente pode alterar o endereço dele.
MY_KEY_MANAGER=pluginMY_PLUGIN_KEY_MANAGER_ADDRESS=unix:///run/my/key_manager.sock- O endereço é
unix://ouhttps://. O servidor recusahttp://, inclusive em loopback, já que as chaves trafegariam em texto simples. As outras configurações do destino estão em Plugins. - Execute
my plugin test --kind key_manager <address>antes de apontar o servidor para um plugin (Testar um plugin). Ele envolve apenas chaves que inventa e descarta. - O ID da chave dos segredos armazenados é
plugin:seguido do ID que o plugin dá à sua KEK, que tem de 1 a 248 bytes de ASCII visível. - Mantenha toda KEK que um segredo armazenado ainda nomeia. Uma rotação no plugin aparece como um novo ID no próximo envolvimento. Os segredos envolvidos antes continuam nomeando o ID antigo, e o plugin ainda precisa conseguir abri-los.
my kek rewrapos move para o ID atual, emy kek statusconta os que restam. - Um plugin e um KMS nunca atuam juntos:
kms_keyekms_key_previoussão recusados com um plugin, eplugin_key_manager_addresstambém é recusado comkey_manager = gcpkmsouawskms.
Quando o servidor inicia
Seção intitulada “Quando o servidor inicia”Todo processo, e todo comando my que abre o banco de dados, como my kek status, faz isto antes de qualquer outra coisa. É o único tipo de plugin cuja falha impede uma inicialização.
- Ele pergunta ao plugin o ID da KEK atual dele.
- Ele executa um autoteste com uma chave aleatória que descarta: um envolvimento e um desenvolvimento devem devolver a chave, um desenvolvimento com outros dados autenticados deve responder
OUTCOME_DECRYPT, dois envolvimentos da chave devem diferir, e o valor envolvido não deve conter a chave.
Um plugin que não responde, ou responde 503, é tentado de novo por até 30 segundos, para o caso de um sidecar que sobe depois do servidor. Depois disso, o processo termina com um erro. Uma resposta errada, e qualquer outra falha, como um token recusado, o interrompe imediatamente: o autoteste existe para barrar um plugin que ignora os dados autenticados ou repassa chaves, e esperar não conserta um plugin assim.
Quando o plugin está inacessível
Seção intitulada “Quando o plugin está inacessível”O servidor falha de forma fechada. Seja qual for o problema, uma chamada recusada ou com tempo esgotado, ou uma resposta vazia, desconhecida ou malformada, a operação que precisava da chave falha com um erro. Ele nunca armazena um segredo em texto simples, nunca passa para a KEK local ou para outra chave e nunca trata uma falha como um resultado. Um job que falha assim é repetido depois, e uma requisição falha para a pessoa que a fez. Cada chamada que falha é contada em my.plugin.failures por tipo e código Connect, e o log não contém chave, dados autenticados nem valor envolvido, nem nada do que o plugin disse.
O envolvimento nunca é armazenado em cache, e um valor selado há pouco não tem nada no cache, então estes param imediatamente:
- Criar uma conta, que gera as chaves do ator.
- Configurar a autenticação de dois fatores e registrar uma passkey ou entrar com uma, cujas cerimônias mantêm o estado selado.
- Entrar por meio de um provedor externo e salvar o segredo de cliente de um provedor.
- Registrar um webhook e
my kek rewrap.
Ler um segredo armazenado só funciona enquanto o processo guarda a chave de criptografia de dados dele de uma leitura anterior, por no máximo kms_dek_cache_ttl (padrão 10m). Depois disso, ou para um segredo que ele ainda não leu, estes também param:
- A entrega da federação e as buscas assinadas, que precisam das chaves privadas dos atores. A entrega se recupera pelas repetições dos jobs dela, assim que o plugin voltar.
- A verificação de um código de dois fatores no login.
- A entrega de webhooks.
Uma reinicialização para como descrito acima, então não reinicie o servidor para consertar uma indisponibilidade do plugin: um servidor que está no ar continua servindo o que o cache dele cobre, e um que reinicia não serve nada até o plugin responder. O que não precisa de segredo, como ler linhas do tempo e publicar, continua. A chave de assinatura do proxy de mídia é lida na inicialização e fica na memória. Um certificado de cliente ou um arquivo de CA renovado também não precisa de reinicialização: o servidor lê os arquivos de novo quando mudam (Plugins).
O contrato
Seção intitulada “O contrato”As RPCs são as de my.plugin.key_manager.v1.KeyManagerService, com um prazo padrão de 5 segundos e mensagens de no máximo 128 KiB em cada direção.
POST /my.plugin.key_manager.v1.KeyManagerService/Describe{}{"outcome":"OUTCOME_OK","keyId":"transit/my-kek-3"}
POST /my.plugin.key_manager.v1.KeyManagerService/WrapKey{"dek":"<base64>","aad":"<base64>"}{"outcome":"OUTCOME_OK","keyId":"transit/my-kek-3","wrapped":"<base64>"}
POST /my.plugin.key_manager.v1.KeyManagerService/UnwrapKey{"keyId":"transit/my-kek-3","wrapped":"<base64>","aad":"<base64>"}{"outcome":"OUTCOME_OK","dek":"<base64>"}keyIdé o ID próprio do plugin, semplugin:.UnwrapKeypode nomear um ID mais antigo que o atual.wrappedtem de 1 a 65.535 bytes e não deve conter a chave. Dois envolvimentos de uma chave diferem.aadsão os dados autenticados que contêm IDs de linha e nomes de coluna, eUnwrapKeydeve falhar a menos que seja o queWrapKeyrecebeu. É isso que impede que um segredo seja copiado para outra linha.- Nunca registre
dek,aadouwrappedem log.
outcome |
Significado |
|---|---|
OUTCOME_OK |
A chamada foi bem-sucedida |
OUTCOME_UNKNOWN_KEY |
UnwrapKey: o plugin não possui a KEK de keyId |
OUTCOME_DECRYPT |
UnwrapKey: wrapped ou aad não autentica |
Responda com um erro HTTP ou Connect quando não puder responder, como quando o armazenamento de chaves está fora de alcance. Não responda OUTCOME_DECRYPT nem OUTCOME_UNKNOWN_KEY nesse caso: para o servidor, eles dizem que o próprio valor é inválido. O servidor não repete uma chamada por conta própria, então um plugin pode receber a mesma chamada de novo a partir de um job.
Migrar entre a KEK local e um KMS
Seção intitulada “Migrar entre a KEK local e um KMS”Um ID de chave começa com o tipo de gerenciador de chaves que o envolveu (local:, gcpkms:, awskms:, plugin:). O servidor envolve os novos segredos com o key_manager atual
e desenvolve cada segredo armazenado com o gerenciador de chaves que o ID da chave dele nomeia, então migrar entre a KEK local e um KMS é uma rotação entre tipos.
- Com um KMS,
kekekek_previousapenas decifram: eles abrem os segredos ainda envolvidos com a KEK local, e todo novo segredo é envolvido comkms_key.kms_key_previouslista chaves anteriores do mesmo KMS, que também apenas decifram. - Com
key_manager = local,kms_keyekms_key_previous, quando definidos, apenas decifram: eles abrem os segredos ainda envolvidos com o KMS. - Da KEK local para um KMS:
- Crie a chave e conceda as permissões como em Google Cloud KMS ou AWS KMS.
- Reinicie todos os processos com
key_manager = gcpkmsouawskms,kms_keydefinido com a chave e a KEK atual movida dekekparakek_previous. Os segredos agora são envolvidos com o KMS, e os que foram envolvidos com a KEK local continuam abrindo. - Execute
my kek rewrapcom a mesma configuração. - Quando
my kek statusnão contar mais segredos sob um ID de chavelocal:, removakek_previouse reinicie. Guarde o backup da KEK enquanto você mantiver backups do banco de dados feitos antes da etapa 3.
- De um KMS de volta para a KEK local, faça o mesmo no sentido contrário: defina
key_manager = locale uma novakek, e mantenhakms_keydefinido, que agora apenas decifra, até quemy kek rewraptenha movido todos os segredos emy kek statusnão conte mais segredos sob um ID de chavegcpkms:ouawskms:. As chaves emkms_keyekms_key_previousdevem então pertencer todas ao mesmo KMS. - Para migrar do KMS de uma nuvem para o de outra, migre primeiro para a KEK local e depois para o outro KMS; não há migração direta.
- Um plugin migra da mesma forma, passando apenas pela KEK local:
- Para ele, reinicie todos os processos com
key_manager = plugin,plugin_key_manager_addresse a KEK atual movida dekekparakek_previous, e então executemy kek rewrap. Quandomy kek statusnão contar mais segredos sob um ID de chavelocal:, removakek_previouse reinicie. - A partir dele, reinicie todos os processos com
key_manager = local, uma novakekeplugin_key_manager_addressmantido, que agora apenas decifra, e então executemy kek rewrap. Quandomy kek statusnão contar mais segredos sob um ID de chaveplugin:, remova o endereço e reinicie. Até lá, o plugin ainda precisa passar as verificações na inicialização, que incluem um envolvimento.
- Para ele, reinicie todos os processos com
- O servidor mantém por
kms_dek_cache_ttl(padrão10m, no máximokms_dek_cache_entries, padrão1024) uma chave de criptografia de dados que o KMS ou o plugin decifrou, então um segredo em uso chega a ele cerca de uma vez por período e por processo.0em qualquer uma das configurações desativa o cache.
Se a KEK vazar
Seção intitulada “Se a KEK vazar”Se apenas a KEK vazou, rotacione-a como acima. Se a KEK e o banco de dados podem ter vazado, a rotação não protege você: as chaves privadas dos atores no banco de dados já estão legíveis, então as próprias chaves dos atores precisam ser geradas novamente.
Chave VAPID do Web Push
Seção intitulada “Chave VAPID do Web Push”O Web Push é assinado com a chave VAPID do servidor (P-256, RFC 8292). É um segredo separado da KEK e não é armazenado no banco de dados.
- Crie um par de chaves com
my config vapid-keye dê a todos os processos a chave privada (o valor devapid_private_key = ...) por meio deMY_VAPID_PRIVATE_KEYouMY_VAPID_PRIVATE_KEY_FILE. O servidor deriva a chave pública da chave privada e a entrega aos clientes, então você não a configura. - Se você não a definir, o Web Push fica desativado e os clientes não o oferecem. No perfil
production,my config checke a inicialização demy serveavisam sobre isso. - Os navegadores vinculam uma assinatura à chave pública, então alterar a chave interrompe a entrega para as assinaturas existentes. Quando um usuário ativa as notificações push de novo nas configurações, o cliente se inscreve novamente com a nova chave. Não altere a chave a menos que ela tenha vazado; se vazar, passe para uma nova chave e peça aos usuários que ativem as notificações de novo.
Para LLMs e agentes de programação:llms.txt,llms-full.txt, llms-small.txt