URL-güvenli Base64

Base64url Kodlama Nedir?

Base64url, URL'lerde, dosya adlarında ve standart Base64 karakterlerinden + ile /'nin sorun çıkardığı diğer bağlamlarda kullanılmak üzere özel olarak tasarlanmış bir Base64 kodlama varyantıdır. RFC 4648 Bölüm 5'te tanımlanan Base64url, +'yı - (kısa çizgi) ve /'yi _ (alt çizgi) ile değiştirir; sondaki = dolgu karakterlerini ise çıkarır. Sonuç olarak elde edilen dize, ek yüzde-kodlama gerekmeksizin doğrudan bir URL sorgu parametresine, dosya adına veya HTTP başlığına gömülebilir.

Standart Base64 (RFC 4648 Bölüm 4), 64 karakter kullanır: A–Z, a–z, 0–9, + ve /. + ve / karakterleri URL'lerde özel anlam taşır: + karakter, sorgu dizelerinde (application/x-www-form-urlencoded) boşluk olarak yorumlanır; / ise yol sınırlayıcısıdır. Standart Base64'ü bir URL içinde kullanmak bu nedenle bu karakterlerin yüzde-kodlanmasını (%2B, %2F) gerektirir; bu da dizeyi uzatır ve okunmasını güçleştirir. Base64url, başından itibaren URL-güvenli karakterler kullanarak bu sorunu tamamen ortadan kaldırır.

Base64url'nin en belirgin kullanım alanı JSON Web Token'larıdır (JWT). Bir JWT'nin üç bölümünün tamamı — başlık, yük ve imza — Base64url ile kodlanmıştır. OAuth 2.0 PKCE kod doğrulayıcıları, WebAuthn sınama değerleri ve pek çok API token şeması da Base64url'ye dayanır. Kimlik doğrulama, yetkilendirme veya şifreli veri alışverişiyle çalışan her geliştirici için bu kodlamayı anlamak vazgeçilmezdir.

Bu Base64url Aracını Neden Kullanmalısınız?

Tarayıcınızda doğrudan Base64url ile metin veya ikili veri arasında dönüşüm yapın. Dolgu ve karakter değişimi otomatik olarak yönetilirken hem kodlama hem de kod çözme desteklenmektedir. Bir JWT token'ını hata ayıklıyor, PKCE kod doğrulaması oluşturuyor veya parola sıfırlama bağlantıları için URL-güvenli tanımlayıcılar üretiyor olun, bu araç her şeyi tarayıcınızda yerel olarak sıfır gecikmeyle ve sunucuya gidiş-dönüş gerektirmeksizin işler. Buraya yapıştırdığınız hiçbir veri cihazınızın dışına iletilmez.

Base64url Kullanım Alanları

Standart Base64 ile Base64url Karşılaştırması

Base64url, standart Base64'ten tam olarak üç noktada farklılaşır. Kodlama algoritması aynıdır — yalnızca alfabe ve dolgu davranışı değişir:

Bu üç fark, standart Base64 ile Base64url arasında dönüşümün son derece basit olduğu anlamına gelir: + karakterini - ile, / karakterini _ ile değiştirin ve sondaki = karakterlerini kaldırın. Tersi için - yerine +, _ yerine / koyun ve uzunluğun 4'ün katı olması için dolgu ekleyin. Çoğu dil yerel Base64url desteği sunduğundan manuel dönüşüm gereksizdir. Her iki dönüşüm de tamamen geri alınabilir ve kayıpsızdır; orijinal bayt dizisini eksiksiz korur. Bu birlikte çalışabilirlik, her iki kodlama varyantını da tanımlayan RFC 4648 spesifikasyonu tarafından güvence altına alınmıştır. Uygulamada modern programlama dillerinin büyük çoğunluğu yerel Base64url desteği sunmakta olup manuel dönüşümü gereksiz kılmaktadır.

Kodlama Karşılaştırma Tablosu

Aşağıdaki tablo, aynı girişlerin standart Base64 ve Base64url ile kodlanmış hallerini göstermektedir. URL-güvenli varyantda dolgu karakterlerinin (=) nasıl kaldırıldığına ve + / /'nin - / _ ile nasıl değiştirildiğine dikkat edin:

Kod Örnekleri

Popüler dillerde Base64url dizelerini kodlamak ve çözmek için kullanılan yöntemler. Her örnek, URL'lerde, dosya adlarında ve HTTP başlıklarında güvenle kullanılabilecek çıktı üretir:

// 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!"
}

Sıkça Sorulan Sorular