Décoder du Base64URL, remplissage compris.

Le Base64 standard utilise + et /, qui ont un sens dans les URL et les noms de fichiers, et complète avec =, qu’il faut encoder en pourcentage dans une chaîne de requête. Le Base64URL, défini à la section 5 de la RFC 4648, remplace uniquement ces caractères pour que la valeur circule dans une URL sans altération :

Les 62 autres caractères sont identiques : la conversion se résume à un échange de caractères plus le remplissage.

Beaucoup de décodeurs stricts refusent une entrée sans remplissage. La règle pour le rétablir ne dépend que de la longueur de la chaîne modulo 4 :

• reste 0 : aucun remplissage nécessaire ;
• reste 2 : ajoutez == ;
• reste 3 : ajoutez = ;
• reste 1 : impossible en Base64 valide, la valeur est tronquée.

Ce décodeur applique la règle pour vous et signale une valeur tronquée au lieu de renvoyer discrètement n’importe quoi.

• JSON Web Tokens — l’en-tête, la charge utile et la signature sont trois segments base64url reliés par des points. La signature est affichée mais pas vérifiée, car il faudrait la clé.
• WebAuthn et passkeys — défis, identifiants de justificatifs et données client.
• OAuth PKCE — le code_challenge est une empreinte SHA-256 en base64url.
• API Gmail — le corps des messages et les pièces jointes sont encodés en base64url.
• Identifiants courts et jetons dans les URL, les cookies et les noms de fichiers.

# Python: urlsafe_b64decode still needs the padding back
import base64
def b64url_decode(s: str) -> bytes:
    return base64.urlsafe_b64decode(s + "=" * (-len(s) % 4))

// Node.js 16+
Buffer.from(token, "base64url").toString("utf8");

// Go
base64.RawURLEncoding.DecodeString(s)

// Java 8+: the URL decoder accepts unpadded input
Base64.getUrlDecoder().decode(s);

Pour le Base64 standard et d’autres langages, consultez la page principale pour décoder du Base64.