jezahost
· yenilənib: 15 noyabr 2026
  • debugging
  • nginx
  • cdn
  • tls

Dörd düzgün qərar, bir işləməyən link

İmzalı təsdiq linki yalnız girişdən sonra 403 qaytarırdı, başqa heç yerdə yox. CDN, nginx, freymvork və tətbiq hər biri ayrılıqda düzgün qurulmuşdu. Birlikdə isə yox.

Bu, qısa bir debugging hekayəsidir. Burada günahkar yoxdur. Hər komponent öz sənədlərinin tövsiyə etdiyi kimi qurulmuşdu, nəticə isə yenə də yalnız girişdən sonra üzə çıxan, işləməyən bir funksiya oldu.

Simptom

Müştəri portalımız imzalı linkləri olan e-poçtlar göndərir: URL-də bitmə vaxtı və HMAC olur, tətbiq isə nəsə etməzdən əvvəl hər ikisini yoxlayır. Bir müştəri belə linkə kliklədi, ondan giriş tələb olundu (gözlənilən haldır), daxil oldu və 403 Invalid signature aldı. Eyni link artıq daxil olunmuş brauzerdə açılanda da işləmədi. Bir neçə dəqiqə əvvəl yaradılmış linklər isə işləmişdi.

Zəncir

Dörd fakt, hər biri ayrılıqda qaydasındadır:

1. Portal CDN arxasındadır. CDN TLS-i sonlandırır və sorğunu özəl yolla bizim origin-ə ötürür. Adi başlıqları əlavə edir: müştərinin real IP-si və X-Forwarded-Proto: https.

2. nginx CDN-in real-IP başlığına etibar edəcək şəkildə qurulub. set_real_ip_from və real_ip_header: belə ki, loglar və rate limit-lər CDN-in deyil, müştərinin ünvanını görür. Standart yanaşmadır.

3. Tətbiqin etibarlı proxy siyahısı var. Əksər freymvorklar kimi o da X-Forwarded-* başlıqlarını yalnız etibar etdiyi proxy-lərdən qəbul edir, onları isə qoşulan IP-yə görə tanıyır. Düzgündür; əks halda hər kəs ötürülən protokolu saxtalaşdıra bilərdi.

4. İmzalı URL-lər sxemi də əhatə edir. İmza tam URL-i, yəni https://... hissəsini də əhatə edir. Bu da düzgündür; sxemi nəzərə almayan imza daha zəif olardı.

İndi bunları birləşdirək. nginx-in real-IP modulu REMOTE_ADDR-i tətbiq sorğunu görməzdən əvvəl müştərinin IP-si ilə əvəz edir. Tətbiq REMOTE_ADDR-in etibarlı proxy olub-olmadığını yoxlayır. Müştərinin IP-si etibarlı proxy deyil. Ona görə də tətbiq X-Forwarded-Proto-nu nəzərə almır. TLS CDN-də sonlandırılıb, buna görə tətbiqin gördüyü bağlantı adi HTTP-dir. Nəticədə tətbiq sorğunun URL-inin http://... olduğunu düşünür. İmzanı http://... üzərindən yenidən hesablayır, https://... üzərindən yaradılmış imza ilə müqayisə edir və onlar fərqlənir. 403.

Niyə yalnız girişdən sonra görünürdü

Autentifikasiya middleware-i imza middleware-indən əvvəl işləyirdi. Anonim klik əvvəlcə giriş səhifəsinə yönləndirilirdi; müştərinin ilk olaraq xəta yox, giriş forması görməsinin səbəbi də bu idi. Sorğu imza yoxlamasına yalnız uğurlu girişdən sonra çatır və orada uğursuz olurdu. Bu ardıcıllıq xətanı sessiya problemi kimi göstərdi və biz xeyli vaxt yanlış yerdə axtardıq.

Həll

Yenidən yazılmış ünvana yox, proxy-yə etibar edin. Konkret olaraq: tətbiqin etibarlı proxy konfiqurasiyası dəyişdirildi və o, özəl origin yolu ilə gələn sorğular üçün ötürülən başlıqları qəbul etməyə başladı, çünki bizim topologiyada origin-ə başqa heç nə çata bilmir. Ötürülən protokol nəzərə alınanda sorğunun URL-i yenidən https://... olur və imzalar yoxlamadan keçir. Bundan əlavə, bu marşrutlarda imza yoxlamasını autentifikasiyadan əvvələ keçirdik ki, etibarsız link giriş forması əvəzinə aydın mesajla dərhal xəta versin.

Dərs, əgər buna dərs demək olarsa

Dörd hissənin heç biri səhv deyildi. Hər biri sənədlərdə yazılan, tövsiyə olunan ayar idi. Nasazlıq onların qarşılıqlı təsirində idi, xüsusən də nginx-in real-IP əvəzləməsinin tətbiqin görmə sahəsindən kənarda baş verməsində. Növbəti komponentin etibar qərarları üçün istifadə etdiyi məlumatı dəyişən bir qat əlavə edəndə, həmin komponentin indi sorğu haqqında nə düşündüyünü yoxlayın. «Bunu kim göndərib» və «bu necə gəlib» iki fərqli sualdır və real-IP əvəzləməsindən sonra onlardan yalnız birinin cavabı əvvəlki kimi qalır.