Güvenlik Duvarı Kurallarını Yönet (Oluştur/Sil)

Belirli bir hizmete ve IP adresine yeni bir güvenlik duvarı kuralı eklemek veya mevcut bir kuralı silmek için bu endpointleri kullanın.

Bu sayfa, belirli bir hizmetinize (service) ve bu hizmete bağlı bir IP adresine güvenlik duvarı (firewall) kuralları eklemenize veya mevcut kuralları silmenize olanak tanıyan endpointleri açıklar.

Yeni Güvenlik Duvarı Kuralı Oluştur (POST)

Belirli bir hizmetinize (service) ve bu hizmete bağlı bir IP adresine yeni bir güvenlik duvarı (firewall) kuralı tanımlamak için aşağıdaki bilgileri kullanabilirsiniz.

Endpoint Bilgileri (POST)

POST Kural Oluşturma:

HTTP Methodu: POST

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

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

  • {SERVICE_ID} (Path Parametresi): Kural eklenecek güvenlik duvarının ilişkili olduğu hizmetin benzersiz kimliğidir.
  • {IP_ADDRESS} (Path Parametresi): Kuralın uygulanacağı, 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 - POST)

Bu endpoint POST metodu ile çalıştığı için bir Request Body gönderilmesi gereklidir. Body, JSON formatında olmalı ve oluşturulacak kuralın detaylarını içermelidir.

  • Content-Type: application/json

Request Body Yapısı (POST):

{
  "appId": integer, 
  "port": string 
}
  • appId (integer, zorunlu): Kuralın uygulanacağı uygulama veya protokolü tanımlayan ID. (Geçerli ID'ler için /api/services/{SERVICE_ID}/firewall/apps endpointini sorgulayabilirsiniz - varsayım, bu endpoint varsa belirtin).
  • port (string, zorunlu): Kuralın uygulanacağı port veya port aralığı.
    • Tek port için: "80", "443", "22"
    • Port aralığı için: "1000-2000" (API destekliyorsa)

Örnek İstek (cURL - POST)

Aşağıdaki komut ile yeni bir kural oluşturabilirsiniz:

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 kural eklenecek IP adresini girin.
# YOUR_APP_ID kısmına geçerli bir uygulama/protokol ID'si girin.
# YOUR_PORT_OR_RANGE kısmına hedef portu veya aralığı girin (örn: "80", "1000-2000").

curl --request POST \\
     --url "https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/rules" \\
     --header 'Authorization: PAT YOUR_PERSONAL_ACCESS_TOKEN' \\
     --header 'Content-Type: application/json' \\
     --data '{
       "appId": YOUR_APP_ID,
       "port": "YOUR_PORT_OR_RANGE" 
     }'

Bu isteği başarıyla gönderdiğinizde, sunucu genellikle yeni oluşturulan kuralın detaylarını veya başarı onayını içeren bir yanıt (örneğin 201 Created) dönecektir.

Mevcut Güvenlik Duvarı Kuralını Sil (DELETE)

Belirli bir hizmetinize (service) ve IP adresine atanmış olan spesifik bir güvenlik duvarı kuralını ID'sini kullanarak silmek için aşağıdaki bilgileri kullanabilirsiniz.

Endpoint Bilgileri (DELETE)

DELETE Kural Silme:

HTTP Methodu: DELETE

URL Yolu: /api/services/{SERVICE_ID}/firewall/{IP_ADDRESS}/rules/{RULE_ID}

Tam URL (Örnek): https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/rules/YOUR_RULE_ID

  • {SERVICE_ID} (Path Parametresi): Kuralı silinecek güvenlik duvarının ilişkili olduğu hizmetin benzersiz kimliğidir.
  • {IP_ADDRESS} (Path Parametresi): Kuralın ilişkili olduğu, belirtilen hizmete ait IP adresidir.
  • {RULE_ID} (Path Parametresi): Silinmek istenen güvenlik duvarı kuralının benzersiz kimliğidir. Bu ID'yi genellikle kural listeleme (/api/services/{SERVICE_ID}/firewall/{IP_ADDRESS}/rules - GET) endpoint'inden öğrenebilirsiniz.

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 - DELETE)

Bu endpoint DELETE metodu ile çalıştığı için bir Request Body göndermenize gerek yoktur.

Örnek İstek (cURL - DELETE)

Aşağıdaki komut ile kendi token'ınızı, API adresinizi, ilgili hizmetin SERVICE_ID'sini, hedef IP_ADDRESS'i ve silmek istediğiniz kuralın RULE_ID'sini kullanarak kuralı silebilirsiniz:

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 kuralın ilişkili olduğu IP adresini girin.
# YOUR_RULE_ID kısmına silinecek kuralın ID'sini girin.

curl --request DELETE \\
     --url "https://nodesty.com/api/services/YOUR_SERVICE_ID/firewall/TARGET_IP_ADDRESS/rules/YOUR_RULE_ID" \\
     --header 'Authorization: PAT YOUR_PERSONAL_ACCESS_TOKEN'

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/RULE_ID) uygun bir HTTP hata kodu alırsınız.