Codificador/Decodificador Base64URL

O que é a codificação Base64url?

Base64url é uma variante da codificação Base64 projetada especificamente para uso em URLs, nomes de arquivo e outros contextos onde os caracteres padrão do Base64 + e / causam problemas. Definida na RFC 4648 Seção 5, a Base64url substitui + por - (hífen) e / por _ (sublinhado), e omite os caracteres de preenchimento = finais. O resultado é uma string que pode ser incorporada diretamente em um parâmetro de consulta de URL, um nome de arquivo ou um cabeçalho HTTP sem exigir codificação percentual adicional.

O Base64 padrão (RFC 4648 Seção 4) usa 64 caracteres: A-Z, a-z, 0-9, + e /. Os caracteres + e / são reservados em URLs: + é interpretado como espaço em strings de consulta (application/x-www-form-urlencoded) e / é um delimitador de caminho. Usar Base64 padrão dentro de uma URL exige, portanto, codificação percentual desses caracteres (%2B, %2F), o que aumenta o comprimento da string e dificulta a leitura. O Base64url elimina esse problema por completo usando caracteres seguros para URL desde o início.

O uso mais proeminente do Base64url é em JSON Web Tokens (JWT). Todos os três segmentos de um JWT — cabeçalho, payload e assinatura — são codificados em Base64url. Verificadores de código PKCE do OAuth 2.0, valores de desafio do WebAuthn e muitos esquemas de tokens de API também dependem do Base64url. Compreender essa codificação é essencial para qualquer desenvolvedor que trabalha com autenticação, autorização ou troca de dados criptográficos.

Por que usar esta ferramenta Base64url?

Converta entre Base64url e texto ou dados binários diretamente no seu navegador. Tanto a codificação quanto a decodificação são suportadas, com tratamento automático de preenchimento e substituição de caracteres. Seja para depurar um token JWT, gerar um desafio de código PKCE ou criar identificadores seguros para URL, esta ferramenta processa tudo localmente no seu navegador com zero latência e sem necessidade de requisições ao servidor.

Casos de Uso do Base64url

Base64 Padrão vs Base64url

O Base64url difere do Base64 padrão em exatamente três aspectos. O algoritmo de codificação é idêntico — apenas o alfabeto e o comportamento de preenchimento mudam:

Essas três diferenças significam que converter entre Base64 padrão e Base64url é trivial: substitua + por -, / por _, e remova os caracteres = finais. No sentido inverso, substitua - por +, _ por /, e adicione preenchimento para que o comprimento seja múltiplo de 4. A maioria das linguagens fornece suporte nativo a Base64url, tornando a conversão manual desnecessária.

Tabela de Comparação de Codificação

A tabela abaixo mostra as mesmas entradas codificadas com Base64 padrão e Base64url. Observe como os caracteres de preenchimento (=) são removidos e + / / são substituídos por - / _ na variante segura para URL:

Exemplos de Código

Como codificar e decodificar strings Base64url nas linguagens mais populares. Cada exemplo produz uma saída segura para uso em URLs, nomes de arquivo e cabeçalhos HTTP:

// Encode to Base64url
function toBase64url(str) {
  return btoa(unescape(encodeURIComponent(str)))
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/, '')
}
toBase64url('Hello!') // → "SGVsbG8h"

// Decode from Base64url
function fromBase64url(b64url) {
  const b64 = b64url.replace(/-/g, '+').replace(/_/g, '/')
  const pad = (4 - b64.length % 4) % 4
  return decodeURIComponent(escape(atob(b64 + '='.repeat(pad))))
}
fromBase64url('SGVsbG8h') // → "Hello!"

// Native base64url support since Node 15.7
const encoded = Buffer.from('Hello!').toString('base64url')
// → "SGVsbG8h"

const decoded = Buffer.from('SGVsbG8h', 'base64url').toString()
// → "Hello!"

// Decode a JWT payload
const jwt = 'eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0...'
const payload = JSON.parse(Buffer.from(jwt.split('.')[1], 'base64url').toString())
// → { sub: "1234567890" }

import base64

# Encode to Base64url (no padding)
encoded = base64.urlsafe_b64encode(b'Hello!').rstrip(b'=').decode()
# → "SGVsbG8h"

# Decode from Base64url (re-add padding)
def b64url_decode(s: str) -> bytes:
    s += '=' * (4 - len(s) % 4)  # restore padding
    return base64.urlsafe_b64decode(s)

b64url_decode('SGVsbG8h')  # → b'Hello!'

package main

import (
    "encoding/base64"
    "fmt"
)

func main() {
    // Encode to Base64url (no padding)
    encoded := base64.RawURLEncoding.EncodeToString([]byte("Hello!"))
    fmt.Println(encoded) // → "SGVsbG8h"

    // Decode from Base64url
    decoded, _ := base64.RawURLEncoding.DecodeString("SGVsbG8h")
    fmt.Println(string(decoded)) // → "Hello!"
}

Perguntas Frequentes