سياسة 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>

مرجع الخطأ

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Notes:

• The error name ExecutionFailed is the default error name and will be returned regardless of the type of error detected; however, this default can be changed by setting an organization-level property. When this property is set, the error name will reflect the actual error. For example, "TextExceeded" or "AttrValueExceeded". See Usage Notes for details.
• The 500 HTTP status is the default; however, the HTTP Status can be changed to 400 for request flow faults by setting an organization-level property. See Usage Notes for details.

Deployment errors

None.

Fault variables

These variables are set when a runtime error occurs. For more information, see What you need to know about policy errors.

Example error response

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

Example fault rule

<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 سياسة الحماية

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