JWK (JSON Web Key), dijital imzalar ve şifrelemeler için kullanılan anahtar malzemelerinin JSON formatında tanımlanmasını sağlayan bir standarttır. JWK, hem simetrik hem de açık/özel anahtar çiftleri için destek sunar ve bu anahtarları geniş bir yelpazede kullanım senaryoları için kullanılabilir.

Apinizer üzerinde JWK oluşturabilir, mevcut bir JWK'yı Apinizer'a URL üzerinden veya Clipboard kullanarak aktarabilirsiniz.

JSON Web Keypair oluşturma ayarlarını içeren görsele aşağıda yer verilmiştir:


JSON Web Keypair oluşturma konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Alan

Açıklama

Ad

(Name)

JWK'nın kullanımını ve yönetimini kolaylaştırmak için ad yazılabilir.

Açıklama

(Description)

JWK'nın kullanımını ve yönetimini kolaylaştırmak için açıklama yazılabilir.

JWK Tipi

(Source of JWK)

JWK'nın hangi kaynaktan oluşturulacağını belirtir. Seçilebilecek tipler şunlardır:

  • Üret

  • URL Bağlantısıyla Al

  • Panoya Yapıştır

  • Keystore'dan Dönüştür

  • Açık Anahtardan Dönüştür
  • Gizli Anahtardan Dönüştür
  • Sertifikadan Dönüştür

JWK oluşturma tipi Üret seçilmiş ise şu alanlar aktif hale gelir:

Alan

Açıklama

Anahtar Tipi

(Key Type)

Oluşturulacak olan JWK'nın hangi tipte olduğunu belirtir:

  • RSA: RFC 3447 (Public-Key Cryptography Standards PKCS)

  • EC: Elliptic Curve (DSS)

  • OCT: Octet Sequence (Symmetric Key)

  • OKP: Octet Key Pair (RFC 8037)

Bu değerlere göre algoritmalar/curve değerleri değişkenlik gösterir.

Anahtar Kullanım Tipi

(Key Use)

JWK'nın imzalamak/imza doğrulamak veya şifrelemek/şifre çözmek için kullanılacağını belirtir.

Anahtar Uzunluğu

(Key Size)

Oluşturulacak olan anahtarın byte cinsinden uzunluğudur.

Curve

Oluşturulacak JWK'nın curve tipidir.

Algoritma

(Algorithm)

Oluşturulacak JWK'nın algoritmasıdır.

Anahtar Id

(Key Id)

Oluşturulacak JWK'nın id'sinin nasıl oluşturulacağını belirtir.

JWK oluşturma tipi URL Bağlantısıyla Al seçilmiş ise şu alanlar aktif hale gelir:

Alan

Açıklama

URL

JWK kümesinin bulunduğu erişim adresidir.

Bağlantı Zaman Aşımı

(Connect Timeout)

JWK kümesinin bulunduğu erişim adresine yapılacak bağlantının bağlantı zaman aşımı süresinin milisaniye cinsinden değeridir.

Okuma Zaman Aşımı

(Read Timeout)

JWK kümesinin bulunduğu erişim adresine yapılacak bağlantının okuma zaman aşımı süresinin milisaniye cinsinden değeridir.

Maksimum Boyutu

(Size Limit)

JWK kümesinin bulunduğu erişim adresinden okunacak verinin maksimum büyüklüğünün byte cinsinden değeridir.

Key Id

JWK kümesinin bulunduğu erişim adresinden alınmak istenen JWK'nın id'sidir. URL adresinden birden fazla JWK bulunsa dahi Apinizer üzerine aynı anda sadece bir tane tanımlama yapılabilir.

JWK oluşturma tipi Panoya Yapıştır seçilmiş ise şu alanlar aktif hale gelir:

Alan

Açıklama

JWK kümesinin text halinin girilmesi için kullanılan alandır.

Key Id

JWK kümesinin içinden alınmak istenen JWK'nın id'sidir. Metin alanda birden fazla JWK bulunsa dahi Apinizer üzerine aynı anda sadece bir tane tanımlama yapılabilir.

JWK oluşturma tipi Keystore'dan Dönüştür seçilmiş ise şu alanlar aktif hale gelir:

Alan

Açıklama

Key Store

JWK'nın hangi keystore'dan oluşturulacağını belirtmek için kullanılır.

Environment FromOluşturulacak JWK'nın hangi ortamdan oluşturulacağını belirtmek için kullanılır.

(Key Store Algorithm)

Keystore'dan oluşturulacak JWK'nın algoritmasını belirtmek için kullanılır.

Takma Ad

(Alias)

Oluşturulacak JWK'nın Key Id değeri buradan alınır.

Kullanım Tipi

(Use Type)

JWK'nın imzalamak/imza doğrulamak veya şifrelemek/şifre çözmek için kullanılacağını belirtir.

JWK oluşturma tipi Açık Anahtardan Dönüştür seçilmiş ise şu alanlar aktif hale gelir:

Alan

Açıklama

Açık Anahtar

(Public Key)

JWK'nın hangi anahtardan oluşturulacağını belirtmek için kullanılır.

Environment FromOluşturulacak JWK'nın hangi ortamdan oluşturulacağını belirtmek için kullanılır.

(Key Store Algorithm)

Açık Anahtardan oluşturulacak JWK'nın algoritmasını belirtmek için kullanılır.

Kullanım Tipi

(Use Type)

JWK'nın imzalamak/imza doğrulamak veya şifrelemek/şifre çözmek için kullanılacağını belirtir.

JWK oluşturma tipi Gizli Anahtardan Dönüştür seçilmiş ise şu alanlar aktif hale gelir:

Alan

Açıklama

Gizli Anahtar

(Private Key)

JWK'nın hangi anahtardan oluşturulacağını belirtmek için kullanılır.

Environment FromOluşturulacak JWK'nın hangi ortamdan oluşturulacağını belirtmek için kullanılır.

(Key Store Algorithm)

Gizli Anahtardan oluşturulacak JWK'nın algoritmasını belirtmek için kullanılır.

Kullanım Tipi

(Use Type)

JWK'nın imzalamak/imza doğrulamak veya şifrelemek/şifre çözmek için kullanılacağını belirtir.

JWK oluşturma tipi Sertifikadan Dönüştür seçilmiş ise şu alanlar aktif hale gelir:

Alan

Açıklama

Sertifika

(Certificate)

JWK'nın hangi sertifikadan oluşturulacağını belirtmek için kullanılır.

Environment FromOluşturulacak JWK'nın hangi ortamdan oluşturulacağını belirtmek için kullanılır.

(Key Store Algorithm)

Sertifikadan oluşturulacak JWK'nın algoritmasını belirtmek için kullanılır.

Kullanım Tipi

(Use Type)

JWK'nın imzalamak/imza doğrulamak veya şifrelemek/şifre çözmek için kullanılacağını belirtir.