URL path'ini backend'e gitmeden önce yeniden yazabilir miyim (rewrite)?

Kısa cevap

Evet. Set Path aksiyonu isteğin yolunu Kurum Servisine iletmeden önce değiştirir; istemci yönlendirilmez, adres çubuğu değişmez ve istek işlenmeye devam eder. Önek ekleme ya da kaldırma, sonek ve bul-değiştir işlemleri Path Operation Shortcuts ile hazırlanır; New Path Info alanı Smart Variable ve fonksiyonlarla elle de yazılabilir. Sorgu dizesi de değişecekse Set Path + Query, yolu standart biçime getirmek için URL Normalization kullanılır. Path koşulları ve TR7 logları yolun yeniden yazılmadan önceki hâlini görür.

Sorun: Dışarıdaki Adres ile Uygulamanın Beklediği Yol Farklı

Kullanıcılara /api/v1/... gibi bir adres sunulurken uygulama /v1/... bekleyebilir ya da eski bir uygulama farklı bir yol yapısıyla çalışabilir. Kullanıcının gördüğü adres değişmeden, isteğin Kurum Servisine uygulamanın beklediği yolla gitmesi gerekir.

Çözüm: Beş Yöntem

Yöntemlerin hepsi yalnızca HTTP vService'te ve istek aşamasında çalışır. Yeniden yazma işlemleri isteği sonlandırmaz; Actions listesinde kendisinden sonra gelen aksiyonlar ve Kurum Servisi seçimi çalışmaya devam eder. Path koşulları (Conditional Backend Services dahil) yolun özgün hâlini değerlendirdiği için /api/ koşuluyla ayrı sunuculara gönderilen istekte önek kaldırılsa da sunucu seçimi bozulmaz.

Durumunuz	Uygun yöntem
Önek/sonek ekleme-kaldırma, bul-değiştir	Yöntem 1: Set Path + Path Operation Shortcuts
Kısayollarla hazırlanamayan özel bir yol	Yöntem 2: New Path Info'yu elle yazmak
Yol ile birlikte sorgu dizesi de değişecek	Yöntem 3: Set Path + Query
Yinelenen eğik çizgi, ./.. bölümleri gibi yazım farkları	Yöntem 4: URL normalization
Komut satırından	Yöntem 5: WEB-CLI

Yöntem 1: Set Path + Path Operation Shortcuts Önerilen

• Nasıl çalışır Kısayol penceresine girilen değer New Path Info ifadesine dönüştürülür; ör. Remove prefix /api → %PATH.STRREPLACE(^/api,).
• Nerede açılırLoad Balancer → Actions → Set Path → Path Operation Shortcuts
• Gereksinim Yolu değişecek istekleri ayıran bir koşul (koşulsuz Set Path bütün isteklere uygulanır)
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Koşul formunu aç

Load Balancer → Conditions → Add tıklanır (nasıl eklenir).

2

Adım 2 Path koşulunu tanımla

Criteria = Path, eşleştirme Start, değer /api/ girilir. Değerin sondaki / ile yazılması /api ve /apiv2/… gibi isteklerin yanlışlıkla kırpılmasını önler (aşağıdaki tablo).

3

Adım 3 Koşulu kaydet

Add tıklanır.

4

Adım 4 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır (nasıl eklenir).

5

Adım 5 Aksiyonu tanımla

Action Name girilir, Action Type = Set Path seçilir.

6

Adım 6 Kısayolu uygula

Path Operation Shortcuts satırında Remove prefix tıklanır; açılan pencerede Prefix to remove = /api girilip onaylanır. Kısayol New Path Info alanını doldurur. Diğer kısayollar: Add prefix (varsayılan değer /api), Add suffix / Remove suffix (varsayılan .html), Find & replace (varsayılan /old → /new, bütün geçişleri değiştirir).

7

Adım 7 Koşulu seç

Conditions alanında 2. adımdaki koşul seçilir. Değişikliğin uygulandığını saymak için Hit Counter açılır (varsayılan kapalı).

8

Adım 8 Aksiyonu kaydet

Add tıklanır.

9

Adım 9 vService'i düzenle

Load Balancer → Load Balancer vService List ekranında HTTP vService seçilip Edit tıklanır.

10

Adım 10 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

11

Adım 11 Kaydet

Save tıklanır. Değişiklik açık bağlantılar kopmadan uygulanır; cluster'da varsayılan auto-sync ile eş cihaza da gönderilir (Manual Sync Mode açıksa Synchronize ile).

