ماژول auth_request در Nginx

nginx auth request module
23 شهریور 1404

مروری بر ماژول auth_request در Nginx


ماژول auth_request در Nginx به شما این امکان را می‌دهد که از درخواست های احراز هویت برای کنترل دسترسی به منابع مختلف استفاده کنید. این ماژول به شما کمک می‌کند تا وضعیت احراز هویت کاربر را از یک درخواست دیگر (معمولاً یک URL داخلی) بررسی کنید. با این کار می‌توانید از یک منبع مجزا برای احراز هویت کاربران استفاده کنید و در نتیجه معماری اپلیکیشن خود را به طور موثری مدیریت کنید.


به عنوان مثال، شما می‌توانید از این ماژول برای احراز هویت کاربران با استفاده از API های خارجی، بانک‌های اطلاعاتی یا سیستم‌های احراز هویت دیگر استفاده کنید. این کار به شما این امکان را می‌دهد که کنترل بیشتری بر روی امنیت و مدیریت دسترسی در اپلیکیشن‌ها داشته باشید.


یکی از ویژگی‌های کلیدی این ماژول این است که پاسخ‌های احراز هویت می‌توانند با توجه به کدهای وضعیت HTTP متفاوت باشند. به عنوان مثال، یک پاسخ ۲۰۰ به این معنی است که کاربر احراز هویت شده است، در حالی که یک پاسخ ۴۰۱ به معنی عدم احراز هویت است. با این ساختار، شما می‌توانید کاربر را به درستی به منابع مورد نظرش راهنمایی کنید.


حال بیایید یک مثال ساده از نحوه استفاده از ماژول auth_request را بررسی کنیم. در این مثال، ما یک URL برای بررسی احراز هویت تعریف می‌کنیم و سپس دسترسی به مسیر مورد نظرمان را فقط برای کاربرانی که احراز هویت شده‌اند، فراهم می‌کنیم.


location /protected {
auth_request /auth;
# Only authenticated users can access this location
proxy_pass http://backend;
}

location = /auth {
internal;
# Check if the user is authenticated
proxy_pass http://auth_backend;
proxy_set_header Host $host;
}

توضیح کد


در اینجا کد Nginx را تحلیل می‌کنیم:



location /protected: location به Nginx می‌گوید که هر درخواست به این مسیر را پردازش کند.


auth_request /auth: این خط مشخص می‌کند که برای دسترسی به این مسیر نخست باید درخواست به /auth ارسال شود تا وضعیت احراز هویت بررسی شود.


proxy_pass http://backend: اگر کاربر احراز هویت شده باشد، درخواست به http://backend ارسال می‌شود.


location = /auth: این بخش برای پردازش درخواست احراز هویت است.


internal: این خط به Nginx می‌گوید که این endpoint فقط از درون سرور قابل دسترسی است و هیچ درخواست خارجی نمی‌تواند به آن دسترسی پیدا کند.


proxy_pass http://auth_backend: این خط مشخص می‌کند که Nginx باید درخواست احراز هویت را به http://auth_backend ارسال کند.


proxy_set_header Host $host: این خط هدر Host را به ارزش مربوط به درخواست اصلی تنظیم می‌کند.

سوالات متداول

؟

چطور می‌توانم از ماژول auth_request در Nginx استفاده کنم؟

؟

آیا می‌توانم از ماژول auth_request برای احراز هویت در سیستم‌های خارجی استفاده کنم؟

؟

ماژول auth_request چه نوع پاسخ‌هایی را پذیرفته می‌گیرد؟