Fatos principais
- Categoria
- Segurança e validação
- Tipos de entrada
- file, text, select, textarea
- Tipo de saída
- json
- Cobertura de amostras
- 4
- API disponível
- Yes
Visão geral
O Reempacotador de Bundle AGEX permite recriptografar arquivos de bundle AGEX existentes, aplicando uma nova frase secreta e novos parâmetros de derivação de chave Argon2id e criptografia XChaCha. Esta ferramenta facilita a rotação periódica de credenciais e a transferência segura de propriedade de dados criptografados sem expor o conteúdo de forma desprotegida.
Quando usar
- •Quando for necessário realizar a rotação periódica da frase secreta de segurança de um bundle AGEX.
- •Ao transferir a custódia ou responsabilidade de um bundle criptografado para outro proprietário com uma nova senha.
- •Para atualizar os parâmetros de segurança Argon2id/XChaCha de um bundle existente para uma intensidade diferente.
Como funciona
- •Carregue o arquivo de bundle AGEX original e insira a frase secreta atual para descriptografar temporariamente os dados na memória.
- •Defina a nova frase secreta e escolha o nível de intensidade de derivação de chave desejado.
- •Opcionalmente, insira o ID do signatário e a chave privada Ed25519 para assinar digitalmente o novo pacote gerado.
- •Processe o arquivo para gerar e baixar o novo bundle AGEX recriptografado com os novos parâmetros de segurança.
Casos de uso
Exemplos
1. Rotação Anual de Senha de Bundle
Administrador de Segurança de TI- Contexto
- A política da empresa exige que todos os arquivos de configuração criptografados tenham suas senhas alteradas a cada 12 meses.
- Problema
- Atualizar a frase secreta de um bundle AGEX de produção sem alterar os dados internos.
- Como usar
- Carregue o arquivo `config_prod.agex.json`, insira a frase secreta antiga no campo correspondente, defina a nova frase secreta forte e selecione a intensidade 'moderate'.
- Configuração de exemplo
-
{ "bundleFile": "config_prod.agex.json", "currentPassphrase": "senha_antiga_2025", "newPassphrase": "nova_senha_forte_2026", "strength": "moderate" } - Resultado
- Um novo arquivo JSON contendo o bundle AGEX recriptografado com a nova frase secreta e parâmetros Argon2id atualizados.
2. Transferência de Custódia com Assinatura Digital
Engenheiro de DevOps- Contexto
- Um bundle contendo chaves de API precisa ser transferido para a equipe de infraestrutura, exigindo uma nova senha e a assinatura digital do novo responsável.
- Problema
- Alterar a senha do bundle e aplicar uma assinatura digital Ed25519 válida para garantir a autenticidade.
- Como usar
- Envie o bundle original, insira a senha atual, defina a nova senha da equipe de infraestrutura, insira o ID do signatário e cole a chave privada Ed25519 em formato base64.
- Configuração de exemplo
-
{ "bundleFile": "api_keys.agex.json", "currentPassphrase": "chave_dev_atual", "newPassphrase": "chave_infra_nova", "strength": "sensitive", "signerId": "infra-signer-01", "signerPrivateKey": "MC4CAQAwBQYDK2VwBCIEINT..." } - Resultado
- O bundle AGEX é reempacotado com a nova senha sob a intensidade 'sensitive' e assinado digitalmente com a chave fornecida.
Testar com amostras
json, fileHubs relacionados
FAQ
O que é o reempacotamento de um bundle AGEX?
É o processo de descriptografar um bundle existente com a senha atual e criptografá-lo imediatamente com uma nova senha e novos parâmetros Argon2id/XChaCha.
Posso assinar o novo bundle durante este processo?
Sim, basta fornecer o ID do signatário e a chave privada Ed25519 correspondente nos campos opcionais.
Quais são os níveis de intensidade disponíveis para a nova criptografia?
Você pode escolher entre os níveis Interativo, Moderado e Sensível para ajustar o consumo de recursos do Argon2id.
O conteúdo original do bundle é alterado?
Não, o conteúdo interno permanece idêntico; apenas a camada de criptografia externa e os metadados de segurança são atualizados.
É obrigatório fornecer uma chave privada para reempacotar?
Não, a chave privada do signatário é opcional e serve apenas se você desejar aplicar uma assinatura digital ao novo bundle.