مدیریت و رفع اشکال CORS (اشتراک گذاری منابع متقابل) در یک برنامه NestJS

رسیدگی و رفع اشکال CORS (اشتراک گذاری منابع متقابل) در یک برنامه NestJS می تواند کمی مشکل باشد. CORS اساساً مکانیزم امنیتی است که اطمینان حاصل می کند که frontend و backend شما می توانند به درستی با یکدیگر صحبت کنند، به خصوص زمانی که در دامنه های مختلف هستند. در اینجا خلاصه ای از نحوه مقابله با CORS در NestJS و عیب یابی مشکلات رایج آورده شده است:

1. فعال کردن CORS در NestJS

برای فعال کردن CORS در یک برنامه NestJS، باید آن را در داخل آن پیکربندی کنید main.ts فایلی که برنامه NestJS در آن نمونه سازی شده است. می توانید CORS را با استفاده از enableCors روش ارائه شده توسط NestJS NestFactory.

پیکربندی مثال:

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  // Enabling CORS with default settings
  app.enableCors();

  // Enabling CORS with specific settings
  app.enableCors({
    origin: 'http://your-frontend-domain.com', // Allow requests from this domain
    methods: 'GET,HEAD,PUT,PATCH,POST,DELETE', // Allow these methods
    allowedHeaders: 'Content-Type, Authorization', // Allow these headers
    credentials: true, // Allow credentials (cookies, HTTP authentication)
  });

  await app.listen(3000);
}
bootstrap();

2. اشکال زدایی مسائل CORS

اگر با مشکلات CORS مواجه شدید، این مراحل را برای رفع اشکال و رفع آنها دنبال کنید:

پیکربندی CORS را بررسی کنید

• ریشه های مجاز را تأیید کنید: اطمینان حاصل کنید که origin ملک در app.enableCors پیکربندی شامل دامنه برنامه frontend شما می شود.
• روش ها و سرفصل ها: تایید کنید که methods و allowedHeaders ویژگی ها به درستی با توجه به نیازهای برنامه ظاهری شما تنظیم شده اند.

درخواست های شبکه را بررسی کنید

• ابزارهای توسعه دهنده مرورگر: از ابزارهای توسعه‌دهنده مرورگر (معمولاً در برگه «شبکه» یافت می‌شود) برای بررسی سرصفحه‌های درخواست و پاسخ استفاده کنید. جستجو کنید Access-Control-Allow-Origin، Access-Control-Allow-Methods، و Access-Control-Allow-Headers در سرفصل های پاسخ
• درخواست های قبل از پرواز: اگر از روش‌های غیر استاندارد HTTP یا هدرهای سفارشی استفاده می‌کنید، مطمئن شوید که سرور به‌درستی درخواست‌های پیش از پرواز (درخواست‌های OPTIONS) را بررسی می‌کند.

بررسی گزارش های سرور

• گزارش های کنسول: گزارش‌های کنسول را به کد سمت سرور اضافه کنید تا بررسی کنید که آیا درخواست‌ها به سرور می‌رسند و آیا هدرهای CORS به درستی اعمال می‌شوند.
• پیغام خطا: برای هر گونه خطای مربوط به پیکربندی CORS به گزارش های سرور نگاه کنید.

پیکربندی پروکسی را بررسی کنید

• توسعه محلی: اگر از یک پروکسی برای توسعه محلی استفاده می کنید (به عنوان مثال، http-proxy-middleware در یک برنامه React)، اطمینان حاصل کنید که به درستی پیکربندی شده است و درخواست ها را همانطور که انتظار می رود، ارسال می کند.
• سرصفحه های پروکسی: مطمئن شوید که پروکسی هیچ هدر CORS مورد نیاز را اصلاح یا حذف نمی کند.

تست با cURL

• دستورات cURL: از cURL برای آزمایش مستقیم نقاط انتهایی API استفاده کنید و مشاهده کنید که آیا هدرهای CORS به درستی برگردانده شده اند یا خیر. این می تواند به جداسازی این که آیا مشکل مربوط به پیکربندی ظاهر یا باطن است کمک می کند.

  curl -i -X OPTIONS http://localhost:3000/api/v1/resource -H "Origin: http://your-frontend-domain.com"

مسائل رایج CORS

• ریشه های عدم تطابق: اطمینان حاصل کنید که مبدا در درخواست با مبدا مشخص شده در پیکربندی CORS مطابقت دارد.
• سرصفحه های نادرست: بررسی کنید که تمام سرصفحه‌های لازم در آن گنجانده شده است allowedHeaders پیکربندی
• مدارک گمشده: اگر اعتبارنامه ها درگیر هستند (مثلاً کوکی ها)، اطمینان حاصل کنید credentials: true در پیکربندی CORS تنظیم شده است.

برای جمع بندی همه چیز، رسیدگی به مشکلات CORS در یک برنامه NestJS به این نتیجه می رسد که اطمینان حاصل شود که frontend و backend شما با مجوزهای مناسب ارتباط برقرار می کنند. با تنظیم تنظیمات CORS مناسب، بررسی درخواست‌های خود و اشکال‌زدایی با ابزارهای مرورگر و باطن، می‌توانید اکثر مشکلاتی را که برایتان پیش می‌آید حل کنید. به یاد داشته باشید، تنظیمات واضح و دقیق در هر دو انتها، کلید تعاملات صاف هستند. به آزمایش و اصلاح تنظیمات خود ادامه دهید تا زمانی که همه چیز یکپارچه کار کند. موفق باشید و لانه سازی مبارک!!!