Modern web uygulamalarında güvenliğin sağlanması, kullanıcı kimlik doğrulama ve veri bütünlüğünün korunması temel bir gerekliliktir. Bu karmaşık alanda, JWT (JSON Web Token), JWS (JSON Web Signature) ve JWE (JSON Web Encryption) gibi standartlar kritik rol oynar. Peki, bu terimler ne anlama geliyor ve hangi senaryoda hangisini tercih etmeliyiz? Bu makale, her birinin temel prensiplerini, kullanım amaçlarını ve aralarındaki farkları, gerçek dünya örnekleriyle açıklayarak bu konudaki kafa karışıklığını gidermeyi hedeflemektedir. İster yeni başlayan bir geliştirici olun, ister deneyimli bir mimar, bu kapsamlı rehber, güvenli ve ölçeklenebilir uygulamalar geliştirmenize yardımcı olacak değerli bilgiler sunacaktır.
Günümüz dijital dünyasında, verinin güvenliği ve bütünlüğü, uygulamaların başarısı için hayati öneme sahiptir. Kullanıcılar, kimlik bilgilerinin korunmasını, işlemlerinin gizli kalmasını ve verilerinin yetkisiz kişilerce değiştirilmemesini beklerler. Bu beklentiler, geliştiricileri, güçlü güvenlik mekanizmaları uygulamaya iter. Özellikle API tabanlı mimarilerde ve mikroservis ortamlarında, farklı sistemler arasında güvenli bir şekilde bilgi alışverişi yapmak zorunlu hale gelmiştir. Geleneksel oturum yönetimleri (örneğin sunucu tarafında tutulan session’lar) ölçeklenebilirlik sorunları yaratabilirken, bu boşluğu dolduracak yeni nesil çözümlere ihtiyaç duyulmuştur.
İşte tam bu noktada, JSON tabanlı token’lar devreye girer. Bu token’lar, iki taraf arasında güvenli bir şekilde bilgi aktarımı yapmanın standart bir yolunu sunar. Peki, bu “güvenli bilgi aktarımı” ne anlama gelir? Temel olarak üç ana sütun üzerine inşa edilmiştir: Kimlik Doğrulama (Authentication), Yetkilendirme (Authorization) ve Veri Bütünlüğü (Data Integrity). Kimlik doğrulama, kullanıcının iddia ettiği kişi olduğunu kanıtlama sürecidir. Yetkilendirme ise, kimliği doğrulanmış kullanıcının hangi kaynaklara erişebileceğini belirler. Veri bütünlüğü ise, iletilen verinin kaynaktan çıktığı gibi, yolculuk sırasında değiştirilmeden alıcıya ulaştığını garanti etmektir. Bunun yanı sıra, bazı durumlarda Gizlilik (Confidentiality) de kritik bir ihtiyaçtır; yani, iletilen bilginin sadece yetkili taraflarca okunabilmesini sağlamak. Bu makalede ele alacağımız JWT, JWS ve JWE, bu ihtiyaçlara farklı seviyelerde ve farklı mekanizmalarla cevap veren güçlü araçlardır. Bu araçlar sayesinde, sunucu tarafında ağır oturum verileri tutmak yerine, istemcinin taşıdığı küçük ve doğrulanabilir token’lar ile daha hafif, daha ölçeklenebilir ve daha modern mimariler inşa edebiliriz.
Örneğin, bir mobil uygulamanın arka uç API’sine istek gönderdiğini düşünelim. Bu istekte kullanıcının kimliğini ve yetkilerini içeren bir bilgi parçasının güvenli bir şekilde taşınması gerekir. Eğer bu bilgi kolayca değiştirilebilir veya başkaları tarafından okunabilir olursa, uygulamanın ve kullanıcı verilerinin güvenliği tehlikeye girer. Bu nedenle, bu tür senaryolarda verinin hem bütünlüğünü hem de gizliliğini sağlayacak mekanizmalara şiddetle ihtiyaç duyarız. JWT, JWS ve JWE, bu zorlukları ele almak için tasarlanmış, iyi tanımlanmış standartlardır. Her birinin kendine özgü bir odak noktası ve uygulama alanı bulunsa da, çoğu zaman birbiriyle birlikte kullanılarak kapsamlı bir güvenlik çözümü sunarlar. Bu bölümde, bu temel güvenlik gereksinimlerinin önemini vurguladık. Bir sonraki bölümde, bu gereksinimleri karşılamanın omurgasını oluşturan JSON Web Token (JWT) kavramına daha yakından bakacağız.
JWT Nedir ve Modern Web Mimarisinde Neden Önemlidir?
JSON Web Token (JWT), kompakt, URL-güvenli ve web uygulamaları arasında güvenli bir şekilde bilgi iletimini sağlayan, açık bir endüstri standardıdır (RFC 7519). Temelde bir kimlik doğrulama veya yetkilendirme mekanizması olarak kullanılır ve sunucusuz (stateless) mimarilerin vazgeçilmez bir parçası haline gelmiştir. Geleneksel oturum (session) tabanlı kimlik doğrulama yöntemlerinde, sunucunun her kullanıcı için bir oturum kaydı tutması ve bu kaydı doğrulaması gerekir. Bu durum, özellikle yüksek yük altında çalışan veya çoklu sunucu ortamlarında ölçeklenebilirlik sorunlarına yol açabilir.
JWT bu sorunu, kimlik doğrulama bilgilerini istemcinin kendi üzerinde taşımasına olanak tanıyarak çözer. Bir kullanıcı sisteme giriş yaptığında, sunucu bir JWT oluşturur ve bu token’ı kullanıcıya geri gönderir. Kullanıcı, bu token’ı sonraki tüm isteklerinde (genellikle “Authorization” başlığında “Bearer” şeması ile) sunucuya geri gönderir. Sunucu, her istekte token’ın geçerliliğini doğrulayarak kullanıcının kimliğini ve yetkilerini hızlıca kontrol edebilir. Bu sayede, sunucunun her istek için bir veritabanı sorgusu yapmasına veya bir oturum kaydını aramasına gerek kalmaz, bu da performansı artırır ve sunucuların durum tutma yükünü azaltır.
Bir JWT, üç ana bölümden oluşur ve her bölüm Base64URL ile kodlanmıştır:
- Header (Başlık): Token türünü (genellikle “JWT”) ve imzalama algoritmasını (örneğin, HS256 veya RS256) içerir.
{ "alg": "HS256", "typ": "JWT" } - Payload (Yük): Kimlik bilgileri, yetkilendirme rolleri, token'ın son kullanma süresi (exp), yayınlayıcı (iss) ve hedef kitle (aud) gibi "claim"leri içerir. Claim'ler, token hakkında veya varlık hakkında ifadelerdir. Üç tür claim vardır: kayıtlı (registered), genel (public) ve özel (private).
{ "sub": "1234567890", "name": "John Doe", "admin": true, "iat": 1516239022, "exp": 1516242622 } - Signature (İmza): Header ve Payload'ın kodlanmış halleri ile gizli bir anahtar kullanılarak oluşturulur. Bu imza, token'ın yolculuk sırasında değiştirilmediğini (veri bütünlüğü) ve gerçekten beklenen kaynaktan geldiğini (kimlik doğrulama) garanti eder. Eğer token değiştirilirse, imza geçersiz hale gelir.
Bu üç bölüm, birer nokta (.) ile ayrılır ve "xxxxx.yyyyy.zzzzz" şeklinde bir JWT oluşturur. JWT'nin bu yapısı, onu hem kompakt hem de taşınabilir kılar. Özellikle mobil uygulamalar, tek sayfa uygulamaları (SPA) ve mikroservis mimarileri için ideal bir çözümdür.
Vaka Analizi: API Kimlik Doğrulama ve Yetkilendirme
Bir e-ticaret uygulamasında, kullanıcıların alışveriş sepetlerine ürün ekleyebilmesi, sipariş verebilmesi veya profil bilgilerini güncelleyebilmesi için bir API ile etkileşime girmeleri gerekir. Bu API'nin, her isteği yapan kullanıcının kim olduğunu ve bu işlemi yapmaya yetkili olup olmadığını bilmesi şarttır. İşte JWT'nin devreye girdiği yer burasıdır:
- Kullanıcı uygulamaya kullanıcı adı ve şifresiyle giriş yapar.
- Uygulama, bu bilgileri arka uç kimlik doğrulama servisine gönderir.
- Kimlik doğrulama servisi, kullanıcının bilgilerini doğrular ve başarılı olursa, kullanıcının ID'si, rolleri (örneğin, "müşteri", "yönetici") ve token'ın geçerlilik süresi gibi bilgileri içeren bir JWT oluşturur.
- Bu JWT, uygulamanın istemcisine geri gönderilir.
- İstemci, sonraki tüm API isteklerinde bu JWT'yi "Authorization: Bearer " başlığı altında gönderir.
- API, her gelen istekte token'ı ayrıştırır, imzasını doğrular ve token içindeki yetki bilgilerine göre isteği işler veya reddeder. Eğer token'ın süresi dolmuşsa veya imzası geçersizse, istek reddedilir.
Bu model sayesinde, API'nin her istek için ayrı bir veritabanı sorgusu yapmasına gerek kalmaz, çünkü gerekli tüm yetkilendirme bilgileri token içinde güvenli bir şekilde taşınır. Bu, sistemin genel performansını ve ölçeklenebilirliğini önemli ölçüde artırır. Ancak unutulmamalıdır ki, JWT'ler varsayılan olarak veriyi şifrelemez, sadece imzalayarak bütünlüğünü garanti eder. Bu nedenle, hassas bilgilerin doğrudan Payload içinde taşınmaması veya şifrelenmesi gereklidir. Bir sonraki bölümde, JWT'nin temelini oluşturan JWS'e odaklanarak, verilerin nasıl imzalandığını ve bütünlüğünün nasıl sağlandığını daha detaylı inceleyeceğiz.
JWS: Veri Bütünlüğünü Nasıl Sağlarız?
JSON Web Signature (JWS), bir JSON nesnesinin veya herhangi bir rastgele ikili verinin bütünlüğünü ve orijinalliğini sağlamak için kullanılan bir yöntemdir. RFC 7515 tarafından tanımlanmıştır ve JWT'nin bir parçası olarak veya tek başına kullanılabilir. JWS'in temel amacı, iletilen verinin, gönderildiği andan itibaren alıcıya ulaşana kadar değiştirilmediğini garanti etmektir. Bunu, veriyi kriptografik olarak imzalayarak başarır. İmzalama işlemi, göndericinin veriye dijital bir mühür vurması gibidir; alıcı bu mührü kontrol ederek verinin yetkisiz kişilerce kurcalanmadığından emin olabilir.
Bir JWS nesnesi, JWT'ye çok benzer bir yapıya sahiptir ve üç ana bölümden oluşur:
- JWS Header (Başlık): Tipik olarak imzalama algoritmasını (
alg) ve içerik türünü (typ) belirtir. Ayrıca, anahtar ID'si (kid) gibi ek parametreler de içerebilir.{ "alg": "HS256", "typ": "JWT" // veya "JWS" } - JWS Payload (Yük): İmzalanacak olan gerçek veridir. Bu, bir JWT'nin payload'ı olabileceği gibi, herhangi bir JSON nesnesi, string veya ikili veri de olabilir. JWS'in temel farkı, JWT'de payload'ın genellikle yapılandırılmış claim'ler içermesi, JWS'de ise herhangi bir veri olabilmesidir.
- JWS Signature (İmza): Header'ın ve Payload'ın Base64URL kodlanmış halleri ile önceden belirlenmiş bir kriptografik anahtar (gizli anahtar veya özel anahtar) kullanılarak oluşturulan dijital imzadır. İmzalama algoritması (örneğin, HMAC SHA-256, RSA SHA-256) Header'da belirtilir.
Bu üç bölüm, tıpkı JWT'de olduğu gibi noktalarla ayrılır: BASE64URL(JWS Header) . BASE64URL(JWS Payload) . BASE64URL(JWS Signature). Alıcı tarafında, JWS doğrulama için aynı algoritmayı ve anahtarı kullanarak imzayı yeniden oluşturur ve gönderilen imza ile karşılaştırır. Eğer iki imza eşleşirse, verinin bütünlüğü sağlanmış demektir.
Ne Zaman JWS Kullanmalıyız?
JWS, verinin gizliliğinden çok, bütünlüğünün önemli olduğu senaryolarda idealdir. Örneğin:
- API İsteklerinde Bütünlük Sağlama: Bir istemcinin sunucuya gönderdiği bir sipariş isteğinin yolculuk sırasında değiştirilmediğinden emin olmak isteyebilirsiniz. JWS kullanarak, isteğin içeriğini imzalayabilir ve sunucunun bu imzayı doğrulamasını sağlayabilirsiniz.
- Tek Oturum Açma (SSO) Sistemleri: Farklı uygulamalar arasında kullanıcı kimlik bilgilerini güvenli bir şekilde iletmek için JWS kullanılabilir. Kullanıcının kimlik bilgileri açık olsa bile (şifrelenmemiş), bu bilgilerin kimlik sağlayıcı tarafından yayınlandığı ve değiştirilmediği garanti edilir.
- Yapılandırma Dosyaları veya Güncellemeler: Yazılım güncellemelerinin veya kritik yapılandırma dosyalarının güvenilir bir kaynaktan geldiğini ve değiştirilmediğini doğrulamak için JWS kullanılabilir.
Vaka Analizi: Tek Oturum Açma (SSO) Sistemi
Büyük bir kurumsal yapıda birden fazla uygulama (örneğin, CRM, İnsan Kaynakları, Proje Yönetimi) kullanıldığını ve kullanıcıların her birine ayrı ayrı giriş yapmak istemediklerini düşünün. Bir SSO sistemi, kullanıcının bir kez kimlik doğrulamasını yapar ve ardından kullanıcının diğer tüm uygulamalara erişmesine izin verir. JWS, bu senaryoda kritik bir rol oynar:
- Kullanıcı, SSO portalına giriş yapar.
- SSO portalı, kullanıcının kimliğini doğruladıktan sonra, kullanıcının temel bilgilerini ve yetkilerini içeren bir JWS oluşturur ve bunu kullanıcının tarayıcısına (örneğin, bir çerez içinde veya bir POST isteğiyle) gönderir.
- Kullanıcı, başka bir uygulamaya (örneğin CRM) erişmek istediğinde, tarayıcı bu JWS'i ilgili uygulama sunucusuna iletir.
- CRM uygulaması, aldığı JWS'i kendi anahtarıyla doğrular. İmza geçerliyse, token'daki kullanıcı bilgilerine ve yetkilerine güvenebilir. Bu bilgiler, kullanıcının CRM uygulamasına erişmesine izin verilip verilmeyeceğini veya hangi kaynaklara erişebileceğini belirlemek için kullanılır.
Bu akışta, JWS'in ana faydası, kullanıcının kimlik bilgilerinin üçüncü taraf uygulamalara iletilirken değiştirilmediğinden emin olunmasıdır. Bilgiler şifrelenmese de, sahte bir kullanıcının kendi JWS'ini oluşturup sisteme sızması engellenmiş olur, çünkü sahte JWS'in imzası doğrulanamaz. Böylece, verilerin kaynağına ve bütünlüğüne güven duyulur.
// Basit bir JWS imzalama (pseudocode)
function signJWS(header, payload, secretKey) {
const encodedHeader = Base64URL_encode(JSON.stringify(header));
const encodedPayload = Base64URL_encode(JSON.stringify(payload));
const dataToSign = encodedHeader + '.' + encodedPayload;
const signature = HMAC_SHA256(dataToSign, secretKey);
return encodedHeader + '.' + encodedPayload + '.' + Base64URL_encode(signature);
}
// Basit bir JWS doğrulama (pseudocode)
function verifyJWS(token, secretKey) {
const parts = token.split('.');
const encodedHeader = parts[0];
const encodedPayload = parts[1];
const receivedSignature = parts[2];
const dataToSign = encodedHeader + '.' + encodedPayload;
const expectedSignature = HMAC_SHA256(dataToSign, secretKey);
return Base64URL_encode(expectedSignature) === receivedSignature;
}
Bu bölümde, JWS'in veri bütünlüğünü nasıl sağladığını ve hangi senaryolarda kullanılması gerektiğini inceledik. Gördüğümüz gibi, JWS, bilginin kaynağına güvenmek ve yetkisiz değişiklikleri engellemek için güçlü bir mekanizma sunar. Ancak, eğer iletilen verinin içeriğinin gizli kalması gerekiyorsa, yani üçüncü taraflarca okunmaması gerekiyorsa, JWS tek başına yeterli değildir. İşte bu noktada JWE devreye girer ve verilerin şifrelenerek gizliliğinin nasıl sağlanabileceğini bir sonraki bölümde ele alacağız.
JWE: Gizliliği Nasıl Koruruz?
JSON Web Encryption (JWE), hassas verilerin iki taraf arasında güvenli ve gizli bir şekilde aktarılmasını sağlamak için kullanılan bir standarttır (RFC 7516). JWS'in aksine, JWE'nin ana odak noktası veri bütünlüğü değil, verinin gizliliğidir. Yani, JWE, yetkisiz tarafların şifrelenmiş içeriği okumasını engeller. Bu, veriyi kriptografik olarak şifreleyerek başarılır, böylece yalnızca doğru anahtara sahip olan alıcı tarafı bu veriyi deşifre edebilir ve orijinal haline ulaşabilir.
Bir JWE nesnesi, JWS'ten daha karmaşık bir yapıya sahiptir ve beş ana bölümden oluşur, her bölüm Base64URL ile kodlanmıştır:
- JWE Header (Başlık): Şifreleme işleminin nasıl yapıldığına dair meta verileri içerir. Bu, anahtar yönetim algoritması (
alg) ve içerik şifreleme algoritması (enc) gibi bilgileri kapsar. Ayrıca, token türünü (typ) de belirtebilir.{ "alg": "RSA-OAEP", // Anahtar yönetim algoritması "enc": "A128CBC-HS256", // İçerik şifreleme algoritması "typ": "JWE" } - JWE Encrypted Key (Şifrelenmiş Anahtar): İçeriği şifrelemek için kullanılan simetrik anahtarın (Content Encryption Key - CEK) şifrelenmiş halidir. CEK, alıcının açık anahtarı (public key) kullanılarak şifrelenir ve böylece sadece alıcının özel anahtarı (private key) ile deşifre edilebilir. Eğer anahtar yönetim algoritması (
alg) doğrudan şifreleme anahtarı üretirse (örneğin, A128KW), bu bölüm boş olabilir. - JWE Initialization Vector (IV): Şifreleme algoritmaları için rastgele oluşturulan bir başlangıç vektörüdür. Bu, aynı anahtar ve aynı içerikle bile her şifrelemenin farklı bir sonuç üretmesini sağlar, bu da güvenlik için kritik öneme sahiptir.
- JWE Ciphertext (Şifrelenmiş Metin): Şifrelenecek olan gerçek verinin (JWE Payload) CEK ve IV kullanılarak şifrelenmiş halidir. Bu kısım, okunaksız bir dizi karakterden oluşur.
- JWE Authentication Tag (Doğrulama Etiketi): Şifrelenmiş metnin bütünlüğünü ve orijinalliğini doğrulamak için kullanılır. Bu etiket, şifreleme sırasında oluşturulur ve alıcının şifre çözme işlemi sırasında verinin değiştirilip değiştirilmediğini kontrol etmesini sağlar. Bu, gizliliğin yanı sıra bir miktar bütünlük koruması da sağlar, ancak JWS'in sağladığı imza doğrulama seviyesinde değildir.
Bu beş bölüm de noktalarla ayrılır: BASE64URL(JWE Header) . BASE64URL(JWE Encrypted Key) . BASE64URL(JWE IV) . BASE64URL(JWE Ciphertext) . BASE64URL(JWE Authentication Tag).
Ne Zaman JWE Kullanmalıyız?
JWE, verinin kesinlikle üçüncü taraflarca okunamaması gerektiği senaryolarda kullanılır:
- Hassas Veri Aktarımı: Kredi kartı numaraları, sağlık bilgileri, kişisel kimlik numaraları veya diğer gizli verilerin sistemler arasında güvenli bir şekilde iletilmesi gerektiğinde.
- Gelişmiş API Güvenliği: Bir API'nin belirli bir endpoint'ine gönderilen isteğin gövdesindeki verilerin sadece hedef servis tarafından okunabilmesini sağlamak istediğinizde.
- Çevrimdışı Depolama: Hassas bilgileri çevrimdışı (örneğin, bir mobil cihazda veya web tarayıcısı yerel depolamasında) güvenli bir şekilde saklamak için.
Vaka Analizi: Hassas Veri Aktarımı ve Mikroservis İletişimi
Bir bankacılık uygulamasını düşünelim. Müşterinin kredi başvurusunda girdiği gelir bilgileri, adres detayları ve diğer kişisel finansal veriler gibi çok hassas bilgiler, ön uçtan arka uç servislerine aktarılmalıdır. Bu bilgilerin yolculuk sırasında kötü niyetli kişilerce ele geçirilse bile okunmaması gerekir. İşte JWE'nin bu senaryoda nasıl kullanılabileceği:
- Kullanıcı, web arayüzünde hassas finansal bilgilerini girer ve gönder düğmesine tıklar.
- Ön uç uygulaması (veya bir API Gateway), bu hassas verileri alır ve hedef arka uç servisinin (örneğin, Kredi Değerlendirme Servisi) açık anahtarını kullanarak bir JWE oluşturur. Yani, içerik anahtarı (CEK) şifrelenir ve asıl veri bu CEK ile şifrelenir.
- Oluşturulan JWE, güvenli olmayan bir iletişim kanalı üzerinden bile olsa, arka uç servisine gönderilir.
- Kredi Değerlendirme Servisi, JWE'yi aldığında, kendi özel anahtarını kullanarak önce CEK'i deşifre eder. Ardından, deşifre edilmiş CEK ve JWE içinde bulunan IV ile Ciphertext'i deşifre ederek orijinal hassas verilere ulaşır. Son olarak, Authentication Tag'i doğrulayarak verinin bütünlüğünden emin olur.
Bu yöntem sayesinde, hassas veriler ağ üzerinde şifrelenmiş bir formatta taşınır. Eğer bir saldırgan veriyi ele geçirirse bile, ilgili özel anahtara sahip olmadığı sürece verinin içeriğini okuyamaz. Bu, veri gizliliğinin kritik olduğu durumlar için güçlü bir çözümdür.
// Basit bir JWE şifreleme (pseudocode, detaylar atlanmıştır)
function encryptJWE(header, payload, recipientPublicKey) {
// 1. Rastgele bir Content Encryption Key (CEK) oluştur.
const cek = generateRandomKey();
// 2. CEK'i alıcının açık anahtarı ile şifrele.
const encryptedCek = RSA_OAEP_encrypt(cek, recipientPublicKey);
// 3. Payload'ı CEK ve rastgele bir IV ile şifrele.
const { ciphertext, authenticationTag, iv } = AES_256_CBC_HMAC_SHA512_encrypt(payload, cek);
const encodedHeader = Base64URL_encode(JSON.stringify(header));
const encodedEncryptedCek = Base64URL_encode(encryptedCek);
const encodedIv = Base64URL_encode(iv);
const encodedCiphertext = Base64URL_encode(ciphertext);
const encodedAuthenticationTag = Base64URL_encode(authenticationTag);
return ${encodedHeader}.${encodedEncryptedCek}.${encodedIv}.${encodedCiphertext}.${encodedAuthenticationTag};
}
// Basit bir JWE deşifreleme (pseudocode, detaylar atlanmıştır)
function decryptJWE(jweToken, recipientPrivateKey) {
const parts = jweToken.split('.');
const encodedHeader = parts[0];
const encodedEncryptedCek = parts[1];
const encodedIv = parts[2];
const encodedCiphertext = parts[3];
const encodedAuthenticationTag = parts[4];
// 1. Şifrelenmiş CEK'i alıcının özel anahtarı ile deşifre et.
const cek = RSA_OAEP_decrypt(Base64URL_decode(encodedEncryptedCek), recipientPrivateKey);
// 2. Ciphertext'i CEK, IV ve Authentication Tag ile deşifre et ve doğrula.
const decryptedPayload = AES_256_CBC_HMAC_SHA512_decrypt(
Base64URL_decode(encodedCiphertext),
cek,
Base64URL_decode(encodedIv),
Base64URL_decode(encodedAuthenticationTag)
);
return decryptedPayload;
}
JWE, verilerin gizliliğini sağlamanın yanı sıra, şifreleme sırasındaki doğrulama etiketi sayesinde temel bir bütünlük kontrolü de sunar. Ancak unutulmamalıdır ki, bu doğrulama, JWS'teki tam teşekküllü dijital imza kadar kapsamlı değildir. JWE ve JWS'in farklı odak noktaları olduğunu anladığımıza göre, bir sonraki bölümde bu üç kavramı karşılaştıracak ve hangi durumda hangisinin daha uygun olduğunu tartışacağız.
JWT, JWS ve JWE Arasındaki Temel Farklar Nelerdir?
Şimdiye kadar JWT'nin genel bir taşıma formatı olduğunu, JWS'in veri bütünlüğü sağladığını ve JWE'nin veri gizliliği sunduğunu öğrendik. Ancak bu üç terim genellikle birbirinin yerine kullanılsa da, aslında farklı amaçlara hizmet eden, birbirini tamamlayıcı standartlardır. Aralarındaki temel farkları daha net anlamak için bir karşılaştırma tablosu ile özetleyelim:
| Özellik / Standart | JWT (JSON Web Token) | JWS (JSON Web Signature) | JWE (JSON Web Encryption) |
|---|---|---|---|
| Temel Amaç | JSON formatında güvenli bir bilgi taşıyıcısı. Kimlik doğrulama ve yetkilendirme için kullanılır. | Verinin bütünlüğünü ve orijinalliğini garanti eder (değiştirilmediğini doğrular). | Verinin gizliliğini sağlar (yetkisiz kişilerin okumasını engeller). |
| Ana Mekanizma | İmzalanmış veya şifrelenmiş (veya her ikisi) JSON nesnesi. | Dijital imza veya HMAC. | Kriptografik şifreleme (simetrik ve asimetrik). |
| İçerik Görünürlüğü | İmzalı ise herkes okuyabilir, şifreli ise okunamaz. | Okunabilir (imzalanmış içerik açık metindir). | Okunamaz (içerik şifrelidir). |
| Sağladığı Güvenlik | Genellikle bütünlük ve kimlik doğrulama (JWS kullanarak). Gizlilik (JWE kullanarak). | Veri bütünlüğü ve gönderici kimlik doğrulaması (authentication). | Veri gizliliği ve (şifreleme ile birlikte) bütünlük kontrolü. |
| Yapıdaki Bölüm Sayısı | 3 bölüm (Header, Payload, Signature) - JWS için. | 3 bölüm (Header, Payload, Signature). | 5 bölüm (Header, Encrypted Key, IV, Ciphertext, Authentication Tag). |
| Kullanım Senaryoları | API kimlik doğrulama, yetkilendirme, SSO. | Oturum token'ları, API isteklerinin doğrulanması, değiştirilemez veri iletimi. | Hassas verilerin güvenli aktarımı (kredi kartı, sağlık bilgileri), mikroservisler arası gizli iletişim. |
| Bağımsız Kullanım | Tek başına bir standart değildir; genellikle JWS veya JWE ile birlikte kullanılır. | Evet, herhangi bir veriyi imzalamak için tek başına kullanılabilir. | Evet, herhangi bir veriyi şifrelemek için tek başına kullanılabilir. |
Görüldüğü üzere, JWT aslında JWS veya JWE'nin bir "kapsayıcısı" veya "şekli" gibidir. Bir "JSON Web Token" dediğimizde, genellikle imzalanmış bir JWS formatındaki token'ı kastederiz. Bu, token'ın içeriğinin herkes tarafından okunabileceği, ancak değiştirilemediği anlamına gelir. Eğer token'ın içeriğinin gizli kalması gerekiyorsa, o zaman JWE'yi kullanmamız gerekir. Bu durumda, JSON Web Token terimi hala kullanılabilir, ancak arka planda JWE standardı uygulanmaktadır.
Dolayısıyla, bu üç terimi şöyle düşünebiliriz:
- JWT: Genel bir çerçeve veya yapılandırma formatıdır. Bir kimlik doğrulama veya yetkilendirme token'ı olarak JSON verilerini taşımanın bir yolu.
- JWS: JWT'nin bir uzantısıdır ve taşınan verinin değiştirilmediğini (bütünlüğünü) garanti etmek için dijital imza kullanır. JWT genellikle JWS formatında imzalanır.
- JWE: JWT'nin başka bir uzantısıdır ve taşınan verinin gizliliğini sağlamak için şifreleme kullanır. JWT'nin içeriği hassas olduğunda JWE formatında şifrelenir.
Uzman İpucu: JWS ve JWE Kombinasyonu
Bazı durumlarda, hem veri bütünlüğüne hem de gizliliğe ihtiyaç duyabilirsiniz. Örneğin, hassas verileri taşıyan bir JWT'nin hem şifrelenmesi hem de imzalanması gerekebilir. Bu durumda, genellikle iç içe geçmiş bir yapı kullanılır: önce payload JWS olarak imzalanır, ardından bu imzalı JWS, JWE olarak şifrelenir. Alıcı tarafında ise bu işlem tersine çevrilir: önce JWE deşifre edilir, ardından çıkan JWS doğrulanır. Bu, hem gizliliği hem de bütünlüğü aynı anda sağlamanın en güvenli yoludur.
Bu bölüm, JWT, JWS ve JWE arasındaki kritik farkları netleştirmemize yardımcı oldu. Bir sonraki ve son ana bölümde, edindiğimiz bu bilgileri birleştirerek, farklı senaryolarda hangi standardın veya kombinasyonun kullanılması gerektiğine dair pratik tavsiyelerde bulunacağız.
Hangi Durumda Hangisini Kullanmalıyız? Pratik Karar Verme Rehberi
JWT, JWS ve JWE arasındaki farkları ve her birinin temel yeteneklerini anladığımıza göre, şimdi en pratik soruya odaklanalım: Uygulamalarımızda hangi durumda hangisini veya hangilerinin kombinasyonunu kullanmalıyız? Karar, uygulamanızın güvenlik gereksinimlerine, iletilen verinin hassasiyetine ve performans beklentilerine bağlıdır.
1. Yalnızca JWT (JWS Olarak İmzalanmış)
Bu, en yaygın kullanım şeklidir ve çoğu kimlik doğrulama/yetkilendirme senaryosu için yeterlidir.
- Ne Zaman Kullanılır?
- Kimlik Doğrulama ve Yetkilendirme Tokenları: Kullanıcının kimliğini ve rollerini içeren, ancak hassas kişisel veri içermeyen token'lar için. Örneğin,
"userId": "123", "role": "admin"gibi bilgiler. - Stateless API Erişimi: Mikroservisler veya SPA'lar (Single Page Applications) ve mobil uygulamalar tarafından bir API'ye erişim için. Sunucu, token'daki bilgilere güvenebilir ve veritabanı sorgusu yapmadan yetkilendirme kararı verebilir.
- SSO Çözümleri: Uygulamalar arası geçişlerde kullanıcı kimliğini doğrulamak için.
- Kimlik Doğrulama ve Yetkilendirme Tokenları: Kullanıcının kimliğini ve rollerini içeren, ancak hassas kişisel veri içermeyen token'lar için. Örneğin,
- Neden?
- Token içeriği herkes tarafından okunabilir, bu kabul edilebilir.
- JWS imzası, token'ın değiştirilmediğini ve güvenilir bir kaynaktan geldiğini garanti eder.
- Performans açısından hafiftir.
- Önemli Not: JWS imzalı bir JWT'nin içeriği Base64URL ile kodlandığı için "gizli" değildir, sadece "kurcalanmadığı" garanti edilir. İçine asla direkt olarak şifre, kredi kartı numarası gibi hassas bilgiler koymayın.
2. Yalnızca JWE (Şifrelenmiş İçerik)
Bu senaryo, verinin içeriğinin kesinlikle gizli kalması gerektiği durumlarda tercih edilir.
- Ne Zaman Kullanılır?
- Hassas Veri Aktarımı: Kredi kartı bilgileri, sağlık kayıtları, kişisel kimlik numaraları gibi verilerin ağ üzerinden iletilmesi gerektiğinde.
- Gizli Konfigürasyonlar: Yalnızca belirli servislerin okuyabileceği gizli yapılandırma verilerinin aktarımı.
- Güvenli Mesajlaşma: Mesajın sadece alıcı tarafından okunabilmesini sağlamak.
- Neden?
- Verinin içeriği şifrelidir ve sadece uygun anahtarlara sahip yetkili alıcı tarafından deşifre edilebilir.
- Ağ üzerinde ele geçirilse bile, veri okunamaz.
- Önemli Not: JWE, varsayılan olarak JWS'in sağladığı dijital imza seviyesinde bir bütünlük garantisi sunmaz. authentication tag, verinin şifreleme sırasında değiştirilmediğini doğrular, ancak gönderenin kimliğini doğrudan garanti etmez. Eğer gönderenin kimliği de önemliyse, JWS ile birlikte kullanmayı düşünebilirsiniz.
3. JWS ve JWE Kombinasyonu (İç İçe Geçmiş Tokenlar)
En yüksek güvenlik seviyesini isteyen durumlar için idealdir: hem gizlilik hem de bütünlük ve orijinallik garantisi.
- Ne Zaman Kullanılır?
- Yüksek Hassasiyetli Finansal İşlemler: Bankacılık veya ödeme sistemlerinde, kullanıcı bilgilerinin ve işlem detaylarının hem gizli kalması hem de değiştirilmediğinin garanti edilmesi gerektiğinde.
- Devlet Sırrı veya Kritik Altyapı İletişimi: Çok gizli bilgilerin servisler arası aktarımı.
- Güvenli Mikroservis Kimlik Doğrulaması: Bir servis tarafından oluşturulan, hassas bilgiler içeren ve başka bir servise gönderilen bir token'ın hem içeriğinin gizli kalması hem de bu token'ın gerçekten yetkili servisten geldiğinin kanıtlanması gerektiğinde.
- Neden?
- Önce verinin imzalanması, ardından bu imzalı verinin şifrelenmesi, hem verinin değiştirilmediğini (imza ile) hem de içeriğinin okunamaz olduğunu (şifreleme ile) garantiler.
- Alıcı, önce şifreyi çözer, sonra imzayı doğrular.
- Önemli Not: Bu kombinasyon, ek kriptografik işlem gerektirdiği için performans maliyetini artırabilir. Sadece gerçekten ihtiyaç duyulan senaryolarda kullanılması önerilir. Anahtar yönetimi de daha karmaşık hale gelir.
Özet Karar Ağacı
- Soru: Token içeriğinin üçüncü taraflarca okunması sorun teşkil ediyor mu?
- Hayır (Okunabilir olmasında sakınca yok): JWS kullanın. (Varsayılan JWT kullanımı)
- Örnek: Kullanıcı ID, rol bilgisi.
- Evet (Gizli kalmalı): JWE kullanın.
- Soru: Gönderenin kimliğinin ve verinin bütünlüğünün de garantilenmesi gerekiyor mu? (Sadece JWE'nin authentication tag'i yeterli değil mi?)
- Hayır (Sadece gizlilik yeterli): Yalnızca JWE kullanın.
- Örnek: Tek yönlü hassas veri aktarımı.
- Evet (Gizlilik ve güçlü bütünlük/orijinallik ikisi de gerekli): İç içe geçmiş JWS ve JWE kombinasyonu kullanın.
- Örnek: Finansal işlem detayları.
- Hayır (Sadece gizlilik yeterli): Yalnızca JWE kullanın.
- Soru: Gönderenin kimliğinin ve verinin bütünlüğünün de garantilenmesi gerekiyor mu? (Sadece JWE'nin authentication tag'i yeterli değil mi?)
- Hayır (Okunabilir olmasında sakınca yok): JWS kullanın. (Varsayılan JWT kullanımı)
Bu karar rehberi, uygulamanızın özel güvenlik ihtiyaçlarına göre doğru standardı seçmenize yardımcı olacaktır. Unutmayın, güvenlik, katmanlı bir yaklaşımdır ve JWT/JWS/JWE seçimi, genel güvenlik stratejinizin sadece bir parçasıdır. Anahtar yönetimi, token süreleri, yeniden oynatma saldırıları ve güvenli depolama gibi diğer faktörleri de göz önünde bulundurmak önemlidir.
İleri Düzey Kullanım İpuçları ve En İyi Uygulamalar
JWT, JWS ve JWE'yi etkili bir şekilde kullanmak, sadece standartları anlamakla kalmaz, aynı zamanda güvenlik en iyi uygulamalarını da takip etmeyi gerektirir. İşte deneyimli kullanıcılar için bazı ileri düzey ipuçları ve püf noktaları:
1. Anahtar Yönetimi (Key Management)
Kriptografik anahtarlar, güvenlik modelinizin temelidir. Anahtarların güvenliği tehlikeye girerse, token'larınız da tehlikeye girer.
- Anahtar Rotasyonu: Anahtarları düzenli olarak değiştirin (örneğin, 3-6 ayda bir). Bu, bir anahtarın tehlikeye girmesi durumunda zararı sınırlar.
- Ayrı Anahtarlar: Her ortam (geliştirme, test, üretim) için farklı anahtarlar kullanın. Hatta, farklı hizmetler veya farklı amaçlar için (imzalama, şifreleme) ayrı anahtarlar kullanmayı düşünün.
- Güvenli Depolama: Anahtarları donanım güvenlik modüllerinde (HSM), anahtar kasalarında (key vaults) veya diğer güvenli depolama çözümlerinde saklayın. Asla kodunuzun içinde veya sürüm kontrol sistemlerinde saklamayın.
- Asimetrik Anahtarların Kullanımı: Özellikle JWS ve JWE'de RSA gibi asimetrik algoritmalar kullanıyorsanız, özel anahtarı yalnızca imzalayan/şifreleyen tarafın, açık anahtarı ise doğrulayan/deşifre eden tarafların bilmesini sağlayın. Bu, özel anahtarın sızma riskini azaltır.
2. Token Geçerlilik Süresi (Expiration - exp Claim)
Token'ların sınırsız süreli olması büyük bir güvenlik riskidir.
- Kısa Süreli Token'lar: JWT'leri mümkün olduğunca kısa ömürlü yapın (örneğin, 5-15 dakika). Bu, bir token ele geçirilirse, saldırganın onu kullanabileceği süreyi sınırlar.
- Yenileme Token'ları (Refresh Tokens): Kısa ömürlü erişim token'ları ile birlikte daha uzun ömürlü yenileme token'ları kullanın. Erişim token'ı dolduğunda, yenileme token'ı ile sunucudan yeni bir erişim token'ı isteyebilirsiniz. Yenileme token'ları genellikle tek kullanımlık olmalı ve sunucu tarafında güvenli bir şekilde depolanmalı/geçersiz kılınmalıdır.
3. Hedef Kitle ve Yayınlayıcı Doğrulama (aud, iss Claims)
Bu claim'ler, token'ın doğru yerden geldiğini ve doğru hedef için olduğunu doğrulamanıza yardımcı olur.
iss(Issuer): Token'ı yayınlayan varlık (örneğin,"AuthService"). Token'ı kabul eden taraf, bu değerin beklediği yayınlayıcı ile eşleştiğinden emin olmalıdır.aud(Audience): Token'ın hedeflenen alıcısı veya alıcıları (örneğin,"api.example.com"). Token'ı kabul eden taraf, bu değerin kendisini içerdiğinden emin olmalıdır. Bu, bir token'ın yanlış serviste kullanılmasını engeller.
4. Algoritma Seçimi ve Zayıf Algoritmalardan Kaçınma
Kullanılan kriptografik algoritmaların güncel ve güvenli olduğundan emin olun.
- Zayıf Algoritmalardan Kaçının: Özellikle
Nonealgoritmasından kesinlikle kaçınılmalıdır, bu algoritma imzayı devre dışı bırakır ve token'ı herkesin değiştirmesine izin verir. - Güçlü Algoritmalar Kullanın: HMAC için SHA-256 veya SHA-512, RSA için RS256 veya PS256 gibi güçlü algoritmaları tercih edin. Eliptik Eğri Kriptografisi (ECC) tabanlı ES256/ES384/ES512 de iyi bir seçenektir.
5. Geri Alma Mekanizmaları (Revocation)
JWT'ler doğası gereği sunucusuz olduğu için, yayınlandıktan sonra iptal etmek zordur (server-side session gibi değil).
- Kısa Süreli Token'lar: En iyi iptal mekanizması, token'ın kısa ömürlü olmasıdır. Süresi dolan token'lar otomatik olarak geçersiz olur.
- Kara Liste (Blacklisting): Eğer acil bir durumda bir token'ı iptal etmeniz gerekiyorsa, ele geçirilmiş token'ları bir kara listeye (önbellek tabanlı hızlı bir veri deposu, örneğin Redis) ekleyebilirsiniz. Her istekte, gelen token'ın bu listede olup olmadığını kontrol etmeniz gerekir. Bu, sunucunun durum tutma yükünü artırır, ancak belirli senaryolarda gerekebilir.
6. Güvenli Aktarım Protokolleri
Token'lar her zaman HTTPS/TLS üzerinden iletilmelidir. Bu, ağ üzerindeki "man-in-the-middle" saldırılarına karşı koruma sağlar ve token'ın ele geçirilmesini zorlaştırır.
7. Mobil Uyumluluk ve Güvenlik İçin HTML/CSS Notu
Mobil cihazlar için responsive tasarım, kullanıcı deneyimi ve güvenlik açısından kritiktir. Token'lar doğrudan HTML'in bir parçası olmasa da, token tabanlı bir uygulama geliştirirken front-end güvenliğini de göz önünde bulundurmalısınız.
Bu CSS ve meta etiketi, mobil cihazlarda makalenin okunabilirliğini ve genel kullanıcı deneyimini artırır. Güvenlik tarafında ise, token'ların tarayıcıda XSS saldırılarına karşı korunması için HttpOnly çerezleri veya LocalStorage yerine IndexedDB gibi daha güvenli depolama seçenekleri değerlendirilmelidir.
Sonuç
Bu kapsamlı makale boyunca, modern web güvenliğinin temel taşlarından olan JWT, JWS ve JWE standartlarını derinlemesine inceledik. JSON Web Token'ın (JWT) veri taşıma formatı olarak nasıl kullanıldığını, JSON Web Signature'ın (JWS) veri bütünlüğünü ve orijinalliğini nasıl sağladığını, ve JSON Web Encryption'ın (JWE) hassas verilerin gizliliğini nasıl koruduğunu öğrendik. Ayrıca, her birinin kendine özgü kullanım senaryolarına ve gerçek dünya vaka analizlerine odaklanarak, hangi durumda hangi standardı tercih etmemiz gerektiğine dair pratik bir rehber sunduk. JWS ve JWE'nin, JWT'yi tamamlayıcı rolleri olduğu ve hatta iç içe geçmiş yapılarla hem bütünlük hem de gizliliğin aynı anda sağlanabileceği konusunda bilgilendik.
Unutmamak gerekir ki, herhangi bir güvenlik çözümü gibi, JWT/JWS/JWE kullanımı da doğru anahtar yönetimi, token yaşam döngüsü yönetimi, güçlü algoritma seçimi ve güvenli aktarım protokolleri gibi en iyi uygulamalarla birleştiğinde etkili olur. Bu standartlar, özellikle ölçeklenebilir, sunucusuz ve mikroservis tabanlı mimariler için vazgeçilmez araçlardır. Güvenlik mimarinizi tasarlarken, uygulamanızın özel ihtiyaçlarını dikkatlice analiz edin ve doğru standart kombinasyonunu seçerek hem performans hem de güvenlik açısından optimum çözümleri uygulayın. Bilinçli seçimler, uygulamalarınızın dijital dünyada güvende kalmasının anahtarıdır.
Sıkça Sorulan Sorular
1. JWT token'ı neden şifrelemeli değilim?
JWT varsayılan olarak şifrelenmez; Base64URL ile kodlanır, bu da kolayca çözülebilen bir formattır. Asıl güvenlik, JWS kullanarak token'ın imzalanmasıyla sağlanır. İmza, içeriğin değiştirilmediğini ve güvenilir bir kaynaktan geldiğini garanti eder. Eğer içeriğin gizli kalması gerekiyorsa, yani okunmaması gerekiyorsa, o zaman JWE kullanarak token'ı şifrelemeniz gerekir.
2. Refresh Token'lar neden JWT ile birlikte kullanılır?
Erişim token'larının (genellikle JWT olarak imzalanmış) ömrü kısa tutulur (örn. 15 dakika) ki çalınmaları durumunda saldırganın kullanabileceği süre sınırlı olsun. Ancak, kullanıcıların sürekli yeniden giriş yapmaması için daha uzun ömürlü "Refresh Token"lar kullanılır. Erişim token'ı dolduğunda, istemci bu Refresh Token ile sunucudan yeni bir erişim token'ı talep eder. Refresh Token'lar genellikle tek kullanımlık olmalı, sunucu tarafında depolanmalı ve iptal edilebilir olmalıdır.
3. JWS imzalı bir token'ı ele geçiren kötü niyetli bir kullanıcı ne yapabilir?
JWS imzalı bir token, içeriği herkes tarafından okunabilir olduğu için, ele geçiren kötü niyetli bir kullanıcı token içindeki bilgileri (örn. kullanıcı ID, roller) görebilir. Ancak, token'ı değiştirmeye çalışırsa, imza geçersiz hale gelir ve sunucu bu token'ı reddeder. Yani, veriyi okuyabilir ama değiştiremez veya sahte bir token oluşturamaz (gizli anahtara sahip olmadığı sürece).
4. JWT'nin Local Storage'da saklanması güvenli midir?
Local Storage'da JWT saklamak, XSS (Cross-Site Scripting) saldırılarına karşı hassastır. Bir XSS zafiyeti durumunda, saldırganın kötü niyetli JavaScript kodu, Local Storage'daki token'a erişebilir ve onu ele geçirebilir. Bu nedenle, daha güvenli seçenekler olan HttpOnly çerezleri (XSS'e karşı daha dirençli) veya IndexedDB gibi depolama mekanizmaları genellikle daha fazla tavsiye edilir, özellikle hassas uygulamalar için. HttpOnly çerezleri CSRF'ye karşı da korunmalıdır.
5. JWE, JWS'in yerini alabilir mi?
Hayır, JWE JWS'in yerini almaz; farklı amaçlara hizmet ederler. JWS, verinin bütünlüğünü ve gönderenin kimliğini doğrular. JWE ise verinin gizliliğini sağlar. Eğer hem gizlilik hem de güçlü bütünlük garantisi arıyorsanız, JWS'i JWE içine yerleştirerek her iki standardı da birlikte kullanmanız en doğrusudur. JWE'nin kendi içinde bir kimlik doğrulama etiketi olsa da, bu etiket JWS'in dijital imzası kadar kapsamlı bir gönderen kimlik doğrulaması sağlamaz.
