Apinizer’da Kimlik Yönetimi ile yapılan erişim denetimi ayarı 2 farklı şekilde yapılandırılabilir:
- Kimlik bilgileri üzerinden: Kimlik bilgisinin detayına gidilir. Kimlik bilgisinin detayında erişim izni verilmiş API Proxy’ler ve ayarları görüntülenerek işlem yapılır.
- API Proxy’ler üzerinden: API Proxy’nin detayına gidilir. API Proxy’e erişim izni verilmiş kimlik bilgileri görüntülenerek işlem yapılır.
Kimlik Bilgisi Listesi
Kimlik bilgileri sayfası ilk açıldığında mevcut kimlik bilgilerinin listelendiği görsele aşağıda yer verilmiştir:
| Alan | Açıklama |
|---|---|
| Arama Alanı (Advanced Search) | Kimlik bilgileri üzerinde detaylı arama yapmak için kullanılır. |
| Kimlik Bilgisi Listesi (Access Control List) | Kimlik bilgilerinin listelendiği ve sıralandığı tablodur. |
| Oluştur (Create) | Yeni “Kimlik Bilgisi” oluşturmak için kullanılır. |
| CSV’den İçe Aktar (Import From CSV) | Topluca kimlik bilgisi kaydedilmesi için kullanılır. |
| Veriyi Aktar (Import) | Kimlik bilgisini .json veya .zip uzantılı olarak içe aktarmak için kullanılır. |
| Kimlik Bilgileri Listesini Excel Dosyası Olarak Dışa Aktar (Export Credential List as an Excel File) | Kimlik bilgileri listesini excel dosyası olarak indirmek için kullanılır. |
| Dışa Aktar (Export) | Kimlik bilgisine ait tüm veriler, başka bir proje de tekrar kullanmak için dışa aktarılabilir. Bu süreçte, sadece genel bilgiler dışa aktarılır. Gelişmiş ayarlar, API Proxy EKL, API Proxy Grup EKL, JWK ayarları ve mTLS ayarları, proje bazında bilgiler oldukları için dışa aktarılmaz. |
CSV ile Toplu Kimlik Bilgisi Aktarımı
Hali hazırda mevcut olan kimlik bilgilerinin Apinizer’a aktarımı için CSV’den aktar özelliği kullanılabilir. Bu özellik kullanılmak istenirse;1
Veri Formatı
Mevcut kullanıcı bilgileri her bir kayıt bir satıra gelecek şekilde yazılmalıdır.
2
Bilgi İçeriği
Kayıt içerisinde kullanıcı adı ve parola bilgisi beraber ve parola bilgisi açık olarak yer almak zorundadır.
3
Ayıraç Kullanımı
kullanıcı adı ve parola bilgisi arasına ayıraç olarak # işareti koyulmalıdır.
4
Satır Ayrımı
Her bir satır Enter tuşu ile ayrılmalıdır.
Kimlik Bilgisini Dışa Aktarma
Kimlik Bilgisi’ni dışa aktarmak için satır sonundaki menüden Dışa Aktar (Export) seçilir.
Kimlik Bilgisini Globalleştirme
Kimlik bilgileri “Globalleştir” seçeneği ile Admin sayfasına taşınarak görünümü bu listeden kalkar, tüm projelerde kullanılabilir hale gelir ve yönetimi Admin kullanıcısına bırakılır. Kimlik Bilgisi’ni globalleştirmek için satır sonundaki menüden Globalleştir (Move to Global) seçilir.
Kimlik Bilgisi Oluşturma
Kimlik bilgileri eklemek için Oluştur (Create) tuşuna basıldığında aşağıda görseli paylaşılan ekran gelir:
- Kimlik bilgisinin detaylarının girilmesi, oluşturulması veya güncellenmesi
- Kimlik bilgisinin erişim denetimi listesinin oluşturulması veya güncellenmesi
| Alan | Açıklama |
|---|---|
| Kullanıcı Adı (Client Id/Username) | Kimliği ifade edecek “kullanıcı adı” bilgisidir, yetkilendirme için kullanıcı kimliğine erişmek için bu değer kullanılır. Tüm sistemde tekil ve biricik olmak zorundadır. |
| Parola (Client Secret/Password) | Kimliğin parola bilgisidir. İstenirse yanındaki tuş ile otomatik oluşturulabilir. |
| E-Posta (E-mail) | Kimliğin sahibi istemciye erişmek için kullanılan ve istemciye ait mail bilgisidir. |
| Tam Adı (Full Name) | Kimliğin sahibi istemcinin tam adıdır. |
| Aktif (Enabled) | Kimlik bilgisinin aktif (kullanılabilir) olup olmadığını belirtir. Seçilmiş ise aktiftir. |
| Geçerliliğini Yitirme Zamanı (Expires On) | Bu tarih değerinin girilmesi durumunda Kimlik Bilgisi bu tarihten itibaren erişemez hale gelir. |
| Kurum (Organization) | Kimlik bilgisinin bağlı olduğu kurum/organizasyon bilgisi isteğe bağlı olarak seçilebilir. Sadece bilgi/raporlama amacıyla tutulur. |
| Roller (Roles) | Kimlik bilgisinin sahip olduğu rollerdir. Bu rollere göre yetkilendirme yapılır. |
| IP Listesi (IP List) | Kimlik bilgisinin sadece belli IP adreslerden gelmesi gerekiyorsa, bu kimlik bilgisinin hangi IP adreslerinden erişebileceği bilgisi buraya girilir. Boş bırakılması tüm IP’lerden isteğin kabul edileceği anlamına gelir. |
| IP Coğrafi Konum (IP Geolocation) | Kimlik bilgisinin sadece belirli ülkelerden erişim yapmasına izin vermek için kullanılır. Ülke seçimi yapılabilir. Varsayılan olarak “Countries: All” seçilidir ve tüm ülkelerden erişime izin verir. |
| Açıklama (Description) | Kimlik bilgisi hakkında açıklama girilmek istenirse bu alan doldurulabilir. |
| Gelişmiş Ayarları Aktifleştir (Enable Advanced Settings) | Kimlik bilgisinin parola ve IP listesinin ortam bazlı özelleştirilme ihtiyacı varsa, bu seçenek ile özelleştirme ayarları aktif hale gelir. Seçildiğinde her bir ortam için parola ve IP listesi girilebilir hale gelir. |
| Ortam Parolası (Environment Password) | İlgili satırdaki ortama özel olarak kullanılmak üzere parola girilebilir. |
| Ortam IP Listesi (Environment IP List) | İlgili satırdaki ortama özel olarak kullanılmak üzere IP listesi girilebilir. |
Kimlik Bilgisi Erişim Denetimi Ayarları
Kimlik bilgisinin erişim izinlerini ayarlamak için Erişim Denetimi (Access Control List) paneline geçilerek işlem yapılır. Bu panelde erişim izni verilmek istenen API Proxy aşağıdaki görselde kırmızı ile işaretli tuşa basılarak karşımıza çıkan ekrandan seçilir.
API Proxy Bazlı Özelleştirme
API Proxy bazında kimlik bilgisinin özelleştirilmesi için ilgili API Proxy kaydındaki Düzenle (Edit) linkine basılır.
| Alan | Açıklama |
|---|---|
| Geçerliliğini Yitirme Zamanı (Expires On) | Bu tarih değerinin girilmesi durumunda Kimlik Bilgisi bu tarih geldiği zamandan itibaren API Proxy’e erişemez hale gelir. |
| Ortam Listesi (Environment List) | API Proxy’nin yüklendiği ortama özel olarak Kota ve Daraltma değerlerinin girilebilmesini sağlar. |
| Ortam Kotası (Quota) | API Proxy’nin belirtilen ortama özel Kota değeridir. |
| Ortam Daraltması (Throttling) | API Proxy’nin belirtilen ortama özel Daraltma değeridir. |
| Mesaj Sayısı (Message Count) | Daraltma Aralığı ile verilen süre içinde Backend API’ye gönderilebilecek olan maksimum mesaj sayısıdır. |
| Daraltma Zaman Miktarı (Interval Time Amount) | Seçilen zaman birimi cinsinden, sınırlama penceresinin süresini belirten sayısal değer. |
| Daraltma Zaman Birimi (Interval Time Unit) | API istek sınırlaması için kullanılan zaman aralığı birimi (örneğin, saniye, dakika). |
| Periyot Tipi (Interval Window Type) | API istek sınırlaması için kullanılan zaman aralığı yöntemi (sabit veya kayan). |
| Cache Bağlantısı Zaman Aşım Süresi (Cache Connection Timeout (Second)) | Cache bağlantısı için zaman aşımı süresi belirtilir. |
| Cache Bağlantı Hatası Eylemi (Action for Cache Connection Error) | Eğer politika cache sunucusuna bağlantı sorunu yaşarsa uygulanacak eylem belirtilir. |
| İzin Verilmeyen Metodlar (Disallowed Methods) | Kimlik bilgisinin sahip olduğu rollerinden bağımsız olarak API Proxy’nin herhangi bir metoduna erişmemesi isteniyorsa, burada API Proxy’nin erişime kapatılmak istenen metodları seçilir. |
| Kaydet ve Yükle Tuşu (Save and Deploy) | Ayarların/değişikliklerin tamamlanması sonrasında Kaydet ve Yükle tuşuna basılarak ayarların aktifleşmesi sağlanır. |
Token Ayarları
Token ayarları için Token Ayarları (Token Settings) paneline geçilerek işlem yapılır. Token ayarlarını içeren görsele aşağıda yer verilmiştir:
| Alan | Açıklama |
|---|---|
| Onay Türü (Grant Type) | Buna göre token üretimi istenecek olan bilgiler değişmektedir. Client Credentials veya Password. |
| Kimlik/Yetki Doğrulama Servisi (Identity/Role/Group Service) | Grant Type password ise; gönderilecek olan username, password bilgisinin nereden doğrulanacağını belirten kimlik sağlayıcı servisidir. |
| JWT Rejeneratör API Servisi (Select to JWT Regenerator Service API) | Bu özellik yalnızca JWT token kullanımında geçerlidir. JWT token değerinin seçilen API üzerinden kimlik doğrulama olmaksızın tekrar oluşturulmasını sağlar. |
| Önceki Token’ı Sil (Delete Previous Token) | Bu özellik yalnızca OAuth2 token kullanımında geçerlidir. Yeni token alımlarında ya da yapılan yenilemelerde, önceki token’ı geçersiz hale getirir. |
| Token Ölümsüz Olsun (Token Never Expires) | Bu seçenek işaretlenirse token zamana bağlı olarak geçersiz hale gelmez, istenildiği kadar kullanılabilir. |
| Token Geçerlilik Süresi (Token Expires In) | Token’ın kullanılabilir olacağı yaşam süresini belirtir. |
| Token Yenileme Olsun (Refresh Token Allowed) | Token’ın yenilenme özelliğini etkinleştirir. |
| Token Yenileme Sayısı (Refresh Token Count) | Token’ın kaç kez yenilenebilir olacağını belirtir. |
| Yenilenmiş Token Geçerlilik Süresi (Refresh Token Expires In) | Her bir yenilemede, token’ın ne kadarlık yaşam süresine sahip olacağını belirtir. |
| JWT İmzalama Algoritması (JWT Signature Algorithm) | Bu özellik yalnızca JWT token kullanımında geçerlidir. Token üretilirken kullanılacak olan imza algoritmasını seçmek için kullanılır. |
| URL Parametrelerine İzin Ver (Allow URL Parameters) | Token Servisine token üretimi için istek gönderilirken bilgilerin URL parametresi halinde de gönderilmesine izin verir. Güvenlik açısından risk oluşturacağından kullanılmaması tavsiye edilir. |
JWK Ayarları
JWK ayarları sekmesinde gelen kimlik bilgisinin JWK anahtarları ile ilgili verisinin decrypt edilmesi ve/veya imzasının doğrulanabilmesi için gerekli olan JWK anahtarları seçimleri yapılır. JWK ayarlarını içeren görsele aşağıda yer verilmiştir:
| Alan | Açıklama |
|---|---|
| JOSE İmza & Doğrulama için JWK (JWK for JOSE Sign & Validation) | Kimlik bilgisinin sahip olduğu imzalama/imza doğrulama JWK anahtarıdır. JOSE Validation/Implementation politikalarında kullanıcının anahtarı kullanılsın denildiğinde imzalama/imza doğrulama için bu JWK kullanılır. |
| JOSE Encryption & Descryption için JWK (JWK for JOSE Encryption & Descryption) | Kimlik bilgisinin sahip olduğu şifreleme/şifre doğrulama JWK anahtarıdır. JOSE Validation/Implementation politikalarında kullanıcının anahtarı kullanılsın denildiğinde şifreleme/şifre doğrulama için bu JWK kullanılır. |
mTLS Ayarları
mTLS ayarları sekmesinde gelen kimlik bilgisinin mTLS Authentication Poliçesi ile sertifikasının doğrulanabilmesi için gerekli olan truststore seçimi yapılır. mTLS ayarlarını içeren görsele aşağıda yer verilmiştir:
| Alan | Açıklama |
|---|---|
| Truststore (Truststore) | Truststore seçilir. Eğer daha önce tanımlı değil ise yandaki + butonuna basarak yeni bir tane oluşturulabilir. |