تكوين مشاركة الموارد عبر المنشأ (CORS) لتطبيقات حاوية Azure

توضح لك هذه المقالة كيفية تمكين وتكوين CORS في تطبيق الحاوية الذي يعمل في مجال واحد للوصول إلى الموارد من خادم في مجال مختلف. بشكل افتراضي، تحظر المتصفحات مثل هذه الطلبات عبر المنشأ كإجراء أمان. عندما تحتاج إلى السماح لتطبيقات العميل المستضافة على مجالات مختلفة بالوصول إلى تطبيق الحاوية الخاص بك، يمكنك تكوين CORS للسماح بهذه الطلبات بشكل صريح.

أثناء تمكين CORS، يمكنك تكوين الإعدادات التالية:

الإعدادات	الشرح
السماح ببيانات الاعتماد	يشير إلى ما إذا كان يجب إرجاع Access-Control-Allow-Credentials الرأس أم لا.
MAX AGE	تكوين عنوان الاستجابة Access-Control-Max-Age للإشارة إلى المدة (بالثوان) التي يمكن تخزين نتائج طلب CORS قبل الرحلة مؤقتا.
الأصول المسموح بها	قائمة الأصول المسموح بها للطلبات عبر المنشأ (على سبيل المثال، https://www.contoso.com). يتحكم في Access-Control-Allow-Origin رأس الاستجابة. استخدم * للسماح بالكل.
الطرق المسموح بها	قائمة أساليب طلب HTTP المسموح بها في الطلبات عبر المنشأ. يتحكم في Access-Control-Allow-Methods رأس الاستجابة. استخدم * للسماح بالكل.
العناوين الرأسية المسموح بها	قائمة بالعناوين المسموح بها في الطلبات عبر المنشأ. يتحكم في Access-Control-Allow-Headers رأس الاستجابة. استخدم * للسماح بالكل.
كشف الرؤوس	بشكل افتراضي، لا يتم عرض جميع عناوين الاستجابة للتعليمات البرمجية JavaScript من جانب العميل في طلب عبر المنشأ. الرؤوس المكشوفة هي خوادم عناوين إضافية يمكن تضمينها في الاستجابة. يتحكم في Access-Control-Expose-Headers رأس الاستجابة. استخدم * لكشف الكل.

الخاصية	الشرح	نوع
allowCredentials	يشير إلى ما إذا كان يجب إرجاع Access-Control-Allow-Credentials الرأس أم لا.	boolean
maxAge	تكوين عنوان الاستجابة Access-Control-Max-Age للإشارة إلى المدة (بالثوان) التي يمكن تخزين نتائج طلب CORS قبل الرحلة مؤقتا.	integer
allowedOrigins	قائمة الأصول المسموح بها للطلبات عبر المنشأ (على سبيل المثال، https://www.contoso.com). يتحكم في Access-Control-Allow-Origin رأس الاستجابة. استخدم * للسماح بالكل.	صفيف سلاسل
allowedMethods	قائمة أساليب طلب HTTP المسموح بها في الطلبات عبر المنشأ. يتحكم في Access-Control-Allow-Methods رأس الاستجابة. استخدم * للسماح بالكل.	صفيف سلاسل
allowedHeaders	قائمة بالعناوين المسموح بها في الطلبات عبر المنشأ. يتحكم في Access-Control-Allow-Headers رأس الاستجابة. استخدم * للسماح بالكل.	صفيف سلاسل
exposeHeaders	بشكل افتراضي، لا يتم عرض جميع عناوين الاستجابة للتعليمات البرمجية JavaScript من جانب العميل في طلب عبر المنشأ. الرؤوس المكشوفة هي خوادم عناوين إضافية يمكن تضمينها في الاستجابة. يتحكم في Access-Control-Expose-Headers رأس الاستجابة. استخدم * لكشف الكل.	صفيف سلاسل

لمزيد من المعلومات، راجع مرجع مجموعة عمل تقنية تطبيق النص التشعبي على الويب (WHATWG) على استجابات HTTP الصالحة من طلب إحضار.

تمكين CORS وتكوينه

1. انتقل إلى تطبيق الحاوية في مدخل Microsoft Azure.

2. من قائمة الإعدادات، ضمن Networking، حدد CORS.

   

مع تمكين CORS، يمكنك إضافة قيم الأصول المسموح بها والأساليب المسموح بها والرؤوس المسموح بها وكشف الرؤوس وتحريرها وحذفها.

للسماح بأي قيم مقبولة للأساليب أو الرؤوس أو الأصول، أدخل * كقيمة.

إشعار

تقوم تحديثات إعدادات التكوين عبر سطر الأوامر بالكتابة فوق إعداداتك الحالية. تأكد من دمج الإعدادات الحالية في أي قيم CORS جديدة تريد تعيينها لضمان بقاء التكوين متناسقا.

قالب ARM

تمثل التعليمات البرمجية التالية النموذج الذي تأخذه إعدادات CORS في قالب ARM عند تكوين تطبيق الحاوية.

{ 
  ... 
  "properties": { 
      ... 
      "configuration": { 
         ... 
          "ingress": { 
              ... 
              "corsPolicy": { 
                "allowCredentials": true,
                "maxAge": 5000,
                "allowedOrigins": ["https://example.com"], 
                "allowedMethods": ["GET","POST"], 
                "allowedHeaders": [], 
                "exposeHeaders": []
              } 
          } 
      } 
  } 
}

YAML

تمثل التعليمات البرمجية التالية النموذج الذي تتخذه إعدادات CORS عند تكوين تطبيق الحاوية.

...
properties: 
  configuration: 
    ingress: 
    corsPolicy:
      allowCredentials: true
      maxAge: 5000
      allowedOrigins:
        - "https://example.com"
      allowedMethods:
        - "GET"
        - "POST"
      allowedHeaders: []
      exposeHeaders: []

بعد إضافة قيم خاصة بالتكوين الخاص بك، يمكنك استخدام az containerapp ingress cors update لتعيين تكوين CORS لتطبيق الحاوية.

قبل تشغيل الأمر التالي، استبدل العناصر النائبة المحيطة <> بالقيم الخاصة بك.

az containerapp ingress cors update --name <APP_NAME> --resource-group <RESOURCE_GROUP> –yaml <YAML_FILE_NAME>

الخطوات التالية

تكوين الدخول