Base64URL デコード、パディング修復まで。

標準 Base64 は URL やファイル名の中で意味を持つ + と / を使い、クエリ文字列では パーセントエンコードが必要な = でパディングします。RFC 4648 第 5 節で定義された Base64URL は、 これらの文字だけを入れ替え、値を URL の中でそのまま運べるようにしています：

残りの 62 文字は同じなので、変換は文字の入れ替えとパディングの追加だけです。

厳密なデコーダーの多くは、パディングのない入力を受け付けません。パディングを戻す規則は、文字列の長さを 4 で割った余りだけで決まります：

• 余り 0：パディングは不要
• 余り 2：== を追加
• 余り 3：= を追加
• 余り 1：正しい Base64 ではあり得ない。値が途中で切れている

このデコーダーはこの規則を自動で適用し、途中で切れた値は黙って誤った結果を返さずにエラーとして知らせます。

• JSON Web Token：ヘッダー、ペイロード、署名はドットでつながれた 3 つの base64url セグメントです。署名は表示しますが、鍵が必要なため検証はしません。
• WebAuthn とパスキー：チャレンジ、クレデンシャル ID、クライアントデータ。
• OAuth PKCE：code_challenge は SHA-256 ダイジェストの base64url です。
• Gmail API：メッセージ本文と添付ファイルは base64url でエンコードされています。
• 短い ID やトークン：URL、Cookie、ファイル名の中で使われます。

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

標準 Base64 やほかの言語については、メインの Base64 デコードページをご覧ください。