خط مشی XMLThreatProtection

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

چه

آسیب‌پذیری‌های XML را برطرف کرده و حملات به API خود را به حداقل برسانید. در صورت تمایل، حملات XML Payload را بر اساس محدودیت‌های پیکربندی شده شناسایی کنید. با استفاده از رویکردهای زیر، تهدیدات 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>

عنصر <منبع>

پیامی که باید برای حملات XML payload بررسی شود. این گزینه معمولاً روی 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> دارای 0 تعریف فضای نام و <e2> دارای 2 تعریف فضای نام است: 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>

عنصر <StructuralLimits>/<ChildCount>

حداکثر تعداد عناصر فرزند مجاز برای هر عنصر را مشخص می‌کند.

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

ویژگی‌ها

عنصر <ValueLimits>

محدودیت‌های کاراکتری را برای مقادیری که باید توسط سیاست بررسی و اعمال شوند، مشخص می‌کند.

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

عنصر <ValueLimits>/<Text>

محدودیت کاراکتر را برای هر گره متنی موجود در سند 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>

عنصر <ValueLimits>/<Attribute>

محدودیت کاراکتر را برای هر مقدار ویژگی موجود در سند 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>

عنصر <ValueLimits>/<NamespaceURI>

محدودیت کاراکتر را برای هر 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>

عنصر <ValueLimits>/<Comment>

محدودیت کاراکتر برای هر توضیحی که در سند 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>

عنصر <ValueLimits>/<ProcessingInstructionData>

محدودیت کاراکتری را برای هر متن دستورالعمل پردازش موجود در سند 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 تنظیم می‌شوند، هنگامی که این خط‌مشی خطا را راه‌اندازی می‌کند، توضیح می‌دهد. این اطلاعات برای دانستن اینکه آیا در حال توسعه قوانین خطا برای رسیدگی به خطاها هستید، مهم است. برای کسب اطلاعات بیشتر، آنچه را که باید در مورد خطاهای خط مشی و مدیریت خطاها بدانید را ببینید.

خطاهای زمان اجرا

این خطاها ممکن است هنگام اجرای سیاست رخ دهند.

یادداشت ها:

• نام خطا ExecutionFailed نام خطای پیش‌فرض است و صرف‌نظر از نوع خطای شناسایی‌شده، برگردانده می‌شود. با این حال، این پیش فرض را می توان با تنظیم یک ویژگی در سطح سازمان تغییر داد. هنگامی که این ویژگی تنظیم شود، نام خطا نشان دهنده خطای واقعی است. به عنوان مثال، "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>

طرحواره‌ها

یادداشت‌های استفاده

هر سروری که داده‌های آنلاین دریافت می‌کند، چه مخرب و چه غیرعمدی، در معرض حمله قرار دارد. برخی از حملات با ساخت اسناد نامعتبر که پتانسیل به خطر انداختن سیستم‌های back-end را دارند، از انعطاف‌پذیری XML سوءاستفاده می‌کنند. اسناد XML خراب یا بسیار پیچیده می‌توانند باعث شوند سرورها حافظه بیشتری نسبت به آنچه در دسترس است اختصاص دهند، منابع CPU و حافظه را درگیر کنند، تجزیه‌کننده‌ها را از کار بیندازند و به طور کلی پردازش پیام را غیرفعال کنند و حملات انکار سرویس در سطح برنامه ایجاد کنند.

پیکربندی خطای محافظت در برابر تهدید

اطلاعات مهم اگر در حال ایجاد FaultRules برای این خط‌مشی هستید: به طور پیش‌فرض، Edge یک کد وضعیت خطای داخلی سرور HTTP 500 و یک کد خطای ExecutionFailed را در صورتی که پیامی از خط‌مشی JSON یا XML Threat Protection عبور نکند، ارائه می‌دهد. می‌توانید این رفتار خطا را با یک ویژگی جدید در سطح سازمان تغییر دهید. هنگام تنظیم ویژگی org features.isPolicyHttpStatusEnabled روی true، رفتار زیر رخ می‌دهد:

• درخواست: با یک سیاست محافظت در برابر تهدید که به هر جریان درخواستی متصل است، پیام‌های نامعتبر کد وضعیت 400 Bad Request را به همراه کد خطای سیاست مربوطه (به جای فقط ExecutionFailed) برمی‌گردانند.
• پاسخ: با وجود یک سیاست محافظت در برابر تهدید که به هر جریان پاسخی متصل است، پیام‌های نامعتبر همچنان کد وضعیت ۵۰۰ خطای داخلی سرور را برمی‌گردانند و یکی از کدهای خطای سیاست مربوطه (به جای فقط ExecutionFailed) نمایش داده می‌شود.

مشتریان فضای ابری برای تنظیم ویژگی سازمانی باید با پشتیبانی Apigee Edge تماس بگیرند.

مباحث مرتبط

سیاست محافظت در برابر تهدید JSON

