Decodificar Base64URL, con relleno incluido.

Base64 estándar usa + y /, que significan algo en las URL y los nombres de archivo, y rellena con =, que hay que codificar con porcentajes en una cadena de consulta. Base64URL, definido en la sección 5 de la RFC 4648, cambia solo esos caracteres para que el valor pueda viajar en una URL sin alterarse:

Los otros 62 caracteres son idénticos, así que la conversión es un simple intercambio de caracteres más el relleno.

Muchos decodificadores estrictos rechazan la entrada sin relleno. La regla para volver a añadirlo depende solo de la longitud de la cadena módulo 4:

• resto 0: no hace falta relleno;
• resto 2: añade ==;
• resto 3: añade =;
• resto 1: imposible en Base64 válido; el valor está truncado.

Este decodificador aplica la regla por ti e informa de un valor truncado en lugar de devolver basura en silencio.

• JSON Web Tokens: la cabecera, la carga útil y la firma son tres segmentos base64url unidos por puntos. La firma se muestra pero no se verifica, porque para eso hace falta la clave.
• WebAuthn y passkeys: desafíos, identificadores de credencial y datos del cliente.
• OAuth PKCE: el code_challenge es un resumen SHA-256 en base64url.
• API de Gmail: los cuerpos de los mensajes y los adjuntos van codificados en base64url.
• Identificadores cortos y tokens en URL, cookies y nombres de archivo.

# 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);

Para Base64 estándar y más lenguajes, consulta la página principal para decodificar Base64.