سياسة XMLThreatProtection

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

المزايا

عالِج ثغرات XML وقلل من الهجمات على واجهة برمجة التطبيقات. اختياريًا، اكتشاف حمولة XML الهجمات بناءً على الحدود المضبوطة. الحماية من تهديدات XML باستخدام ما يلي المناهج:

• التحقق من صحة الرسائل باستخدام مخطط XML (.xsd)
• تقييم محتوى الرسائل لكلمات رئيسية أو أنماط معيّنة لاستبعادها
• رصد الرسائل التالفة أو التي تمت صياغتها بشكل غير صحيح قبل تحليلها

مرجع العنصر

يصف مرجع العنصر عناصر وسمات XMLThreatProtection .

<XMLThreatProtection async="false" continueOnError="false" enabled="true" name="XML-Threat-Protection-1">
   <DisplayName>XML Threat Protection 1</DisplayName>
   <NameLimits>
      <Element>10</Element>
      <Attribute>10</Attribute>
      <NamespacePrefix>10</NamespacePrefix>
      <ProcessingInstructionTarget>10</ProcessingInstructionTarget>
   </NameLimits>
   <Source>request</Source>
   <StructureLimits>
      <NodeDepth>5</NodeDepth>
      <AttributeCountPerElement>2</AttributeCountPerElement>
      <NamespaceCountPerElement>3</NamespaceCountPerElement>
      <ChildCount includeComment="true" includeElement="true" includeProcessingInstruction="true" includeText="true">3</ChildCount>
   </StructureLimits>
   <ValueLimits>
      <Text>15</Text>
      <Attribute>10</Attribute>
      <NamespaceURI>10</NamespaceURI>
      <Comment>10</Comment>
      <ProcessingInstructionData>10</ProcessingInstructionData>
   </ValueLimits> 
</XMLThreatProtection>

<XMLThreatProtection> السمات

<XMLThreatProtection async="false" continueOnError="false" enabled="true" name="XML-Threat-Protection-1"> 

يصف الجدول التالي السمات المشتركة بين جميع العناصر الرئيسية للسياسة:

<DisplayName> عنصر

استخدِمه مع السمة name لتصنيف السياسة في إدارة خادم وكيل لواجهة المستخدم باسم مختلف بلغة طبيعية.

<DisplayName>Policy Display Name</DisplayName>

<NameLimits> عنصر

تحدِّد هذه السياسة عدد الأحرف المسموح به التي يجب التحقّق منها وفرضها من خلال السياسة.

<NameLimits>
   <Element>10</Element>
   <Attribute>10</Attribute>
   <NamespacePrefix>10</NamespacePrefix>
   <ProcessingInstructionTarget>10</ProcessingInstructionTarget>     
</NameLimits>

<NameLimits>/<Element> عنصر

تحدِّد هذه السياسة حدًّا أقصى لعدد الأحرف المسموح به في أي اسم عنصر في ملف XML. جلسة المراجعة.

على سبيل المثال، إليك ملف XML التالي:

<book category="WEB">
   <title>Learning XML</title>
   <author>Erik T. Ray</author>
   <year>2003</year>
</book>

عند تحليل ملف XML أعلاه، يتم تحديد قيمة العنصر <Element> في السياسة. سيتحقق المقتطف أدناه من صحة أسماء العناصر (book وtitle و لا تتجاوز author وyear) 10 حرف.

<NameLimits>
   <Element>10</Element>
   <Attribute>10</Attribute>
   <NamespacePrefix>10</NamespacePrefix>
   <ProcessingInstructionTarget>10</ProcessingInstructionTarget>     
</NameLimits>

<NameLimits>/<Attribute> عنصر

تُحدِّد حدًا أقصى لعدد الأحرف المسموح به في أي اسم سمة في مستند XML.

على سبيل المثال، إليك ملف XML التالي:

<book category="WEB">
   <title>Learning XML</title>
   <author>Erik T. Ray</author>
   <year>2003</year>
</book>

عند تحليل ملف XML أعلاه، يتم تحديد قيمة العنصر <Attribute> في السياسة. سيتأكد المقتطف أدناه من أن اسم السمة category لا يتجاوز 10 حرف.

<NameLimits>
   <Element>10</Element>
   <Attribute>10</Attribute>
   <NamespacePrefix>10</NamespacePrefix>
   <ProcessingInstructionTarget>10</ProcessingInstructionTarget>     
</NameLimits>

<NameLimits>/<NamespacePrefix> عنصر

تحدد حدًا أقصى لعدد الأحرف المسموح بها في بادئة مساحة الاسم في مستند XML.

على سبيل المثال، إليك ملف XML التالي:

<ns1:myelem xmlns:ns1="http://ns1.com"/>

عند تحليل XML أعلاه، يتم تحديد قيمة العنصر <NamespacePrefix> في سيتحقق مقتطف السياسة أدناه من أن بادئة مساحة الاسم ns1 لا تتجاوز 10 حرف.

<NameLimits>
   <Element>10</Element>
   <Attribute>10</Attribute>
   <NamespacePrefix>10</NamespacePrefix>
   <ProcessingInstructionTarget>10</ProcessingInstructionTarget>     
</NameLimits>

<NameLimits>/<ProcessingInstructionTarget> عنصر

تُحدِّد حدًا أقصى لعدد الأحرف المسموح به في استهداف أي تعليمات المعالجة في مستند XML.

على سبيل المثال، إليك ملف XML التالي:

<?xml-stylesheet type="text/xsl" href="style.xsl"?>

عند تحليل ملف XML أعلاه، يتم استخدام العنصر <ProcessingInstructionTarget> في مقتطف السياسة أدناه للتحقق من صحة هدف تعليمات المعالجة لا يتجاوز xml-stylesheet 10 حرف.

<NameLimits>
   <Element>10</Element>
   <Attribute>10</Attribute>
   <NamespacePrefix>10</NamespacePrefix>
   <ProcessingInstructionTarget>10</ProcessingInstructionTarget>     
</NameLimits>

<Source> عنصر

الرسالة التي سيتم فحصها بسبب هجمات حمولة XML. يتم تعيين هذا بشكل شائع على request، إذ يجب عادةً التحقّق من صحة الطلبات الواردة من تطبيقات العميل. عند ضبط هذا العنصر على message، سيقيّم هذا العنصر تلقائيًا رسالة الطلب. عندما يكون مرتبطًا بتدفق الطلب ورسالة الردّ عندما يكون مرفقًا بالردّ التدفق.

<Source>request</Source>

<StructuralLimits> عنصر

تحدِّد هذه السياسة الحدود الهيكلية التي سيتم التحقّق منها وفرضها من خلال السياسة.

<StructureLimits>
   <NodeDepth>5</NodeDepth>
   <AttributeCountPerElement>2</AttributeCountPerElement>
   <NamespaceCountPerElement>3</NamespaceCountPerElement>
   <ChildCount includeComment="true" includeElement="true" includeProcessingInstruction="true" includeText="true">3</ChildCount>
</StructureLimits>

<StructuralLimits>/<NodeDepth> عنصر

تحدّد هذه السمة الحدّ الأقصى لعمق العقدة المسموح به في ملف XML.

<StructureLimits>
   <NodeDepth>5</NodeDepth>
   <AttributeCountPerElement>2</AttributeCountPerElement>
   <NamespaceCountPerElement>3</NamespaceCountPerElement>
   <ChildCount includeComment="true" includeElement="true" includeProcessingInstruction="true" includeText="true">3</ChildCount>
</StructureLimits>

<StructuralLimits>/<AttributeCountPerElement> عنصر

تحدد هذه السمة الحد الأقصى لعدد السمات المسموح بها لأي عنصر.

على سبيل المثال، إليك ملف XML التالي:

<book category="WEB">
   <title>Learning XML</title>
   <author>Erik T. Ray</author>
   <year>2003</year>
</book>

<StructureLimits>
   <NodeDepth>5</NodeDepth>
   <AttributeCountPerElement>2</AttributeCountPerElement>
   <NamespaceCountPerElement>3</NamespaceCountPerElement>
   <ChildCount includeComment="true" includeElement="true" includeProcessingInstruction="true" includeText="true">3</ChildCount>
</StructureLimits>

<StructuralLimits>/<NameSpaceCountPerElement> عنصر

تُحدِّد الحد الأقصى لعدد تعريفات مساحة الاسم المسموح بها لأي عنصر.

على سبيل المثال، إليك ملف XML التالي:

<e1 attr1="val1" attr2="val2">
    <e2 xmlns="http://apigee.com" xmlns:yahoo="http://yahoo.com" one="1" yahoo:two="2"/>
</e1>

عند تحليل ملف XML أعلاه، يتم تحديد قيمة العنصر <NamespaceCountPerElement> في مقتطف السياسة أدناه سيتم التحقّق من صحة العنصرَين e1 وe2 أكثر من تعريفات مساحة الاسم 2 لكل منهما. في هذه الحالة، لا يتضمن <e1> تعريفات لمساحة الاسم يشتمل <e2> على معرّفي مساحة اسم. التعريفات: xmlns="http://apigee.com" xmlns:yahoo="http://yahoo.com"

<StructureLimits>
   <NodeDepth>5</NodeDepth>
   <AttributeCountPerElement>2</AttributeCountPerElement>
   <NamespaceCountPerElement>3</NamespaceCountPerElement>
   <ChildCount includeComment="true" includeElement="true" includeProcessingInstruction="true" includeText="true">3</ChildCount>
</StructureLimits>

&lt;StructuralLimits&gt;/&lt;ChildCount&gt; عنصر

تحدّد هذه السياسة الحد الأقصى لعدد العناصر الثانوية المسموح بها لأي عنصر.

<StructureLimits>
   <NodeDepth>5</NodeDepth>
   <AttributeCountPerElement>2</AttributeCountPerElement>
   <NamespaceCountPerElement>3</NamespaceCountPerElement>
   <ChildCount includeComment="true" includeElement="true" includeProcessingInstruction="true" includeText="true">3</ChildCount>
</StructureLimits>

السمات

&lt;ValueLimits&gt; عنصر

تُحدِّد هذه السياسة عدد الأحرف المسموح به للقيم المطلوب التحقّق منها وفرضها من خلال السياسة.

<ValueLimits>
   <Text>15</Text>
   <Attribute>10</Attribute>
   <NamespaceURI>10</NamespaceURI>
   <Comment>10</Comment>
   <ProcessingInstructionData>10</ProcessingInstructionData>
</ValueLimits>

&lt;ValueLimits&gt;/&lt;Text&gt; عنصر

تحدّد هذه السمة حدًّا أقصى لعدد الأحرف المسموح به لأي عُقد نصية متوفّرة في مستند XML.

على سبيل المثال، إليك ملف XML التالي:

<book category="WEB">
   <title>Learning XML</title>
   <author>Erik T. Ray</author>
   <year>2003</year>
</book>

<ValueLimits>
   <Text>15</Text>
   <Attribute>10</Attribute>
   <NamespaceURI>10</NamespaceURI>
   <Comment>10</Comment>
   <ProcessingInstructionData>10</ProcessingInstructionData>
</ValueLimits>

&lt;ValueLimits&gt;/&lt;Attribute&gt; عنصر

تحدّد هذه السمة حدًّا لعدد الأحرف المسموح به لأي قيم سمات متوفّرة في مستند XML.

على سبيل المثال، إليك ملف XML التالي:

<book category="WEB">
   <title>Learning XML</title>
   <author>Erik T. Ray</author>
   <year>2003</year>
</book>

<ValueLimits>
   <Text>15</Text>
   <Attribute>10</Attribute>
   <NamespaceURI>10</NamespaceURI>
   <Comment>10</Comment>
   <ProcessingInstructionData>10</ProcessingInstructionData>
</ValueLimits>

&lt;ValueLimits&gt;/&lt;NamespaceURI&gt; عنصر

تحدّد هذه السياسة حدًّا أقصى لعدد الأحرف المسموح به لأي معرّفات موارد منتظمة (URI) لمساحة الاسم في مستند XML.

على سبيل المثال، إليك ملف XML التالي:

<ns1:myelem xmlns:ns1="http://ns1.com"/>

<ValueLimits>
   <Text>15</Text>
   <Attribute>10</Attribute>
   <NamespaceURI>10</NamespaceURI>
   <Comment>10</Comment>
   <ProcessingInstructionData>10</ProcessingInstructionData>
</ValueLimits>

&lt;ValueLimits&gt;/&lt;Comment&gt; عنصر

تحدّد هذه السياسة حدًّا أقصى لعدد الأحرف المسموح به لأي تعليقات متوفّرة في مستند XML.

على سبيل المثال، إليك ملف XML التالي:

<book category="WEB">
   <!-- This is a comment -->
   <title>Learning XML</title>
   <author>Erik T. Ray</author>
   <year>2003</year>
</book>

<ValueLimits>
   <Text>15</Text>
   <Attribute>10</Attribute>
   <NamespaceURI>10</NamespaceURI>
   <Comment>10</Comment>
   <ProcessingInstructionData>10</ProcessingInstructionData>
</ValueLimits>

&lt;ValueLimits&gt;/&lt;ProcessingInstructionData&gt; عنصر

تحدّد هذه السياسة حدًّا أقصى لعدد الأحرف المسموح به لأي نص تعليمات معالجة متوفّر في ملف XML جلسة المراجعة.

على سبيل المثال، إليك ملف XML التالي:

<?xml-stylesheet type="text/xsl" href="style.xsl"?>

