Конвертер Base64URL в Base64: восстановление дополнения

Как конвертировать Base64URL в Base64

1. Вставьте Base64URL в поле Ввод · Base64URL. Дополнение не обязательно, стандартные + и / во входных данных тоже не помешают.
2. Стандартный Base64 появится в поле Результат · Base64: - и _ заменены на + и /, дополнение восстановлено.
3. Под результатом Дополнение (=) по умолчанию включено; Перенос строк разбивает результат по 64 символа для PEM или по 76 для MIME.
4. Нажмите Скопировать результат. Переключатель Base64 → Base64URL или страница Base64 в Base64URL работают в обратную сторону.

Сколько дополнения добавить

Base64 работает группами по 4 символа. Base64URL обычно отбрасывает знаки =, которые заполняют последнюю группу, так что по длине видно, сколько их вернуть:

Полезная нагрузка из известного примера eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ занимает 70 символов, остаток 2, значит, к ней добавляется ==. Полное объяснение в статье о дополнении.

Зачем может понадобиться стандартный Base64

Многие декодеры принимают только стандартный алфавит, и на Base64URL они ломаются по-разному:

• GNU coreutils base64 -d выводит то, что успел декодировать до первого - или _, а затем base64: invalid input.
• Java Base64.getDecoder() выбрасывает IllegalArgumentException; для URL-safe входа есть Base64.getUrlDecoder().
• .NET Convert.FromBase64String выбрасывает FormatException на -, _ или отсутствующем =.
• Python base64.b64decode опаснее всех: по умолчанию он молча выбрасывает символы вне стандартного алфавита. b64decode("PDw_Pz8-Pg==") возвращает b'<<\x0f\xcf\xc3\xe0' вместо b'<<???>>'.

Последний случай стоит покрыть тестом в любом коде, который работает с токенами. Неверные байты без исключения обычно всплывают гораздо позже: не проходит проверка подписи или портятся данные.

Base64URL в Base64 в коде

import base64

def b64url_to_bytes(s: str) -> bytes:
    return base64.urlsafe_b64decode(s + "=" * (-len(s) % 4))

b64url_to_bytes("PDw_Pz8-Pg")                              # b'<<???>>'
base64.b64encode(b64url_to_bytes("PDw_Pz8-Pg")).decode()   # 'PDw/Pz8+Pg=='

-len(s) % 4 даёт число недостающих знаков =: 0, 1 или 2 для корректного входа. urlsafe_b64decode требует дополнения, поэтому его добавляют перед вызовом.

function b64urlToB64(s) {
  const b = s.replace(/-/g, "+").replace(/_/g, "/");
  return b + "=".repeat((4 - (b.length % 4)) % 4);
}
b64urlToB64("PDw_Pz8-Pg");   // 'PDw/Pz8+Pg=='

В Node.js Buffer.from(s, "base64url").toString("base64") делает то же за один вызов. URL-safe декодеры из стандартных библиотек описаны на страницах Python, Java и C#.

Частые проблемы

• «последняя группа символов неполная». Длина даёт остаток 1. Часть строки потерялась, часто на переносе строки или из-за обрезанного URL.
• Символ . во входных данных. JWT соединяет точками три части в Base64URL. Конвертируйте по одной части или вставьте токен целиком в декодер JWT.
• %3D в строке. Значение поверх Base64URL ещё и percent-кодировали. Сначала декодируйте его через URL-декодер.

Вопросы и ответы