Base64 URL-safe

Apa Itu Enkoding Base64url?

Base64url adalah varian dari enkoding Base64 yang dirancang khusus untuk digunakan dalam URL, nama file, dan konteks lain di mana karakter Base64 standar + dan / menimbulkan masalah. Didefinisikan dalam RFC 4648 Bagian 5, Base64url mengganti + dengan - (tanda hubung) dan / dengan _ (garis bawah), serta menghilangkan karakter padding = di akhir. Hasilnya adalah string yang dapat disematkan langsung dalam parameter kueri URL, nama file, atau header HTTP tanpa memerlukan percent-encoding tambahan.

Base64 standar (RFC 4648 Bagian 4) menggunakan 64 karakter: A-Z, a-z, 0-9, +, dan /. Karakter + dan / digunakan secara khusus dalam URL: + ditafsirkan sebagai spasi dalam query string (application/x-www-form-urlencoded), dan / adalah pemisah jalur. Menggunakan Base64 standar di dalam URL karena itu memerlukan percent-encoding karakter tersebut (%2B, %2F), yang menambah panjang string dan membuatnya lebih sulit dibaca. Base64url menghilangkan masalah ini sepenuhnya dengan menggunakan karakter yang aman untuk URL sejak awal.

Penggunaan Base64url yang paling menonjol adalah dalam JSON Web Tokens (JWT). Ketiga segmen JWT — header, payload, dan tanda tangan — semuanya dienkode dengan Base64url. Code verifier OAuth 2.0 PKCE, nilai challenge WebAuthn, dan banyak skema token API juga bergantung pada Base64url. Memahami enkoding ini sangat penting bagi setiap pengembang yang bekerja dengan autentikasi, otorisasi, atau pertukaran data kriptografis.

Mengapa Menggunakan Alat Base64url Ini?

Konversi antara Base64url dan teks atau data biner langsung di browser Anda. Enkoding maupun dekoding didukung, dengan penanganan otomatis untuk padding dan penggantian karakter. Baik saat Anda men-debug token JWT, membuat code challenge PKCE, maupun membangun pengidentifikasi yang aman untuk URL, alat ini memproses semuanya secara lokal di browser Anda dengan latensi nol dan tanpa perlu bolak-balik ke server.

Kasus Penggunaan Base64url

Base64 Standar vs Base64url

Base64url berbeda dari Base64 standar dalam tepat tiga hal. Algoritma enkoding identik — hanya alfabet dan perilaku padding yang berubah:

Ketiga perbedaan ini berarti konversi antara Base64 standar dan Base64url sangat mudah: ganti + dengan -, / dengan _, dan hapus karakter = di akhir. Sebaliknya, ganti - dengan +, _ dengan /, dan tambahkan kembali padding agar panjangnya merupakan kelipatan 4. Sebagian besar bahasa pemrograman menyediakan dukungan Base64url secara native, sehingga konversi manual tidak diperlukan. Kedua konversi ini sepenuhnya dapat dibalik dan tanpa kehilangan data, sehingga urutan byte asli dipertahankan secara tepat.

Tabel Perbandingan Enkoding

Tabel di bawah menunjukkan input yang sama dienkode dengan Base64 standar dan Base64url. Perhatikan bagaimana karakter padding (=) dihilangkan dan + / / diganti dengan - / _ dalam varian aman URL:

Contoh Kode

Cara mengenkode dan mendekode string Base64url dalam bahasa pemrograman populer. Setiap contoh menghasilkan output yang aman digunakan dalam URL, nama file, dan header HTTP:

// Encode to Base64url
function toBase64url(str) {
  return btoa(unescape(encodeURIComponent(str)))
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/, '')
}
toBase64url('Hello!') // → "SGVsbG8h"

// Decode from Base64url
function fromBase64url(b64url) {
  const b64 = b64url.replace(/-/g, '+').replace(/_/g, '/')
  const pad = (4 - b64.length % 4) % 4
  return decodeURIComponent(escape(atob(b64 + '='.repeat(pad))))
}
fromBase64url('SGVsbG8h') // → "Hello!"

// Native base64url support since Node 15.7
const encoded = Buffer.from('Hello!').toString('base64url')
// → "SGVsbG8h"

const decoded = Buffer.from('SGVsbG8h', 'base64url').toString()
// → "Hello!"

// Decode a JWT payload
const jwt = 'eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0...'
const payload = JSON.parse(Buffer.from(jwt.split('.')[1], 'base64url').toString())
// → { sub: "1234567890" }

import base64

# Encode to Base64url (no padding)
encoded = base64.urlsafe_b64encode(b'Hello!').rstrip(b'=').decode()
# → "SGVsbG8h"

# Decode from Base64url (re-add padding)
def b64url_decode(s: str) -> bytes:
    s += '=' * (4 - len(s) % 4)  # restore padding
    return base64.urlsafe_b64decode(s)

b64url_decode('SGVsbG8h')  # → b'Hello!'

package main

import (
    "encoding/base64"
    "fmt"
)

func main() {
    // Encode to Base64url (no padding)
    encoded := base64.RawURLEncoding.EncodeToString([]byte("Hello!"))
    fmt.Println(encoded) // → "SGVsbG8h"

    // Decode from Base64url
    decoded, _ := base64.RawURLEncoding.DecodeString("SGVsbG8h")
    fmt.Println(string(decoded)) // → "Hello!"
}

Pertanyaan yang Sering Diajukan