Remove prefix /api ifadesinin (%PATH.STRREPLACE(^/api,)) örnek isteklerdeki sonucu:

İstek yolu	Path Start /api/ koşulu	Kurum Servisine giden yol
/api/v1/users	Uyar	/v1/users
/api/	Uyar	/
/api	Uymaz	/api (değişmez)
/apiv2/x	Uymaz	/apiv2/x (değişmez; koşul olmasaydı v2/x olurdu)
/v1/api/x	Uymaz	/v1/api/x (^ yalnızca baştaki öneki hedefler)

Sorgu dizesi Set Path'te korunur: /api/v1/users?page=2 isteği /v1/users?page=2 olarak gider.

Doğrulama

1Erişim loguKurum Servisi tarafı

curl -s https://www.example.com/api/v1/users gönderilir; Kurum Servisinin erişim logunda isteğin ulaştığı yola bakılır.

BeklenenGET /v1/users

2SayımTR7 tarafı

Hit Counter açıksa vService panosunun Action Hits sekmesinde aksiyonun sayısı artar. HTTP Logs istemcinin gönderdiği özgün adresi (/api/v1/users) gösterir.

BeklenenSayı artar · logda özgün yol

Yöntem 2: New Path Info'yu Elle Yazmak

• Nasıl çalışır Sabit metin, Smart Variable'lar ve fonksiyonlar birleştirilerek istenen yol oluşturulur; ör. /v2 + Path/page of the request [URI].
• Nerede açılırLoad Balancer → Actions → Set Path → New Path Info
• Gereksinim Sonuç yolun / ile başlaması (form bunu denetlemez)
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır.

2

Adım 2 Aksiyon tipini seç

Action Type = Set Path seçilir.

3

Adım 3 Yolu yaz

New Path Info alanı /prefix + Path/page of the request [URI] değişkeniyle dolu gelir. /prefix yerine /v2 yazılır; gerekiyorsa fx ile başka değişkenler ve fonksiyonlar eklenir. Sonuç / ile başlamalıdır.

4

Adım 4 Koşulu seç

Conditions alanında koşul seçilir.

5

Adım 5 Aksiyonu kaydet

Add tıklanır.

6

Adım 6 vService'i düzenle

vService Edit ile açılır.

7

Adım 7 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

8

Adım 8 Kaydet

Save tıklanır.

Doğrulama

1Erişim loguKurum Servisi tarafı

curl -s https://www.example.com/rapor/2024

BeklenenGET /v2/rapor/2024

Yöntem 3: Set Path + Query

• Nasıl çalışır Yol ve sorgu dizesi birlikte yeniden yazılır; özgün sorgu ancak Request query değişkeni ifadeye eklenirse korunur.
• Nerede açılırLoad Balancer → Actions → Set Path + Query
• Gereksinim Yok
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır.

2

Adım 2 Aksiyonu tanımla

Action Type = Set Path + Query seçilir.

3

Adım 3 Yolu ve sorguyu yaz

New Path Info alanına yol ve sorgu birlikte yazılır; kısayollar bu tipte ifadenin sonuna Request query değişkenini kendiliğinden ekler. Ayrıntılı karşılaştırma: Set Path ile Set Path + Query arasındaki fark nedir?

4

Adım 4 Koşulu seç

Conditions alanında koşul seçilir.

5

Adım 5 Aksiyonu kaydet

Add tıklanır.

6

Adım 6 vService'i düzenle

vService Edit ile açılır.

7

Adım 7 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

8

Adım 8 Kaydet

Save tıklanır.

Doğrulama

1Erişim loguKurum Servisi tarafı

Kurum Servisinin erişim logunda yol ve sorgu birlikte görülür.

BeklenenYeniden yazılmış yol ve sorgu

Yöntem 4: URL Normalization

• Nasıl çalışır Yol standart biçime getirilir: yinelenen eğik çizgiler birleştirilir, . ve .. bölümleri çözülür, ayrılmamış karakterlerin yüzde kodlaması açılır, sorgu parametreleri ada göre sıralanabilir.
• Nerede açılırLoad Balancer → Actions → URL Normalization
• Gereksinim En az bir seçenek işaretlenir
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır.

2

Adım 2 Aksiyonu tanımla

Action Type = URL Normalization seçilir.

3

