jezahost
· განახლდა: 15 ნოემბერი, 2026
  • debugging
  • nginx
  • cdn
  • tls

ოთხი სწორი გადაწყვეტილება, ერთი გატეხილი ბმული

ხელმოწერილი დადასტურების ბმული 403-ს მხოლოდ შესვლის შემდეგ აბრუნებდა და სხვაგან არსად. CDN, nginx, ფრეიმვორკი და აპლიკაცია ცალ-ცალკე სწორად იყო მორგებული. ერთად კი არა.

ეს გამართვის მოკლე ისტორიაა. ბოროტმოქმედი მასში არ არის. ყოველი კომპონენტი ისე იყო მორგებული, როგორც მისი დოკუმენტაცია გვირჩევს, შედეგი კი მაინც გაუმართავი ფუნქცია აღმოჩნდა, რომელიც მხოლოდ შესვლის შემდეგ ჩანდა.

სიმპტომი

ჩვენი კლიენტების პორტალი აგზავნის წერილებს ხელმოწერილი ბმულებით: URL შეიცავს ვადის გასვლის დროს და HMAC-ს, აპლიკაცია კი მოქმედებამდე ორივეს ამოწმებს. კლიენტმა ასეთ ბმულზე დააწკაპუნა, სთხოვეს შესვლა (როგორც მოსალოდნელი იყო), შევიდა და მიიღო 403 Invalid signature. იგივე ბმული ბრაუზერში, სადაც შესვლა უკვე შესრულებული იყო, ასევე ვერ გაიხსნა. რამდენიმე წუთით ადრე შექმნილი ბმულები კი მუშაობდა.

ჯაჭვი

ოთხი ფაქტი, თითოეული ცალკე წესრიგშია:

1. პორტალი CDN-ის უკან დგას. CDN TLS-ს წყვეტს და მოთხოვნას ჩვენს origin-ს კერძო არხით გადასცემს. ის ჩვეულებრივ სათაურებს ამატებს: კლიენტის რეალურ IP-ს და X-Forwarded-Proto: https.

2. nginx მორგებულია ისე, რომ CDN-ის real-IP სათაურს ენდოს. set_real_ip_from და real_ip_header, რათა ლოგებმა და rate limit-ებმა კლიენტის მისამართი დაინახონ და არა CDN-ისა. სტანდარტულია.

3. აპლიკაციას აქვს სანდო proxy-ების სია. უმეტესი ფრეიმვორკის მსგავსად, ის X-Forwarded-* სათაურებს მხოლოდ სანდო proxy-ებისგან იღებს, რომლებსაც მიერთებული IP-ით ცნობს. სწორია: სხვა შემთხვევაში ნებისმიერს შეეძლებოდა გადაცემული პროტოკოლის გაყალბება.

4. ხელმოწერილი URL-ები სქემასაც მოიცავს. ხელმოწერა მთელ URL-ს მოიცავს, https://...-ს ჩათვლით. ესეც სწორია: სქემის უგულებელმყოფი ხელმოწერა უფრო სუსტი იქნებოდა.

ახლა გავაერთიანოთ ისინი. nginx-ის real-IP მოდული REMOTE_ADDR-ს კლიენტის IP-ით ცვლის მანამდე, სანამ მოთხოვნას აპლიკაცია დაინახავს. აპლიკაცია ამოწმებს, არის თუ არა REMOTE_ADDR სანდო proxy. კლიენტის IP ასეთი არ არის. ამიტომ ის X-Forwarded-Proto-ს უგულებელყოფს. TLS CDN-ზე შეწყდა, ასე რომ კავშირი, რომელსაც აპლიკაცია ხედავს, ჩვეულებრივი HTTP-ია. შესაბამისად, აპლიკაციას ჰგონია, რომ მოთხოვნის URL არის http://.... ის ხელმოწერას http://...-ზე თავიდან ითვლის, ადარებს https://...-ზე შექმნილს და ისინი განსხვავდება. 403.

რატომ ჩანდა მხოლოდ შესვლის შემდეგ

ავთენტიფიკაციის middleware ხელმოწერის middleware-მდე სრულდებოდა. ანონიმური დაწკაპუნება ჯერ შესვლის გვერდზე გადამისამართდებოდა, ამიტომაც კლიენტმა პირველად შესვლის ფორმა დაინახა და არა შეცდომა. მხოლოდ წარმატებული შესვლის შემდეგ აღწევდა მოთხოვნა ხელმოწერის შემოწმებამდე და იქ ვარდებოდა. ამ თანმიმდევრობის გამო ბაგი სესიის პრობლემას ჰგავდა და კარგა ხანს არასწორ ადგილას ვეძებდით.

გამოსწორება

ენდეთ proxy-ს და არა გადაწერილ მისამართს. კონკრეტულად: აპლიკაციის სანდო proxy-ების კონფიგურაცია შეიცვალა ისე, რომ მან გადაცემული სათაურები მიიღოს იმ მოთხოვნებისთვის, რომლებიც origin-ის კერძო არხით მოდის, რადგან ჩვენს ტოპოლოგიაში origin-მდე სხვა ვერაფერი აღწევს. როცა გადაცემული პროტოკოლი გათვალისწინებულია, მოთხოვნის URL ისევ https://... ხდება და ხელმოწერები შემოწმებას გადის. ამასთან, ამ მარშრუტებისთვის ხელმოწერის შემოწმება ავთენტიფიკაციის წინ გადავიტანეთ, რათა არავალიდურმა ბმულმა შესვლის ფორმის ნაცვლად მაშინვე გასაგები შეტყობინებით ჩავარდეს.

გაკვეთილი, თუ ამას გაკვეთილი შეიძლება ეწოდოს

ოთხი ნაწილიდან არცერთი არ იყო არასწორი. თითოეული დოკუმენტირებული, რეკომენდებული პარამეტრი იყო. მარცხი მათ ურთიერთქმედებაში იყო, კერძოდ კი იმაში, რომ nginx-ის real-IP გადაწერა აპლიკაციის ხედვის არეალს მიღმა ხდება. როცა ამატებთ ფენას, რომელიც გადაწერს იმას, რასაც შემდეგი კომპონენტი ნდობის გადაწყვეტილებებისთვის იყენებს, შეამოწმეთ, რა ჰგონია ახლა ამ კომპონენტს მოთხოვნის შესახებ. «ვინ გამოაგზავნა ეს» და «როგორ მოვიდა ეს» ორი სხვადასხვა კითხვაა და real-IP გადაწერის შემდეგ თავდაპირველი პასუხი მხოლოდ ერთ მათგანს რჩება.