EOL çok kiracılı düğümün yükseltilmesi¶

Bu talimatlar, kullanımdan kaldırılmış (EOL) çok kiracılı düğümü (3.6 ve altı sürümler) en son 6.x sürümüne yükseltme adımlarını açıklar.

Gereksinimler¶

• teknik kiracı hesabı altında eklenmiş Global administrator rolüne sahip kullanıcı tarafından ilerleyen komutların yürütülmesi

• US Wallarm Cloud ile çalışıyorsanız https://us1.api.wallarm.com adresine veya EU Wallarm Cloud ile çalışıyorsanız https://api.wallarm.com adresine erişim. Lütfen bu erişimin güvenlik duvarı tarafından engellenmediğinden emin olun

• Saldırı tespit kuralları ve API spesifikasyonlarının güncellemelerini indirmek, ayrıca izinli (allowlisted), yasaklı (denylisted) veya gri listeye alınmış (graylisted) ülkeleriniz, bölgeleriniz veya veri merkezleriniz için kesin IP’leri almak amacıyla aşağıdaki IP adreslerine erişim.

  US CloudEU Cloud

  node-data0.us1.wallarm.com - 34.96.64.17
  node-data1.us1.wallarm.com - 34.110.183.149
  us1.api.wallarm.com - 35.235.66.155
  34.102.90.100
  34.94.156.115
  35.235.115.105
  

  node-data1.eu1.wallarm.com - 34.160.38.183
  node-data0.eu1.wallarm.com - 34.144.227.90
  api.wallarm.com - 34.90.110.226
  

Adım 1: Wallarm destek ekibiyle iletişime geçin¶

Çok kiracılı düğüm yükseltmesi sırasında özel kurallar kümesi oluşturma özelliğinin en son sürümünü almak için Wallarm destek ekibi yardımı talep edin.

Destek ekibi ayrıca çok kiracılı düğüm yükseltmesi ve gerekli yeniden yapılandırmayla ilgili tüm sorularınızı yanıtlamanıza yardımcı olacaktır.

Adım 2: Standart yükseltme prosedürünü izleyin¶

Standart prosedürler şunlardır:

• Wallarm NGINX modüllerini yükseltme

• Postanalytics modülünü yükseltme

• Wallarm Docker NGINX tabanlı imajını yükseltme

• Wallarm modülleri entegre NGINX Ingress controller’ı yükseltme

• Bulut düğüm imajını yükseltme

Adım 3: Çok kiracılı yapıyı yeniden yapılandırın¶

Trafiğin kiracılarınız ve onların uygulamalarıyla nasıl ilişkilendirildiğine dair yapılandırmayı yeniden yazın. Aşağıdaki örneği dikkate alın. Örnekte:

• Kiracı, iş ortağının müşterisini ifade eder. İş ortağının iki müşterisi vardır.

• tenant1.com ve tenant1-1.com hedefli trafik 1. müşteriyle ilişkilendirilmelidir.

• tenant2.com hedefli trafik 2. müşteriyle ilişkilendirilmelidir.

• 1. müşterinin ayrıca üç uygulaması vardır:
  2. tenant1.com/login
  3. tenant1.com/users
  4. tenant1-1.com

  Bu 3 yola hedeflenen trafik ilgili uygulama ile ilişkilendirilmeli; geri kalanlar 1. müşterinin genel trafiği olarak kabul edilmelidir.

Önceki sürüm yapılandırmanızı inceleyin¶

3.6’da bu şu şekilde yapılandırılabilir:

server {
  server_name  tenant1.com;
  wallarm_application 20;
  ...
  location /login {
     wallarm_application 21;
     ...
  }
  location /users {
     wallarm_application 22;
     ...
  }

server {
  server_name  tenant1-1.com;
  wallarm_application 23;
  ...
}

server {
  server_name  tenant2.com;
  wallarm_application 24;
  ...
}
...
}

Yukarıdaki yapılandırmaya ilişkin notlar:

• tenant1.com ve tenant1-1.com hedefli trafik, bu müşteriyle /v2/partner/111/partner_client API isteği üzerinden ilişkilendirilen 20 ve 23 değerleri aracılığıyla 1. müşteriyle ilişkilendirilir.

• Diğer uygulamaları kiracılarla ilişkilendirmek için benzer API istekleri gönderilmiş olmalıdır.

• Kiracılar ve uygulamalar ayrı varlıklardır, bu nedenle bunları farklı yönergelerle (directive) yapılandırmak mantıklıdır. Ayrıca ek API isteklerinden kaçınmak da kullanışlı olacaktır. Kiracılar ve uygulamalar arasındaki ilişkileri doğrudan yapılandırma üzerinden tanımlamak mantıklıdır. Tüm bunlar mevcut yapılandırmada eksiktir ancak aşağıda açıklanan yeni 6.x yaklaşımıyla mümkün hale gelecektir.

6.x yaklaşımını inceleyin¶

6.x sürümünde, düğüm yapılandırmasında kiracıyı tanımlamanın yolu UUID kullanmaktır.

Yapılandırmayı yeniden yazmak için şunları yapın:

1. Kiracılarınıza ait UUID’leri alın.

2. Kiracıları dahil edin ve NGINX yapılandırma dosyasında uygulamalarını ayarlayın.

Kiracılarınıza ait UUID’leri alın¶

Kiracı listesini almak için Wallarm API’ye kimlik doğrulamalı istekler gönderin. Kimlik doğrulama yaklaşımı, kiracı oluşturma için kullanılan yöntemle aynıdır.

1. İlgili UUID’leri daha sonra bulmak için clientid(leri) alın:

   Wallarm Console üzerindenAPI’ye istek göndererek

   clientid(leri) Wallarm Console kullanıcı arayüzündeki ID sütunundan kopyalayın:

   

   1. /v2/partner_client rotasına GET isteği gönderin:

      Kendi istemcinizden gönderilen istek örneği

      US CloudEU Cloud

      curl -X GET \
      'https://us1.api.wallarm.com/v2/partner_client?partnerid=PARTNER_ID' \
      -H 'accept: application/json' \
      -H "X-WallarmApi-Token: <YOUR_TOKEN>"
      

      curl -X GET \
      'https://api.wallarm.com/v2/partner_client?partnerid=PARTNER_ID' \
      -H 'accept: application/json' \
      -H "X-WallarmApi-Token: <YOUR_TOKEN>"
      

      Burada PARTNER_ID, kiracı oluşturma prosedürünün Adım 2 aşamasında elde edilendir.

      Yanıt örneği:

      {
      "body": [
          {
              "id": 1,
              "partnerid": <PARTNER_ID>,
              "clientid": <CLIENT_1_ID>,
              "params": null
          },
          {
              "id": 3,
              "partnerid": <PARTNER_ID>,
              "clientid": <CLIENT_2_ID>,
              "params": null
          }
      ]
      }
      

   2. clientid(leri) yanıttan kopyalayın.

2. Her kiracının UUID’sini almak için v1/objects/client rotasına POST isteği gönderin:

   Kendi istemcinizden gönderilen istek örneği

   US CloudEU Cloud

   curl -X POST \
   https://us1.api.wallarm.com/v1/objects/client \
   -H 'content-type: application/json' \
   -H 'X-WallarmApi-Token: <YOUR_TOKEN>' \
   -d '{ "filter": { "id": [<CLIENT_1_ID>, <CLIENT_2_ID>]}}'
   

   curl -X POST \
   https://api.wallarm.com/v1/objects/client \
   -H 'content-type: application/json' \
   -H 'X-WallarmApi-Token: <YOUR_TOKEN>' \
   -d '{ "filter": { "id": [<CLIENT_1_ID>, <CLIENT_2_ID>]}}'
   

   Yanıt örneği:

   {
   "status": 200,
   "body": [
       {
           "id": <CLIENT_1_ID>,
           "name": "<CLIENT_1_NAME>",
           ...
           "uuid": "11111111-1111-1111-1111-111111111111",
           ...
       },
       {
           "id": <CLIENT_2_ID>,
           "name": "<CLIENT_2_NAME>",
           ...
           "uuid": "22222222-2222-2222-2222-222222222222",
           ...
       }
   ]
   }
   

3. Yanıttan uuid(leri) kopyalayın.

NGINX yapılandırma dosyasında kiracıları dahil edin ve uygulamalarını ayarlayın¶

NGINX yapılandırma dosyasında:

1. Yukarıda aldığınız kiracı UUID’lerini wallarm_partner_client_uuid yönergelerinde belirtin.

2. Korumalı uygulama kimliklerini wallarm_application yönergelerinde ayarlayın.

   Düğüm 3.6 veya daha düşük sürüm için kullanılan NGINX yapılandırması uygulama yapılandırmasını içeriyorsa, yalnızca kiracı UUID’lerini belirtin ve uygulama yapılandırmasını olduğu gibi bırakın.

Örnek:

server {
  server_name  tenant1.com;
  wallarm_partner_client_uuid 11111111-1111-1111-1111-111111111111;
  ...
  location /login {
     wallarm_application 21;
     ...
  }
  location /users {
     wallarm_application 22;
     ...
  }

server {
  server_name  tenant1-1.com;
  wallarm_partner_client_uuid 11111111-1111-1111-1111-111111111111;
  wallarm_application 23;
  ...
}

server {
  server_name  tenant2.com;
  wallarm_partner_client_uuid 22222222-2222-2222-2222-222222222222;
  ...
}
...
}

Yukarıdaki yapılandırmada:

• Kiracılar ve uygulamalar farklı yönergelerle yapılandırılmıştır.

• Kiracılar ve uygulamalar arasındaki ilişkiler, NGINX yapılandırma dosyasının ilgili bloklarındaki wallarm_application yönergeleri aracılığıyla tanımlanmıştır.

Adım 4: Wallarm çok kiracılı düğümün çalışmasını test edin¶

1. Send the request with test Path Traversal attack to a protected resource address:

   curl http://localhost/etc/passwd
   

   If traffic is configured to be proxied to example.com, include the -H "Host: example.com" header in the request.

2. Open Wallarm Console → Attacks section in the US Cloud or EU Cloud and make sure the attack is displayed in the list.

   

3. Optionally, test other aspects of the node functioning.

Was this page helpful?

How can we improve this article? (Optional)

Information is unclear or confusing

Insufficient information

Outdated or incorrect information

0/240

Send