Saldırı Bildirim Ayarlarını Güncelle

Belirli bir hizmete ve IP adresine ait güvenlik duvarı saldırı bildirim ayarlarını (Discord webhook, E-posta aktivasyonu) ayarlamak veya güncellemek için bu endpointi kullanın.

Belirli bir hizmetinize (service) ve bu hizmete bağlı bir IP adresine yönelik güvenlik duvarı (firewall) saldırı bildirim ayarlarını (Discord webhook URL'si, e-posta bildirim durumu) yapılandırmak veya mevcut ayarları değiştirmek için aşağıdaki bilgileri kullanabilirsiniz.

Endpoint Bilgileri

Note:

HTTP Methodu: PUT

URL Yolu: /api/services/{SERVICE_ID}/firewall/{IP_ADDRESS}/attack-notification

Tam URL (Örnek): https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/attack-notification

  • {SERVICE_ID} (Path Parametresi): Bildirim ayarları güncellenecek güvenlik duvarının ilişkili olduğu hizmetin benzersiz kimliğidir.
  • {IP_ADDRESS} (Path Parametresi): Bildirim ayarları güncellenecek olan, belirtilen hizmete ait IP adresidir (IPv4 veya IPv6 formatında).

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 PUT metodu ile çalıştığı için bir Request Body gönderilmesi gereklidir. Body, JSON formatında olmalı ve güncellenmek istenen bildirim ayarlarını içermelidir. Gönderilmeyen alanlar genellikle mevcut ayarlarını korur.

  • Content-Type: application/json

Request Body Yapısı:

{
  "emailNotification": boolean, 
  "discordWebhookURL": "string (URL formatında)" 
}
  • emailNotification (boolean, opsiyonel): E-posta ile saldırı bildirimlerinin aktif olup olmayacağını belirtir (true aktif, false pasif). Gönderilmezse, mevcut ayar değişmez.
  • discordWebhookURL (string, opsiyonel): Saldırı bildirimlerinin gönderileceği Discord webhook URL'si. Geçerli bir URL formatında olmalıdır. Bildirimleri kapatmak veya ayarlamamak için null veya boş string gönderebilirsiniz (API tasarımına bağlıdır) ya da bu alanı istekten tamamen çıkarabilirsiniz. Gönderilmezse, mevcut ayar değişmez.

Örnek İstek (cURL)

Aşağıdaki komut ile kendi token'ınızı, API adresinizi, ilgili hizmetin SERVICE_ID'sini, hedef IP_ADDRESS'i ve güncellemek istediğiniz bildirim ayarlarını kullanarak işlemi gerçekleştirebilirsiniz (örnekte hem e-posta aktif ediliyor hem de webhook URL'si ayarlanıyor):

request.bash
# YOUR_PERSONAL_ACCESS_TOKEN kısmını kendi tokenınız ile değiştirin.
# YOUR_SERVICE_ID kısmını ilgili hizmetin ID'si ile değiştirin.
# TARGET_IP_ADDRESS kısmına bildirim ayarları güncellenecek IP adresini girin.
# YOUR_DISCORD_WEBHOOK_URL kısmına geçerli webhook URL'sini girin.

curl --request PUT \\
     --url "https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/attack-notification" \\
     --header 'Authorization: PAT YOUR_PERSONAL_ACCESS_TOKEN' \\
     --header 'Content-Type: application/json' \\
     --data '{
       "emailNotification": true, 
       "discordWebhookURL": "YOUR_DISCORD_WEBHOOK_URL" 
     }'

Sadece Discord Webhook'u ayarlamak için:

request.bash
curl --request PUT \\
     --url "https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/attack-notification" \\
     --header 'Authorization: PAT YOUR_PERSONAL_ACCESS_TOKEN' \\
     --header 'Content-Type: application/json' \\
     --data '{
       "discordWebhookURL": "YOUR_DISCORD_WEBHOOK_URL" 
     }'

Sadece E-posta bildirimini kapatmak için:

request.bash
curl --request PUT \\
     --url "https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/attack-notification" \\
     --header 'Authorization: PAT YOUR_PERSONAL_ACCESS_TOKEN' \\
     --header 'Content-Type: application/json' \\
     --data '{
       "emailNotification": false
     }'

Bu isteği başarıyla gönderdiğinizde, sunucu genellikle işlemin başarılı olduğunu belirten bir yanıt (örneğin 200 OK veya 204 No Content) dönecektir. Hatalı durumlarda (örneğin geçersiz token, bulunamayan SERVICE_ID/IP_ADDRESS veya geçersiz webhook URL formatı) uygun bir HTTP hata kodu alırsınız.