Decodifica Base64URL, padding compreso.

Il Base64 standard usa + e /, che hanno un significato negli URL e nei nomi di file, e completa con =, che in una query string va codificato con la percentuale. Il Base64URL, definito nella sezione 5 della RFC 4648, sostituisce solo questi caratteri perché il valore possa viaggiare in un URL senza alterazioni:

Gli altri 62 caratteri sono identici, quindi la conversione è un semplice scambio di caratteri più il padding.

Molti decoder rigorosi rifiutano un input senza padding. La regola per rimetterlo dipende solo dalla lunghezza della stringa modulo 4:

• resto 0: nessun padding necessario;
• resto 2: aggiungi ==;
• resto 3: aggiungi =;
• resto 1: impossibile in un Base64 valido, il valore è troncato.

Questo decoder applica la regola al posto tuo e segnala un valore troncato invece di restituire in silenzio dati senza senso.

• JSON Web Token: header, payload e firma sono tre segmenti base64url uniti da punti. La firma viene mostrata ma non verificata, perché servirebbe la chiave.
• WebAuthn e passkey: challenge, ID delle credenziali e dati del client.
• OAuth PKCE: il code_challenge è un digest SHA-256 in base64url.
• API di Gmail: corpi dei messaggi e allegati sono codificati in base64url.
• ID brevi e token in URL, cookie e nomi di file.

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

Per il Base64 standard e altri linguaggi, consulta la pagina principale Decodifica Base64.