وبلاگ نت‌آرامآموزش، تجربه و راهکارهای زیرساخت

تحویل فایل خصوصی با X-Accel-Redirect در Nginx و احراز هویت

پیکربندی مسیر داخلی Nginx، بررسی مجوز در برنامه و آزمایش دسترسی مستقیم به فایل خصوصی.

انتشار:
توسط تیم فنی نت‌آرام
۵ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله تحویل فایل خصوصی با X-Accel-Redirect در Nginx و احراز هویت در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
فروشگاهی را تصور کنید که فایل خریداری‌شده را فقط باید به خریدار بدهد. اگر نشانی واقعی فایل مستقیماً زیر پوشه عمومی سایت باشد، دانستن آدرس ممکن است برای دریافت آن کافی شود. از طرف دیگر، عبوردادن فایل بزرگ از داخل برنامه می‌تواند منابع برنامه را درگیر کند.
یک راه در سرور دارای Nginx این است که برنامه ابتدا هویت و اجازه دسترسی را بررسی کند، سپس با هدر X-Accel-Redirect از Nginx بخواهد فایل را از مسیر داخلی بخواند. خود این هدر ابزار احراز هویت نیست؛ امنیت به بررسی مجوز برنامه، محل فایل و تنظیم تمام مسیرهای دسترسی بستگی دارد.

۱. پیش‌نیازها و مسیر نمونه

این روش برای مدیری است که به تنظیم Nginx و برنامه خود دسترسی دارد. در هاست اشتراکی ممکن است Apache یا LiteSpeed استفاده شود یا تغییر پیکربندی مجاز نباشد؛ ابتدا امکانات همان سرویس را از میزبان بپرسید. نمونه را اول روی محیط آزمایشی اجرا کنید و نسخه قبلی تنظیمات و روش بازگشت را نگه دارید.
فرض کنید فایل آزمایشی غیرحساس manual.pdf در /srv/private-files/ است. این پوشه باید خارج از تمام مسیرهای عمومی سایت باشد. فرایندی که Nginx با آن فایل را می‌خواند باید فقط دسترسی لازم را داشته باشد؛ برای این کار پوشه یا فایل را 777 نکنید. مطمئن شوید alias یا وب‌سایت دیگری همین پوشه را عمومی منتشر نمی‌کند و پیوند نمادین خارج از محدوده، مسیر محافظت را دور نمی‌زند.

۲. مسیر داخلی را در همان server تعریف کنید

در بلوک server دامنه آزمایشی، کنار مسیر برنامه، قطعه زیر را اضافه کنید:
کد / دستورlocation /_private_files/ { internal; alias /srv/private-files/; }
در این مثال URI داخلی /_private_files/manual.pdf به فایل /srv/private-files/manual.pdf اشاره می‌کند. علامت / انتهای هر دو مسیر در همین نمونه مهم است. internal باعث می‌شود درخواست مستقیم خارجی به این location پاسخ ۴۰۴ بگیرد، اما تغییر مسیر داخلی از برنامه مجاز باشد. وجود locationهای دیگر، قانون‌های regex و تنظیمات امنیتی موجود را نیز با مدیر تطبیق دهید.
پیش از اعمال، با دسترسی مدیر این دو دستور را جداگانه اجرا کنید:
کد / دستورsudo nginx -t sudo systemctl reload nginx
دستور اول ساختار تنظیمات را آزمایش می‌کند. فقط اگر نتیجه موفق بود و نسخه قبلی را دارید، دستور دوم تنظیمات را بدون راه‌اندازی مجدد کامل بارگذاری می‌کند. نام سرویس و مسیر اجرایی ممکن است در سیستم شما فرق کند. خطای تست را با برگرداندن تغییر یا اصلاح همان فایل رفع کنید؛ با وجود خطا reload نکنید.

۳. برنامه باید پیش از هدر اجازه بدهد