Adım 3 Seçenekleri işaretle

Normalization listesinden ihtiyaç duyulanlar işaretlenir: Merge slash characters, Re-evaluate path in accordance with one dot (.), Re-evaluate path in accordance with two dot (..), Decode percent-encoded characters, Make percent-encoded characters uppercase, Sort query parameters by name ve diğerleri.

4

Adım 4 Aksiyonu kaydet

Add tıklanır.

5

Adım 5 vService'i düzenle

vService Edit ile açılır.

6

Adım 6 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

7

Adım 7 Kaydet

Save tıklanır.

Doğrulama

1Erişim loguKurum Servisi tarafı

curl -s --path-as-is "https://www.example.com//urun//5"

BeklenenMerge slash characters işaretliyse GET /urun/5

Yöntem 5: WEB-CLI

• Nasıl çalışır Yöntem 1'deki koşul ve Remove prefix ifadesi WEB-CLI komutlarıyla oluşturulur; newPath değeri arayüzdeki kısayolun ürettiği ifadeyle aynıdır.
• Nerede açılır TR7 WEB-CLI → lb condition · lb action · lb service
• Gereksinim WEB-CLI erişimi; koşulun kimliği (ID)
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Koşulu ekle

lb condition add criteria path query /api/ --content_placement start --name api-yolu

2

Adım 2 Koşulun kimliğini al

Aksiyon koşulu adıyla değil kimliğiyle bağlar. lb condition add başarılı olunca çıktı vermez; kimlik, koşul listesinin id sütununda görülür:

lb condition list

3

Adım 3 Set Path aksiyonunu ekle

lb action add type set_path name api-kirp newPath "%PATH.STRREPLACE(^/api,)" --cond <koşul-kimliği>

4

Adım 4 vService'teki mevcut aksiyonlara bak

lb service show <vService>

Çıktıdaki rules.0, rules.1 … satırları vService'teki aksiyonları sırasıyla gösterir. --rules.N o sıradaki aksiyonun yerine geçer; yeni aksiyon ilk boş sıraya yazılır.

5

Adım 5 Aksiyonu vService'e ekle

vService'te iki aksiyon (0 ve 1) varsa yeni aksiyon 2. sıraya yazılır; hiç aksiyon yoksa --rules.0 kullanılır:

lb service update id <vService> --rules.2 api-kirp

Doğrulama

1Erişim loguKurum Servisi tarafı

curl -s https://www.example.com/api/v1/users

BeklenenGET /v1/users

Sık Yapılan Hatalar

• Set Path'in istemciyi yönlendirdiğini sanmak. Yol yalnızca Kurum Servisine giden istekte değişir; istemcinin adresi değişmez. Kullanıcıyı başka adrese göndermek için Location Redirection kullanılır (Belirli bir URL'yi başka bir URL'ye 301/302 ile nasıl yönlendiririm?).
• Koşulsuz Set Path eklemek. Koşul boşsa bütün isteklerin yolu değişir; Remove prefix gibi ifadeler önekin bulunmadığı yolları da bozabilir.
• Koşulu /api olarak yazmak. Start /api koşulu /apiv2/x isteğini de yakalar ve yol v2/x olur; koşul sondaki / ile yazılır.
• Yeniden yazılan yola göre koşul beklemek. Path koşulları, aynı vService'teki sonraki aksiyonlarda ve Conditional Backend Services'te de yolun özgün hâlini değerlendirir.
• Doğrulamayı TR7 loglarında aramak. HTTP Logs istemcinin gönderdiği adresi gösterir; yeniden yazılmış yol Kurum Servisinin logunda görülür.
• Kurum Servisinin döndürdüğü yönlendirmeleri unutmak. Sunucu yeni yola göre Location başlığı üretiyorsa (ör. /v1/login), başlık On Response'ta Replace HTTP Header Content ile düzeltilir (Header değerini regex ile değiştirebilir miyim?).

Dokümantasyonda nasıl yapılır

• Set Path · Yönlendirme değil yeniden yazma
• Set Path · Path Operation Shortcuts
• Set Path · New Path Info
• URL Normalization · Normalization

İlgili sorular

• Set Path ile Set Path + Query arasındaki fark nedir?
• Belirli bir URL'yi başka bir URL'ye 301/302 ile nasıl yönlendiririm?
• URL path'ine göre farklı sunuculara nasıl yönlendiririm (ör. /api → API sunucuları)?