<ValueLimits>
   <Text>15</Text>
   <Attribute>10</Attribute>
   <NamespaceURI>10</NamespaceURI>
   <Comment>10</Comment>
   <ProcessingInstructionData>10</ProcessingInstructionData>
</ValueLimits>

مرجع الخطأ

يصف هذا القسم رموز الخطأ ورسائل الخطأ التي يتم عرضها ومتغيرات الأخطاء التي تم ضبطها من خلال Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. من المهم معرفة هذه المعلومات إذا كنت تضع قواعد خطأ التعامل مع الأخطاء. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على ما تحتاج إلى معرفته حول أخطاء السياسة والتعامل مع المعالجة والأخطاء.

أخطاء بيئة التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

ملاحظات:

• اسم الخطأ ExecutionFound (تعذّر التنفيذ) هو اسم الخطأ التلقائي وسيتم عرضه بغض النظر عن ونوع الخطأ الذي تم اكتشافه ومع ذلك، يمكن تغيير هذا الإعداد الافتراضي عن طريق تحديد على مستوى المؤسسة. عند تعيين هذه الخاصية، سيعكس اسم الخطأ القيمة الفعلية خطأ. على سبيل المثال، "TextExceeded" أو "AttrValueExceeded". راجِع ملاحظات الاستخدام لـ التفاصيل.
• حالة 500 HTTP هي الحالة الافتراضية؛ ومع ذلك، يمكن تغيير حالة HTTP إلى 400 أخطاء تدفق الطلب من خلال تعيين خاصية على مستوى المؤسسة. راجِع ملاحظات الاستخدام لـ التفاصيل.

أخطاء النشر

بلا عُري

متغيّرات الأخطاء

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

مثال على استجابة الخطأ

{
  "fault": {
    "faultstring": "XMLThreatProtection[XPT-SecureRequest]: Execution failed. reason: XMLThreatProtection[XTP-SecureRequest]: Exceeded object entry name length at line 2",
    "detail": {
      "errorcode": "steps.xmlthreatprotection.ExecutionFailed"
    }
  }
}

مثال على قاعدة الخطأ

<FaultRule name="XML Threat Protection Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ExecutionFailed") </Condition>
    </Step>
    <Condition>(xmlattack.XPT-SecureRequest.failed = true) </Condition>
</FaultRule>

المخططات

ملاحظات الاستخدام

يتعرض أي خادم يتلقى بيانات عبر الإنترنت للهجوم، سواء كان ضارًا أم غير مقصود. تستفيد بعض الهجمات من مرونة XML من خلال إنشاء مستندات غير صالحة تحتوي على احتمالية اختراق الأنظمة الخلفية. يمكن لمستندات XML التالفة أو المعقدة للغاية تخصيص الخوادم ذاكرة أكبر مما هو متاح، مما يؤدي إلى استهلاك وحدة المعالجة المركزية (CPU) وموارد الذاكرة، وتعطل المحللين اللغويين، وتعطيل معالجة الرسائل وإنشاء الملفات على مستوى التطبيق بصورة عامة هجمات الحرمان من الخدمات.

إعدادات خطأ الحماية من التهديدات

معلومات مهمة في حال إنشاء قواعد FaultRules لهذه السياسة: من خلال الإعداد التلقائي، تعرض Edge رمز حالة "خطأ في الخادم الداخلي HTTP 500" وخطأ ExecutionFound (تعذّر التنفيذ). إذا لم تتجاوز رسالة سياسة "الحماية من التهديدات" بتنسيق JSON أو XML. يمكنك تغيير سلوك الخطأ هذا في أي موقع جديد على مستوى المؤسسة. عند تعيين المؤسسة وتكون الخاصية features.isPolicyHttpStatusEnabled على true، فيما يلي :

• الطلب: مع إرفاق سياسة الحماية من التهديدات إلى أي عملية طلب، يتم عرض الرسائل غير الصالحة. عرض رمز حالة "400 طلب سيئ"، إلى جانب خطأ متعلق بالسياسة (بدلاً من مجرد التنفيذ الذي تعذّر تنفيذه).
• الرد: مع إرفاق سياسة حماية من التهديدات في أي مسار استجابة، يتم عرض الرسائل غير الصالحة لا يزال يعرض رمز حالة "خطأ في الخادم الداخلي 500"، وأحد يتم طرح رموز خطأ السياسة المقابلة (بدلاً من مجرد تنفيذ الفشل).

على عملاء Cloud التواصل مع Apigee Edge Support لإعداد خاصية المؤسسة.

مواضيع ذات صلة

تهديدات JSON سياسة الحماية

عادي سياسة الحماية من التعبيرات