Bir API anahtarı (Application Programming Interface, uygulama programlama arayüzü), bir sistemin bir diğer sisteme kimliğini kanıtlayarak veri çekmesini sağlayan, insan parolasından farklı amaçla üretilmiş bir koddur. Bazı şirketlerin, tüm BT/güvenlik araçlarından veri toplayan kendi iç panosu (dashboard) ya da raporlama sistemi vardır; böyle bir durumda cihaz ve güvenlik bulgusu verisini panele elle bakıp kopyalamak yerine, bu verinin otomatik olarak o sisteme akması çok daha değerlidir. Bu yazı API anahtarının ne olduğunu, bir parolayla farkını ve güvenli kullanım kurallarını anlatır.
API anahtarı neden parola değildir?
Bir parola, bir kişinin kimliğini kanıtlar ve genellikle geniş bir yetki alanına (panele giriş, işlem tetikleme, ayar değiştirme) bağlıdır. Bir API anahtarı ise bir sistemin/programın kimliğini kanıtlar ve yalnızca belirli, önceden tanımlanmış bir amaç için (burada: cihaz ve bulgu verisini okumak) kullanılabilir. Bir API anahtarıyla panele giriş yapılamaz, bir komut tetiklenemez, bir ayar değiştirilemez; bu sınır bilinçli bir tasarım kararıdır, teknik bir eksiklik değildir.
Bir API anahtarı nasıl üretilir, nasıl saklanır?
- Anahtar, tahmin edilemeyecek kadar uzun rastgele bir değerden üretilir, kolay hatırlanan bir parola gibi değildir
- Ham değer yalnızca oluşturulduğu an bir kez gösterilir; o ekranı kapattıktan sonra bir daha görüntülenemez
- Sunucu tarafında anahtarın kendisi değil, onun tek yönlü bir özeti (hash) saklanır; veritabanı ele geçirilse bile ham anahtar oradan geri çıkarılamaz
- Anahtar kaybedilirse (ör. unutulursa ya da yanlış yere not edilirse) eskisi görüntülenemez, yeni bir anahtar üretmek gerekir
Ne tür entegrasyonlar için kullanılır?
Tipik kullanım alanları şunlardır: şirketin kendi iç BT panosuna cihaz sayısını ve durumunu otomatik aktarmak, bir güvenlik olay yönetimi (SIEM, Security Information and Event Management) aracına açık bulguları beslemek, ya da bir raporlama aracına haftalık bir özet çekmek. Hepsinin ortak noktası, bir insanın panele girip elle bakması gerekmemesidir.
Salt okunur olmanın bilinçli gerekçesi
Bir API anahtarının yazma/komut yetkisine de sahip olması, teorik olarak daha "güçlü" bir entegrasyon sağlar, ama riski de büyütür: anahtarın sızması durumunda saldırgan veri okumakla kalmaz, cihazlarda işlem de tetikleyebilir. Bu yüzden ilk sürümde bilinçli olarak dar bir kapsam seçilmiştir; kapsamın ileride genişletilmesi, her genişlemenin kendi riskiyle ayrı ayrı değerlendirilmesi gerektiği anlamına gelir.
Anahtar sızarsa ne olur, nasıl sınırlanır?
- Anahtar yalnızca bir şirkete (tenant) bağlıdır, başka bir şirketin verisine erişemez
- Yazma/komut yetkisi olmadığı için sızan bir anahtarla cihazlarda işlem yaptırılamaz, sadece mevcut veri okunabilir
- Anahtar tek tıkla iptal edilebilir; iptal edilen bir anahtar, çalışmaya devam eden eski bir entegrasyonu derhal durdurur
- Hangi anahtarın ne zaman oluşturulduğu ve kim tarafından iptal edildiği kayıt altındadır
Sık sorulan sorular
API anahtarı ile panele giriş yapılabilir mi? Hayır. Anahtar yalnızca programatik veri okuma için geçerlidir, oturum açma akışıyla hiçbir ilgisi yoktur.
Bir şirket için birden fazla API anahtarı olabilir mi? Evet, her entegrasyon için ayrı isimli bir anahtar oluşturmak, hangi anahtarın hangi amaçla kullanıldığını ayırt etmeyi kolaylaştırır ve birini iptal ederken diğerlerini etkilemez.
Anahtarı kaybettim, nasıl kurtarırım? Kurtarılamaz; ham değer sadece oluşturma anında gösterilir. Yapılacak tek şey eskisini iptal edip yeni bir anahtar oluşturmaktır.
API üzerinden komut tetiklemek mümkün mü? Şu an için hayır, ilk sürüm bilinçli olarak salt okunurdur; yazma işlemleri yalnızca panel oturumu üzerinden, uygun yetkiyle yapılabilir.
TURKONETS'te API anahtarı
TURKONETS panelinde bir yönetici, bir şirket için isimli bir API anahtarı oluşturabilir; bu anahtarla cihaz listesi ve açık güvenlik bulguları programatik olarak çekilebilir. Anahtarın ham değeri sadece oluşturma anında bir kez gösterilir, sunucuda yalnızca özeti saklanır. İlk sürüm bilinçli olarak salt okunurdur, hiçbir yazma/komut işlemi API anahtarıyla yapılamaz; anahtar istendiğinde tek tıkla iptal edilebilir.