API Anahtarları

Yaklaşık 2 dk okuma

API anahtarları, dış uygulamaların kullanıcı adı ve şifre girmeden 2WinScada'ya erişmesini sağlar. Anahtarlar Ayarlar > Kullanıcı Yönetimi sayfasının API Anahtarları sekmesinde yönetilir. Bu sekmeyi kullanmak için kullanıcının grubunda UserAdministrator yetkisi bulunmalıdır.

Her anahtar bir kullanıcıya aittir ve o kullanıcının yetkileri ve proses grubu erişimiyle çalışır. Bir kullanıcıya birden fazla anahtar tanımlanabilir; böylece her entegrasyona ayrı bir anahtar verilip gerektiğinde yalnızca o anahtar silinebilir.

Anahtarlar iki amaçtan biri için oluşturulur:

• SCADA API: REST API istekleri için kullanılır. Bu anahtarlar 2Win- ile başlar ve isteğin ApiKey başlığında gönderilir.
• MCP erişimi: 2WinScada MCP sunucusuna bağlanan yapay zekâ istemcileri için kullanılır. Bu anahtarlar 2WinMcp- ile başlar.

Bir amaç için oluşturulan anahtar diğerinde geçersizdir; örneğin MCP erişimi anahtarı REST API'de reddedilir.

Tabloda şu sütunlar bulunur:

• Kullanıcı Adı: Anahtarın sahibi olan kullanıcı.
• Anahtar adı: Anahtarı tanımlayan ad.
• Amaç: SCADA API veya MCP erişimi.
• İstek Sayısı: Anahtarla 10 dakikalık süre içinde yapılan istek sayısı.
• Maksimum İstek Sayısı: Anahtarla 10 dakika içinde yapılabilecek en fazla istek sayısı. Bu sınır aşıldığında istekler bir süre reddedilir. Sayacın nasıl sıfırlandığı REST API sayfasında anlatılır.
• Son İstek Zamanı: Anahtarla yapılan son isteğin zamanı.

SystemAdmin hesaplarına ait anahtarlar yalnızca SystemAdmin hesabıyla giriş yapıldığında listelenir ve değiştirilebilir.

Anahtar ekleme

Tablonun üstündeki + butonuna tıklandığında Api Anahtarı Tanımlama penceresi açılır. Pencerede şu alanlar doldurulur:

• Kullanıcı Adı: Anahtarın sahibi olacak kullanıcı. Kayıttan sonra değiştirilemez.
• Anahtar adı: Anahtarı tanımlayan ad, en fazla 100 karakter. Aynı kullanıcının iki anahtarı aynı adı taşıyamaz.
• Amaç: SCADA API veya MCP erişimi. Varsayılan değer MCP erişimi'dir; REST API için SCADA API seçilmelidir. Kayıttan sonra değiştirilemez.
• Maksimum İstek Sayısı: 10 dakika içinde yapılabilecek en fazla istek sayısı. Varsayılan değer 300'dür.

Kaydet butonuna tıklandığında API anahtarı oluşturuldu penceresi açılır ve anahtar gösterilir. Anahtar yalnızca bu pencerede, bir kez gösterilir. Kopyala butonuyla kopyalanıp güvenli bir yerde saklanmalı, ardından Kaydettim, kapat butonuna tıklanmalıdır. Anahtar daha sonra tekrar görüntülenemez; kaybedilirse yeni bir anahtar oluşturulur.

Düzenleme ve silme

Her satırın sağındaki kalem simgesiyle anahtarın Anahtar adı ve Maksimum İstek Sayısı değiştirilebilir. Kullanıcı ve amaç değiştirilemez.

Çöp kutusu simgesiyle anahtar silinir. Silinen anahtarla yapılan istekler hemen reddedilir; bu işlem geri alınamaz.

Tablonun üstündeki Ara kutusuyla ve sütun başlıklarının altındaki filtre satırıyla anahtarlar süzülür; liste Excel'e aktarılabilir ve yenile butonuyla yeniden yüklenebilir.