سیاست حفاظت از عبارات منظم

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

چه

آسیب‌پذیری‌های XML را برطرف کرده و حملات به API خود را به حداقل برسانید. در صورت تمایل، حملات XML Payload را بر اساس محدودیت‌های پیکربندی شده شناسایی کنید. با استفاده از رویکردهای زیر، تهدیدات 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>

عنصر <منبع>

پیامی که باید برای حملات XML payload بررسی شود. این گزینه معمولاً روی 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> دارای 0 تعریف فضای نام و <e2> دارای 2 تعریف فضای نام است: 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>

عنصر <StructuralLimits>/<ChildCount>

حداکثر تعداد عناصر فرزند مجاز برای هر عنصر را مشخص می‌کند.

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

ویژگی‌ها

عنصر <ValueLimits>

محدودیت‌های کاراکتری را برای مقادیری که باید توسط سیاست بررسی و اعمال شوند، مشخص می‌کند.

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

عنصر <ValueLimits>/<Text>

محدودیت کاراکتر را برای هر گره متنی موجود در سند 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>

عنصر <ValueLimits>/<Attribute>

محدودیت کاراکتر را برای هر مقدار ویژگی موجود در سند 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>

عنصر <ValueLimits>/<NamespaceURI>

محدودیت کاراکتر را برای هر 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>

عنصر <ValueLimits>/<Comment>

محدودیت کاراکتر برای هر توضیحی که در سند 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>

عنصر <ValueLimits>/<ProcessingInstructionData>

محدودیت کاراکتری را برای هر متن دستورالعمل پردازش موجود در سند 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 تنظیم می‌شوند، هنگامی که این خط‌مشی خطا را راه‌اندازی می‌کند، توضیح می‌دهد. این اطلاعات برای دانستن اینکه آیا در حال توسعه قوانین خطا برای رسیدگی به خطاها هستید، مهم است. برای کسب اطلاعات بیشتر، آنچه را که باید در مورد خطاهای خط مشی و مدیریت خطاها بدانید را ببینید.

خطاهای زمان اجرا

این خطاها ممکن است هنگام اجرای سیاست رخ دهند.

یادداشت ها:

• نام خطا ExecutionFailed نام خطای پیش‌فرض است و صرف‌نظر از نوع خطای شناسایی‌شده، برگردانده می‌شود. با این حال، این پیش فرض را می توان با تنظیم یک ویژگی در سطح سازمان تغییر داد. هنگامی که این ویژگی تنظیم شود، نام خطا نشان دهنده خطای واقعی است. به عنوان مثال، "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>

طرحواره‌ها

یادداشت‌های استفاده

هر سروری که داده‌های آنلاین دریافت می‌کند، چه مخرب و چه غیرعمدی، در معرض حمله قرار دارد. برخی از حملات با ساخت اسناد نامعتبر که پتانسیل به خطر انداختن سیستم‌های back-end را دارند، از انعطاف‌پذیری XML سوءاستفاده می‌کنند. اسناد XML خراب یا بسیار پیچیده می‌توانند باعث شوند سرورها حافظه بیشتری نسبت به آنچه در دسترس است اختصاص دهند، منابع CPU و حافظه را درگیر کنند، تجزیه‌کننده‌ها را از کار بیندازند و به طور کلی پردازش پیام را غیرفعال کنند و حملات انکار سرویس در سطح برنامه ایجاد کنند.

پیکربندی خطای محافظت در برابر تهدید

اطلاعات مهم اگر در حال ایجاد FaultRules برای این خط‌مشی هستید: به طور پیش‌فرض، Edge یک کد وضعیت خطای داخلی سرور HTTP 500 و یک کد خطای ExecutionFailed را در صورتی که پیامی از خط‌مشی JSON یا XML Threat Protection عبور نکند، ارائه می‌دهد. می‌توانید این رفتار خطا را با یک ویژگی جدید در سطح سازمان تغییر دهید. هنگام تنظیم ویژگی org features.isPolicyHttpStatusEnabled روی true، رفتار زیر رخ می‌دهد:

• درخواست: با یک سیاست محافظت در برابر تهدید که به هر جریان درخواستی متصل است، پیام‌های نامعتبر کد وضعیت 400 Bad Request را به همراه کد خطای سیاست مربوطه (به جای فقط ExecutionFailed) برمی‌گردانند.
• پاسخ: با وجود یک سیاست محافظت در برابر تهدید که به هر جریان پاسخی متصل است، پیام‌های نامعتبر همچنان کد وضعیت ۵۰۰ خطای داخلی سرور را برمی‌گردانند و یکی از کدهای خطای سیاست مربوطه (به جای فقط ExecutionFailed) نمایش داده می‌شود.

مشتریان فضای ابری برای تنظیم ویژگی سازمانی باید با پشتیبانی Apigee Edge تماس بگیرند.

مباحث مرتبط

سیاست محافظت در برابر تهدید JSON

سیاست حفاظت از عبارات منظم