Güvenlik Duvarı Saldırı İstatistikleri

Belirli bir hizmete ve IP adresine ait güvenlik duvarı tarafından algılanan saldırı istatistiklerini belirli bir zaman aralığı için görüntülemek üzere bu endpointi kullanın.

Belirli bir hizmetinize (service) ve bu hizmete bağlı bir IP adresine yönelik, son birkaç saatteki güvenlik duvarı (firewall) saldırı istatistiklerini sorgulamak için aşağıdaki bilgileri kullanabilirsiniz.

Endpoint Bilgileri

Note:

HTTP Methodu: GET

URL Yolu: /api/services/{SERVICE_ID}/firewall/{IP_ADDRESS}/stats

Tam URL (Örnek): https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/stats?hours=3

  • {SERVICE_ID} (Path Parametresi): İstatistikleri alınacak güvenlik duvarının ilişkili olduğu hizmetin benzersiz kimliğidir.
  • {IP_ADDRESS} (Path Parametresi): İstatistikleri görüntülenecek olan, belirtilen hizmete ait IP adresidir (IPv4 veya IPv6 formatında).

Query Parametreleri

  • hours (integer, zorunlu): Ne kadar geriye dönük istatistiklerin alınacağını saat cinsinden belirtir.
    • Alabileceği Değerler: 1, 2 veya 3. Maksimum 3 saatlik veri alınabilir.

Kimlik Doğrulama (Authentication)

Bu isteği yapabilmek için Authorization başlığını (Header) kullanmanız gerekmektedir.

  • Header Adı: Authorization
  • Değer Formatı: PAT <TOKEN>

<TOKEN> kısmını size özel Nodesty Kişisel Erişim Token'ınız (Personal Access Token) ile değiştirin. Token'ınızı Müşteri Paneli'nden alabilirsiniz.

İstek (Request)

Bu endpoint GET metodu ile çalıştığı için bir Request Body göndermenize gerek yoktur. Gerekli tüm bilgiler URL yolu ve query parametreleri ile sağlanır.

Örnek İstek (cURL)

Aşağıdaki komut ile kendi token'ınızı, API adresinizi, ilgili hizmetin SERVICE_ID'sini, hedef IP_ADDRESS'i ve istediğiniz hours değerini kullanarak saldırı istatistiklerini alabilirsiniz (örnekte son 3 saatlik veri istenmiştir):

request.bash
# YOUR_PERSONAL_ACCESS_TOKEN kısmını kendi tokenınız ile değiştirin.
# https://nodesty.com kısmını API'nizin adresi ile değiştirin.
# YOUR_SERVICE_ID kısmını ilgili hizmetin ID'si ile değiştirin.
# TARGET_IP_ADDRESS kısmına istatistiği alınacak IP adresini girin.
# hours parametresini 1, 2 veya 3 olarak ayarlayın.

curl --request GET \\
     --url "https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/stats?hours=3" \\
     --header 'Authorization: PAT YOUR_PERSONAL_ACCESS_TOKEN' \\
     --header 'Accept: application/json'

Bu isteği başarıyla gönderdiğinizde, sunucu size belirtilen IP adresi için istenen zaman aralığındaki saldırı istatistiklerini içeren bir yanıt dönecektir. Hatalı durumlarda (örneğin geçersiz token, bulunamayan SERVICE_ID/IP_ADDRESS veya geçersiz hours değeri) uygun bir HTTP hata kodu alırsınız.