Como os bytes viram caracteres
A Base64 é uma codificação que transforma uma sequência de bytes em caracteres de texto. Ela permite incluir um arquivo binário em um campo textual, como uma string de uma mensagem JSON.
O codificador reúne três bytes em um bloco de 24 bits e o divide em quatro grupos de seis bits. Cada grupo seleciona um caractere de um alfabeto com 64 símbolos. Quando o último grupo de entrada tem menos de três bytes, a forma padrão usa o sinal = para completar a saída. A RFC 4648 define esse mecanismo.
Uma conversão que você pode conferir no Node.js
O exemplo abaixo usa o texto Oi para deixar a entrada e a saída visíveis. O mesmo processo de codificação aceita os bytes de um arquivo.
const bytes = Buffer.from('Oi', 'utf8');const codificado = bytes.toString('base64');const recuperado = Buffer.from(codificado, 'base64');
console.log(codificado);console.log(recuperado.toString('utf8'));A saída contém T2k= na primeira linha e Oi na segunda. Os dois bytes da entrada geram quatro caracteres, incluindo o preenchimento. A decodificação recupera os bytes originais, como documenta a referência de Buffer do Node.js.
Para uma imagem, você usaria os bytes recuperados como conteúdo do arquivo. A conversão final para UTF-8 só faz sentido neste exemplo porque a entrada é texto nessa codificação.
Tamanho e compatibilidade na integração
A Base64 aumenta o tamanho da representação e permite recuperar o conteúdo sem uma chave secreta. Portanto, um token ou arquivo privado codificado dessa forma continua exigindo proteção contra leitura indevida.
Você também precisa conferir a variante exigida pela API. A Base64url altera dois símbolos do alfabeto e pode omitir o preenchimento quando o protocolo permite. O uso de um decodificador permissivo não comprova que a mensagem enviada cumpre o formato exigido pelo destino.
Dúvidas frequentes
Perguntas frequentes sobre base64
- A Base64 mantém uma senha em segredo?
- A sequência pode ser decodificada sem uma chave secreta. Uma senha em Base64 continua legível após a conversão, por isso exige os cuidados de transporte e armazenamento próprios de uma credencial.
- Quanto a Base64 aumenta o tamanho?
- Cada três bytes completos geram quatro caracteres. Com o preenchimento padrão, o comprimento é quatro vezes o número de grupos de três bytes, arredondado para cima. Em arquivos grandes, o aumento se aproxima de 33%, sem incluir outros campos da mensagem.
- Base64 e Base64url usam os mesmos caracteres?
- A Base64url substitui o sinal de mais e a barra pelos caracteres hífen e sublinhado. O protocolo que a utiliza também define se o preenchimento com o sinal de igual pode ser omitido.
Para continuar
Recursos relacionados
Documentação
RFC 4648: codificações Base-N
Definição dos alfabetos Base64 e Base64url, do preenchimento e dos exemplos de conversão.
Abrir recursoAplicação na formação
n8n Experts
Uma integração que recebe arquivos em Base64 precisa identificar o campo codificado e recuperar os bytes no formato esperado pela API de destino.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.