Texto para Base64: converter uma string em Base64

Como converter texto para Base64

1. Digite ou cole a string em Entrada · texto. Tudo o que você inserir é codificado exatamente, incluindo espaços e quebras de linha.
2. O Base64 aparece em Saída · Base64. O número Entrada abaixo dos botões mostra em quantos bytes o seu texto se transformou.
3. Deixe o Charset em UTF-8, a menos que o sistema que vai decodificar o valor espere outra coisa.
4. Marque URL-safe (- _) e Sem preenchimento (=) se a string for para uma URL ou um token.
5. Clique em Copiar saída, ou em Baixar para salvar como base64.txt.

Para voltar, use Base64 para texto, ou clique em Inverter para decodificar o resultado aqui mesmo.

Uma string, vários Base64 possíveis

O Base64 codifica bytes, e uma string só vira bytes por meio de um charset. É por isso que as mesmas cinco letras podem gerar quatro respostas diferentes:

Caracteres invisíveis também contam. Hello é SGVsbG8=, Hello com um espaço no final é SGVsbG8g, e Hello seguido de uma quebra de linha do Windows é SGVsbG8NCg==. Quebras de linha são uma armadilha clássica em valores com várias linhas: line1 e line2 unidos por \n viram bGluZTEKbGluZTI=, unidos por \r\n viram bGluZTENCmxpbmUy. Se dois sistemas discordam sobre um valor, compare primeiro a quantidade de bytes.

Qual será o comprimento da string Base64

Cada 3 bytes de entrada viram 4 caracteres, e um último grupo de 1 ou 2 bytes é completado até 4 com =.

Ou seja, uma string cresce cerca de um terço, e mais ainda se caracteres não ASCII ocuparem vários bytes cada em UTF-8. A página sobre o aumento de tamanho do Base64 traz os números exatos para saídas com quebra de linha.

Onde as strings codificadas vão parar

As pessoas convertem strings para Base64 principalmente para fazê-las passar por lugares que não se dão bem com caracteres especiais:

• Variáveis de ambiente e segredos de CI, onde um valor com aspas, $ ou quebras de linha seria corrompido. postgres://app:s3cret@db:5432/app vira cG9zdGdyZXM6Ly9hcHA6czNjcmV0QGRiOjU0MzIvYXBw, uma linha sem nada para escapar.
• Secrets do Kubernetes, cujos valores em data: precisam estar em Base64. O decodificador de Secrets do Kubernetes os lê de volta.
• Cabeçalhos HTTP, por exemplo Authorization: Basic com user:password codificado. O gerador de cabeçalho Basic Auth monta o cabeçalho completo.
• Campos JSON e XML que precisam levar texto arbitrário sem que as regras de escape atrapalhem (JSON para Base64).

Nada disso esconde o valor. Qualquer pessoa com a string consegue decodificá-la, então trate um segredo codificado como um segredo em texto puro; veja codificação vs criptografia.

String para Base64 no código

import base64

base64.b64encode("Grüße".encode("utf-8")).decode("ascii")   # 'R3LDvMOfZQ=='
base64.b64encode("Grüße".encode("cp1252")).decode("ascii")  # 'R3L832U='

// Node.js
Buffer.from("Grüße", "utf8").toString("base64");     // "R3LDvMOfZQ=="
Buffer.from("Grüße", "utf16le").toString("base64");  // "RwByAPwA3wBlAA=="

As duas linguagens exigem que o passo de string para bytes seja explícito, e é nele que fica a escolha do charset. Mais nas páginas de Python e Node.js.

Perguntas frequentes