Base64 URL-safe

Wat is Base64url-codering?

Base64url is een variant van Base64-codering die specifiek is ontworpen voor gebruik in URL's, bestandsnamen en andere contexten waar de standaard Base64-tekens + en / problemen veroorzaken. Gedefinieerd in RFC 4648 Section 5 vervangt Base64url + door - (koppelteken) en / door _ (onderstrepingsteken), en laat de afsluitende =-opvultekens weg. Het resultaat is een string die direct in een URL-queryparameter, een bestandsnaam of een HTTP-header kan worden opgenomen zonder extra procentcodering.

Standaard Base64 (RFC 4648 Section 4) gebruikt 64 tekens: A-Z, a-z, 0-9, + en /. De tekens + en / zijn gereserveerd in URL's: + wordt geïnterpreteerd als een spatie in querystrings (application/x-www-form-urlencoded) en / is een padscheidingsteken. Het gebruik van standaard Base64 in een URL vereist daarom procentcodering van deze tekens (%2B, %2F), wat de stringlengte vergroot en de leesbaarheid vermindert. Base64url elimineert dit probleem volledig door van meet af aan URL-veilige tekens te gebruiken.

De meest prominente toepassing van Base64url is in JSON Web Tokens (JWT). Alle drie segmenten van een JWT — header, payload en handtekening — zijn Base64url-gecodeerd. OAuth 2.0 PKCE code_verifier-waarden, WebAuthn-uitdagingswaarden en veel API-tokenschema's maken ook gebruik van Base64url. Het begrijpen van deze codering is essentieel voor elke ontwikkelaar die werkt met authenticatie, autorisatie of cryptografische gegevensuitwisseling.

Waarom Deze Base64url-tool Gebruiken?

Converteer tussen Base64url en tekst of binaire gegevens rechtstreeks in uw browser. Zowel codering als decodering worden ondersteund, met automatische verwerking van opvulling en tekenvervanging. Of u nu een JWT-token debugt, een PKCE-codechallenge genereert of URL-veilige identifiers bouwt, deze tool verwerkt alles lokaal in uw browser met nul latentie en zonder serverroundtrips.

Base64url-gebruiksscenario's

Standaard Base64 vs Base64url

Base64url verschilt op precies drie manieren van standaard Base64. Het coderingsalgoritme is identiek — alleen het alfabet en het opvulgedrag veranderen:

Deze drie verschillen betekenen dat conversie tussen standaard Base64 en Base64url eenvoudig is: vervang + door -, / door _, en verwijder afsluitende =-tekens. Omgekeerd: vervang - door +, _ door /, en voeg opvulling toe zodat de lengte een veelvoud van 4 is. De meeste talen bieden native Base64url-ondersteuning, waardoor handmatige conversie overbodig is. Beide conversies zijn volledig omkeerbaar en verliesvrij, waarbij de originele bytereeks exact behouden blijft. Deze interoperabiliteit is gegarandeerd door RFC 4648.

Coderingsvergelijkingstabel

De onderstaande tabel toont dezelfde invoer gecodeerd met standaard Base64 en Base64url. Let op hoe opvultekens (=) worden weggelaten en + / / worden vervangen door - / _ in de URL-veilige variant:

Codevoorbeelden

Hoe Base64url-strings te coderen en decoderen in populaire talen. Elk voorbeeld produceert uitvoer die veilig is voor gebruik in URL's, bestandsnamen en HTTP-headers:

// 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!"
}

Veelgestelde Vragen