در مسیر دانلود برنامه، به ترتیب این کارها را انجام دهید:
  1. نشست معتبر کاربر را با سازوکار واقعی سایت بررسی کنید؛ کاربر ناشناس پاسخ عدم دسترسی بگیرد.
  2. شناسه فایل درخواستی را در پایگاه داده یا فهرست مجاز خود پیدا کنید و مالکیت خرید یا مجوز همان کاربر برای همان فایل را بررسی کنید.
  3. نام ذخیره‌شده مورد اعتماد را از فهرست سمت سرور بگیرید؛ مقدار دلخواه URL یا نام ارسالی کاربر را مستقیماً به مسیر داخلی نچسبانید.
  4. فقط بعد از تأیید همه این موارد، پاسخ موفق برنامه هدر نمونه زیر را بفرستد و خود برنامه فایل را در بدنه پاسخ کپی نکند.
کد / دستورX-Accel-Redirect: /_private_files/manual.pdf Cache-Control: private, no-store
این دو خط پاسخ برنامه‌اند، نه فرمانی که کاربر در مرورگر وارد کند. manual.pdf باید نتیجه نگاشت امن برنامه باشد. در صورت مجاز نبودن، برنامه باید بدون این هدر پاسخ ۴۰۱ یا ۴۰۳ بدهد. برای فایل حساس، سیاست کش CDN و مرورگر را نیز مطابق معماری خود تنظیم کنید؛ no-store به تنهایی پاسخ‌های قدیمی ذخیره‌شده را پاک نمی‌کند.
اگر برنامه پشت پراکسی است، فقط هدر صادرشده از پاسخ برنامه مورد اعتماد باید پردازش شود. بررسی کنید تنظیمی مانند proxy_ignore_headers X-Accel-Redirect پردازش لازم را غیرفعال نکرده باشد و درگاه داخلی برنامه از اینترنت قابل دورزدن نباشد. هیچ نمونه‌ای را که نقش کاربر را از ورودی دلخواه مرورگر می‌گیرد به عنوان احراز هویت واقعی استفاده نکنید.

۴. سه آزمون ضروری

ابتدا در مرورگر ناشناس، آدرس مستقیم https://example.com/_private_files/manual.pdf را باز کنید؛ برای این location باید ۴۰۴ باشد. سپس همان فایل را با کاربر آزمایشیِ بدون مجوز از مسیر برنامه درخواست کنید؛ باید رد شود. در آخر با کاربر مجاز و همان مسیر برنامه درخواست کنید؛ باید فایل کامل و درست دریافت شود.
علاوه بر این، فایل دیگری را با تغییر شناسه امتحان کنید؛ خرید یک فایل نباید دسترسی به فایل دیگر بدهد. در صورت استفاده از CDN، سناریوی بدون مجوز را پس از دریافت موفق کاربر مجاز نیز آزمایش کنید تا کش مشترک پاسخ خصوصی را به فرد دیگر ندهد. از فایل واقعی مشتری و توکن او برای آزمون استفاده نکنید.

۵. اگر نتیجه مطابق انتظار نبود

اگر درخواست مستقیم فایل را باز می‌کند، انتشار را متوقف کنید و وجود مسیر عمومی دیگر، انتخاب location و بارگذاری تنظیم جدید را بررسی کنید. اگر کاربر مجاز ۴۰۴ می‌گیرد، نگاشت URI به alias، نام دقیق فایل و محل آن را با لاگ خطا تطبیق دهید. خطای مجوز فایل ممکن است از دسترسی خواندن فایل یا عبور از پوشه‌های والد باشد؛ راهنمای ۴۰۳ و مجوز مسیر در تشخیص آن کمک می‌کند.
اگر به جای فایل، بدنه خالی پاسخ برنامه نمایش داده می‌شود، رسیدن درخواست به همان Nginx و فعال‌بودن پردازش هدر upstream را بررسی کنید. تنظیمات نسخه و معماری هر سرویس متفاوت‌اند؛ متن کامل خطای لاگ بدون اطلاعات مشتری را به مدیر بدهید.
برای مشخصات هاست دانلود نت‌آرام و تعریف رسمی internal و alias، مستندات Nginx را ببینید.
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.

دیدگاه‌ها (۰)

دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام