Codificador e decodificador Base32 (RFC 4648)

Como codificar texto em Base32

1. Digite ou cole o texto em Entrada · Texto. Com Ao vivo marcado, a saída é atualizada a cada tecla.
2. Leia o resultado em Saída · Base32 (RFC 4648). Desmarque Preenchimento (=) abaixo da saída para remover os sinais = do final.
3. Para outra variante, abra Para e escolha Base32hex, Crockford Base32 ou z-base-32.
4. Para decodificar, clique em Base32 (RFC 4648) → Texto no seletor de direção. O decodificador Base32 dedicado já começa nessa direção.
5. Use Copiar saída ou Baixar para levar o resultado.

O texto é convertido em bytes como UTF-8 por padrão. Se você precisa do Base32 do mesmo texto em outra codificação, por exemplo Windows-1252 ou UTF-16LE, mude o Charset abaixo da entrada.

Como o Base32 funciona

O Base32 lê a entrada de 5 em 5 bits e escreve um caractere para cada 5 bits. Cinco bytes (40 bits) viram exatamente oito caracteres, então a saída é 60% maior que a entrada. Uma string Base64 dos mesmos dados seria 33% maior; esse é o preço que o Base32 paga por usar só letras maiúsculas e seis dígitos.

Quando o comprimento da entrada não é múltiplo de 5 bytes, o último grupo é completado com = até 8 caracteres. Estes são os vetores de teste da RFC 4648, gerados por esta ferramenta:

O preenchimento não carrega dados. Um decodificador consegue calcular o número de bytes pela quantidade de caracteres reais, e é por isso que muitos formatos o descartam.

Variantes do Base32: RFC 4648, base32hex, Crockford, z-base-32

“Base32” é o nome de uma família. Os quatro membros empacotam 5 bits por caractere; eles diferem no alfabeto e no uso de preenchimento. Os mesmos cinco bytes, Hello, em cada um:

Base32hex e Crockford se parecem, mas são alfabetos diferentes: depois do H eles divergem, então 91IMOR3F e 91JPRV3F são os mesmos bytes. Escolher o errado decodifica sem erro e entrega bytes diferentes sem avisar.

O decodificador Crockford daqui é tolerante do jeito que Crockford pretendia: ele lê I e L como 1, O como 0 e ignora hifens, então 91JP-RV3F ainda dá Hello. Ele não acrescenta nem verifica o símbolo de verificação opcional do Crockford.

Base32 para segredos TOTP e 2FA

Os apps autenticadores recebem o segredo de um link otpauth://, geralmente mostrado como QR code:

otpauth://totp/Example:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=Example

O parâmetro secret é Base32 da RFC 4648 sem preenchimento. JBSWY3DPEHPK3PXP tem 16 caracteres, então contém 10 bytes. A RFC 4226 recomenda um segredo de 160 bits (20 bytes), que dá 32 caracteres Base32. Se o seu segredo está guardado em Base64 ou hex, converta-o com o Base64 para Base32. Digitar o texto Base64 nesta página codifica os caracteres dele, o que gera Base32 válido, mas dos bytes errados, e todo código gerado a partir dela será rejeitado.

Um segredo TOTP é uma chave: qualquer um que o tenha consegue gerar os seus códigos. Esta página trabalha com o segredo dentro da aba do seu navegador, e o Content Security Policy dela impede que a página faça requisições de rede, exceto as do contador de visitas da Cloudflare.

Base32 na linha de comando e em Python

O GNU coreutils tem um comando base32 que funciona como o base64:

printf 'Hello' | base32
printf 'JBSWY3DP' | base32 -d

A primeira linha imprime JBSWY3DP, a segunda, Hello. A biblioteca padrão do Python tem as três formas da RFC 4648:

import base64

base64.b32encode(b"Hello")                          # b'JBSWY3DP'
base64.b32hexencode(b"Hello")                       # b'91IMOR3F'
base64.b32encode(b"Hi").decode().rstrip("=")        # 'JBUQ'

Mais receitas de codificação estão na página de Python. Para decodificar, incluindo os erros de preenchimento e de minúsculas que o Python lança, veja o decodificador Base32.

Perguntas frequentes