Encodeur Base64URL : Base64 URL-safe en ligne

Comment encoder en Base64URL

1. Saisissez ou collez le texte dans Entrée · texte.
2. Copiez le Base64URL depuis Sortie · Base64. URL-safe (- _) et Sans remplissage (=) sont déjà cochés sur cette page.
3. Si le destinataire veut le remplissage, décochez Sans remplissage (=). S’il veut du Base64 standard, décochez aussi URL-safe, ou utilisez l’encodeur Base64.
4. Copiez la sortie ou téléchargez-la sous base64.txt.

Décodez une valeur avec le décodeur Base64URL. Base64 en Base64URL convertit des chaînes existantes d’un alphabet à l’autre.

Ce qui change par rapport au Base64 standard

Seuls trois caractères diffèrent. Tout le reste, y compris la règle 3 octets pour 4 caractères, reste identique :

Pour beaucoup de chaînes courtes, les deux variantes ne diffèrent que par le remplissage. La différence d’alphabet apparaît dès qu’un groupe de 6 bits vaut 62 ou 63, ce que produisent des caractères comme ? et > et beaucoup d’octets non ASCII :

Base64 ou Base64URL revient plus en détail sur l’historique et les différences de décodage.

Pourquoi les URL ont besoin de leur propre alphabet

Chacun des trois caractères standard a un sens dans une URL. / sépare les segments du chemin, = sépare noms et valeurs dans une query string, et + est lu comme une espace par les décodeurs de formulaires. Une valeur Base64 standard comme a+b/c== dans un paramètre de requête arrive sous la forme a b/c== si chaque caractère n’a pas été échappé. L’encodage pourcent règle le problème, mais transforme chacun d’eux en trois caractères (%2B, %2F, %3D).

Le Base64URL choisit deux caractères non réservés dans les URL et supprime le remplissage : une valeur peut ainsi être collée telle quelle dans un chemin, une query string, un fragment, un cookie ou un nom de fichier. - et _ sont aussi sans risque dans les noms de fichiers sur tous les systèmes de fichiers courants, contrairement à /.

Où le Base64URL est utilisé

• JWT et JOSE. Chaque partie d’un JSON Web Token est en Base64URL sans remplissage, comme le définit la RFC 7515. Le décodeur JWT lit les jetons ; Base64 dans les JWT explique la structure.
• OAuth PKCE. Le code_challenge est le Base64URL du hachage SHA-256 du code_verifier.
• WebAuthn et passkeys. Les identifiants de credentials et les challenges circulent en Base64URL dans du JSON.
• Liens et identifiants. Les liens de partage, les paramètres d’URL signés et les identifiants courts construits à partir d’octets aléatoires l’utilisent pour garder des URL propres.

Le Base64URL dans le code

Node.js dispose d’un encodage base64url intégré, et Python d’une fonction URL-safe dont vous retirez vous-même le remplissage :

// Node.js
Buffer.from("subjects?_d").toString("base64url");   // "c3ViamVjdHM_X2Q"

// Browsers with Uint8Array.prototype.toBase64
new TextEncoder().encode("subjects?_d").toBase64({ alphabet: "base64url", omitPadding: true });

import base64, hashlib

base64.urlsafe_b64encode(b"subjects?_d").rstrip(b"=").decode()   # 'c3ViamVjdHM_X2Q'

# PKCE code_challenge, example from RFC 7636 appendix B
verifier = "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk"
digest = hashlib.sha256(verifier.encode("ascii")).digest()
base64.urlsafe_b64encode(digest).rstrip(b"=").decode()
# 'E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM'

Plus de détails dans Base64 en Node.js, JavaScript et Python, et sur l’API du navigateur dans Uint8Array.toBase64.

FAQ