Conversor de Base64 para Base64URL (URL-safe)

Como converter Base64 para Base64URL

1. Cole o Base64 em Entrada · Base64. Quebras de linha de Base64 quebrado e um prefixo data:...;base64, são removidos automaticamente.
2. A string URL-safe aparece em Saída · Base64URL.
3. Marque Preenchimento (=) abaixo da saída se o destinatário quiser o = final.
4. Use Copiar saída. O seletor Base64URL → Base64, ou Base64URL para Base64, converte de volta.

A entrada é decodificada para bytes e recodificada, então uma string que não é Base64 válido recebe um erro em vez de um resultado convertido pela metade.

Exemplos

A última linha é comum. JSON curto e texto ASCII muitas vezes codificam sem + ou /, e quando o comprimento é múltiplo de 3 bytes também não há preenchimento, então as duas formas são idênticas. É por isso também que uma conversão esquecida pode passar despercebida nos testes até algum valor gerar por acaso um + ou /.

Caracteres do Base64 padrão que quebram URLs

Três caracteres do Base64 padrão têm significado especial em URLs:

• + significa espaço em query strings, então ?t=a+b chega como a b em muitos frameworks.
• / separa segmentos do caminho, então Base64 num caminho pode ser dividido ou roteado errado.
• = separa o nome do parâmetro de query do valor e precisa ser escrito como %3D para ficar seguro.

A seção 5 da RFC 4648 define o Base64URL para esse caso, com - e _ no lugar de + e / e um preenchimento que pode ser omitido. Valores assim dispensam escape em caminhos, query strings, cookies e nomes de arquivo. O artigo Base64 vs Base64URL traz os detalhes.

Onde o Base64URL é obrigatório

• JWT e JWS. Os três segmentos de um JSON Web Token usam Base64URL sem preenchimento. O decodificador de JWT lê esses segmentos, e Base64 no JWT explica o formato.
• PKCE do OAuth. Ferramentas de hash muitas vezes imprimem o digest SHA-256 do verifier em Base64 padrão, enquanto o code_challenge precisa ser esse digest em Base64URL sem preenchimento. Esta conversão é o último passo.
• WebAuthn e JWK. IDs de credencial, desafios e os parâmetros de chave de um JSON Web Key são Base64URL.
• URLs assinadas e tokens em links, como links de redefinição de senha ou de download, em que o valor fica num caminho ou numa query string.

Para codificar texto direto em Base64URL, sem passar pela forma padrão, use o codificador Base64URL.

Base64 para Base64URL no código

import base64
base64.urlsafe_b64encode(b"<<???>>").rstrip(b"=").decode()   # 'PDw_Pz8-Pg'

Buffer.from("PDw/Pz8+Pg==", "base64").toString("base64url");   // 'PDw_Pz8-Pg'
"PDw/Pz8+Pg==".replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");   // same, without Buffer

O urlsafe_b64encode do Python mantém o preenchimento, daí o rstrip. A codificação "base64url" do Node o remove. Mais nos guias de Python e Node.js.

Perguntas frequentes