NormalExpressionProtection politikası

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Ne?

Bir iletiden bilgi çıkarır (örneğin, URI Yolu, Sorgu Parametresi, Üstbilgi, Form Parametresi, Değişken, XML Yükü veya JSON Yükü) oluşturur ve bu içeriği önceden tanımlanmış normal ifade eder. Belirtilen herhangi bir normal ifade doğru olarak değerlendirilirse ileti kabul edilir ve reddedilir.

Videolar

Normal İfade Koruması politikası hakkında daha fazla bilgi edinmek için aşağıdaki videoları izleyin.

Örnekler

<RegularExpressionProtection name="JsonPathRegExProtection">
    <DisplayName>Regular Expression Protection 1</DisplayName>
    <Source>request</Source>
    <JSONPayload escapeSlashCharacter="true">
       <JSONPath>
          <Expression>$</Expression>
          <Pattern>&lt;\s*script\b[^&gt;]*&gt;[^&lt;]+&lt;\s*\/\s*script\s*&gt;
          </Pattern>
          <Pattern>n\s*\\\\\s*slash</Pattern>
          <Pattern>n\s*\/\s*slash</Pattern>
          <Pattern>n\s*\\"\s*quotes</Pattern>
          <Pattern>n\s*\\b\s*space</Pattern>
          <Pattern>n\s*\\f\s*forwardfeed</Pattern>
          <Pattern>n\s*\\n\s*newline</Pattern>
          <Pattern>n\s*\\r\s*carria</Pattern>
          <Pattern>n\s*\\t\s*tab</Pattern>
          <Pattern>n\s*\\uFFFF\s*hex</Pattern>
       </JSONPath>
    </JSONPayload>
 </RegularExpressionProtection>

<Pattern>[\s]*(?i)((delete)|(exec)|(drop\s*table)|(insert)|(shutdown)|(update)|(\bor\b))</Pattern>

Normal İfade Koruması politikası hakkında

Apigee Edge, kullanabileceğiniz normal ifadeleri aşağıdaki içerik düzeyindeki yaygın tehditleri tespit etmek için çalışma zamanında API trafiğiyle karşılaştırılarak değerlendirilmiştir. bazı kalıplar var.

Normal ifade veya kısaca regex, bir dizi dizedir dize içinde bir kalıp belirten tüm anahtar kelimeleri listeler. Normal ifadeler, içeriğin programatik olarak yardımcı olur. Normal ifadeler, örneğin bir e-posta adresini değerlendirmek için kullanılabilir düzgün yapılandırıldığından emin olun. Daha fazla bilgi için Normal Java Eğiticilerindeki ifadeler.

regexionProtection'ın en yaygın kullanımı, JSON ve XML değerlerinin değerlendirilmesidir. açıklığa kavuşturulmasıdır.

Hiçbir normal ifade tüm içeriğe dayalı saldırıları ortadan kaldıramaz ve birden fazla mekanizma, sağlamak için birleştiriyor. Bu bölümde, projeniz için önerilen bazı kalıplar hariç tutmalısınız.

Hariç tutma örneği desenler

Normal ifadeler, politikanın XML yapılandırma dosyasında XML olarak kodlanmış olmalıdır.

[\s]*((delete)|(exec)|(drop\s*table)|(insert)|(shutdown)|(update)|(\bor\b))

<!--#(include|exec|echo|config|printenv)\s+.*

<!--#(include|exec|echo|config|printenv)\s+.*

(/(@?[\w_?\w:\*]+(\[[^]]+\])*)?)+

/?(ancestor(-or-self)?|descendant(-or-self)?|following(-sibling))

<\s*script\b[^>]*>[^<]+<\s*/\s*script\s*>

<\s*script\b[^>]*>[^<]+<\s*/\s*script\s*>

.*?Exception in thread.*

XML veya JSON yüküne sahip bir istekteki Content-Type üstbilgisini ayarlama

Normal İfade Koruması politikası yükü şunları içerebilir: öğeler:

• <XMLPayload> öğesi: Bilgilerin şuradan çıkarılması gerektiğini belirtir: ve sağlanan normal ifadeyle değerlendirilir.

  Politikada <XMLPayload> kullanırsanız İsteğin Content-Type başlığı, şunun gibi bir XML içerik türü olmalıdır: application/xml veya text/xml.

• <JSONPayload> öğesi: Bilgilerin çıkarılması gerektiğini belirtir oluşturulur ve sağlanan normal ifadeye göre değerlendirilir.

  Politikada <JSONPayload> kullanırsanız İsteğin Content-Type başlığı, şunun gibi bir JSON içerik türü olmalıdır: application/json.

Genellikle API'yi XML veya JSON'u kabul edecek şekilde tasarlarsınız. Ancak bir senaryoda Burada API her ikisini de kabul eder. Ardından bir Normal İfade Koruması politikası tanımlayabilirsiniz. hem <XMLPayload> hem de <JSONPayload> öğelerini kullanır. Content-Type üstbilgisi.

Öğe referansı

Öğe referansı, regexionProtection öğelerini ve özelliklerini açıklar. politikası.

<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
   <DisplayName>Regular Expression Protection 1</DisplayName>
   <Source>response</Source>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <URIPath>
     <Pattern>REGEX PATTERN</Pattern>
     <Pattern>REGEX PATTERN</Pattern>
   </URIPath>
   <QueryParam name="a-query-param">
     <Pattern>REGEX PATTERN</Pattern>
     <Pattern>REGEX PATTERN</Pattern>
   </QueryParam>
   <Header name="a-header">
     <Pattern>REGEX PATTERN</Pattern>
     <Pattern>REGEX PATTERN</Pattern>
   </Header>
   <FormParam name="a-form-param">
     <Pattern>REGEX PATTERN</Pattern>
     <Pattern>REGEX PATTERN</Pattern>
   </FormParam>
   <Variable name="request.content">
     <Pattern>REGEX PATTERN</Pattern>
     <Pattern>REGEX PATTERN</Pattern>
   </Variable>
   <XMLPayload>
     <Namespaces>
       <Namespace prefix="apigee">http://www.apigee.com</Namespace>
     </Namespaces>
     <XPath>
       <Expression>/apigee:Greeting/apigee:User</Expression>
       <Type>string</Type>
       <Pattern>REGEX PATTERN</Pattern>
       <Pattern>REGEX PATTERN</Pattern>
     </XPath>
   </XMLPayload>
   <JSONPayload>
     <JSONPath>
       <Expression>$.store.book[*].author</Expression>
       <Pattern>REGEX PATTERN</Pattern>
       <Pattern>REGEX PATTERN</Pattern>
     </JSONPath>
    </JSONPayload>
</RegularExpressionProtection>

<RegularExpressionProtection> özellikler

<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">

Aşağıdaki tabloda tüm politika üst öğelerinde ortak olan özellikler açıklanmaktadır:

<DisplayName> öğe

Politikayı name özelliğine ek olarak farklı bir doğal dil adına sahip yönetim arayüzü proxy düzenleyicisi.

<DisplayName>Policy Display Name</DisplayName>

<Source> öğe

Bilgilerin çıkarılması gereken mesajı belirtir.

<Source> öğesi atlanırsa değer varsayılan olarak message. Örneğin, <Source>message</Source>. Şuna ayarlandığında message, politika bir isteğe eklendiğinde kaynak olarak istek mesajını kullanır akışı sağlar. Benzer şekilde politika, yanıt akışına eklendiğinde yanıt mesajını kullanır.

Kaynak mesaj çözümlenemezse veya mesaj olmayan bir türe dönüşürse politika hata döndürür.

<Source>response</Source>

<IgnoreUnresolvedVariables> öğe

Politikanın çözülemez.

false (varsayılan) değerine ayarlanırsa politika, çözülemeyen bir değişkeniyle karşılaşıldı. true olarak ayarlanırsa çözümlenmemiş değişken boş olarak değerlendirilir dize (boş).

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

<URIPath> öğe

Bilgilerin istek URI yolundan çıkarılması ve değerlendirilmesi gerektiğini belirtir karşılaştırılması gerekir. En az bir tane sağlamalısınız Eşleşecek bir normal ifade kalıbı belirten <Pattern> öğesi.

<URIPath>
  <Pattern>REGEX PATTERN</Pattern>
  <Pattern>REGEX PATTERN</Pattern>
</URIPath>

<QueryParam> öğe

İstek sorgu parametresinden bilginin çıkarılması gerektiğini ve değerlendirilen normal ifadelerdir. En az bir tane sağlamalısınız Eşleşecek bir normal ifade kalıbı belirten <Pattern> öğesi.

<QueryParam name="a-query-param">
  <Pattern>REGEX PATTERN</Pattern>
  <Pattern>REGEX PATTERN</Pattern>
</QueryParam>

Özellikler

<Header> öğe

İstek ve yanıt başlıklarından ve değerlendirilen normal ifadelerdir. En az bir tane sağlamalısınız Eşleşecek bir normal ifade kalıbı belirten <Pattern> öğesi.

<Header name="a-header">
  <Pattern>REGEX PATTERN</Pattern>
  <Pattern>REGEX PATTERN</Pattern>
</Header>

Özellikler

<FormParam> öğe

Bilgilerin istek formu parametresinden çıkarılması ve değerlendirilmesi gerektiğini belirtir karşılaştırılması gerekir. En az bir tane sağlamalısınız Eşleşecek bir normal ifade kalıbı belirten <Pattern> öğesi.

<FormParam name="a-form-param">
   <Pattern>REGEX PATTERN</Pattern>
   <Pattern>REGEX PATTERN</Pattern>
</FormParam>

Özellikler

<Variable> öğe

Bilgilerin belirtilen değişkenden çıkarılması ve bu değişkene göre değerlendirilmesi gerektiğini belirtir verilen normal ifadelerdir.

<Variable name="request.content">
   <Pattern>REGEX PATTERN</Pattern>
   <Pattern>REGEX PATTERN</Pattern>
</Variable>

Özellikler

<XMLPayload> öğe

Bilgilerin bir XML yükünden çıkarılması ve normal ifadelerin olduğu anlamına gelir.

<XMLPayload>
   <Namespaces>
      <Namespace prefix="apigee">http://www.apigee.com</Namespace>
   </Namespaces>
   <XPath>
      <Expression>/apigee:Greeting/apigee:User</Expression>
      <Type>string</Type>
      <Pattern>REGEX PATTERN</Pattern>
      <Pattern>REGEX PATTERN</Pattern>
   </XPath>
</XMLPayload>

<XMLPayload>/<Namespaces> öğe

XPath değerlendirmesinde kullanılacak ad alanlarını belirtir.

<XMLPayload>
   <Namespaces>
      <Namespace prefix="apigee">http://www.apigee.com</Namespace>
   </Namespaces>
   <XPath>
      <Expression>/apigee:Greeting/apigee:User</Expression>
      <Type>string</Type>
      <Pattern>REGEX PATTERN</Pattern>
      <Pattern>REGEX PATTERN</Pattern>
   </XPath>
</XMLPayload>

<XMLPayload>/<Namespaces>/<Namespace> öğe

<Namespaces>
   <Namespace prefix="apigee">http://www.apigee.com</Namespace>
</Namespaces>

Özellikler

<XMLPayload>/<XPath> öğe

<XPath>
   <Expression>/apigee:Greeting/apigee:User</Expression>
   <Type>string</Type>
   <Pattern>REGEX PATTERN</Pattern>
   <Pattern>REGEX PATTERN</Pattern>
</XPath>

<XMLPayload>/<XPath>/<Expression> öğe

<XPath>
   <Expression>/apigee:Greeting/apigee:User</Expression>
   <Type>string</Type>
   <Pattern>REGEX PATTERN</Pattern>
   <Pattern>REGEX PATTERN</Pattern>
</XPath>

<XMLPayload>/<XPath>/<Type> öğe

<XPath>
   <Expression>/apigee:Greeting/apigee:User</Expression>
   <Type>string</Type>
   <Pattern>REGEX PATTERN</Pattern>
   <Pattern>REGEX PATTERN</Pattern>
</XPath>

<XMLPayload>/<XPath>/<Pattern> öğe

Normal ifade modelini tanımlar. Bir normal ifade <Pattern> öğeniz XML'de ayrılmış karakterler içeriyor (", &, ', < veya .) eklemeden önce XML olarak kodlamanız gerekir.

<XPath>
   <Expression>/apigee:Greeting/apigee:User</Expression>
   <Type>string</Type>
   <Pattern>REGEX PATTERN</Pattern>
   <Pattern>REGEX PATTERN</Pattern>
</XPath>

&lt;JSONPayload&gt; öğe

Bilgilerin bir JSON yükünden çıkarılması ve normal ifadelerin olduğu anlamına gelir.

<JSONPayload>
   <JSONPath>
      <Expression>$.store.book[*].author</Expression>
      <Pattern>REGEX PATTERN</Pattern>
      <Pattern>REGEX PATTERN</Pattern>
   </JSONPath>
</JSONPayload>

Özellikler

&lt;JSONPayload&gt;/&lt;JSONPath&gt;/&lt;Expression&gt; öğe

Değişken için tanımlanan JSONPath ifadesini belirtir.

<JSONPath>
   <Expression>$.store.book[*].author</Expression>
   <Pattern>REGEX PATTERN</Pattern>
   <Pattern>REGEX PATTERN</Pattern>
</JSONPath>

&lt;JSONPayload&gt;/&lt;JSONPath&gt;/&lt;Pattern&gt; öğe

Normal ifade modelini tanımlar. <Pattern> öğesi XML ile ayrılmış karakterler içeriyor (", &, ', < veya .), eklemeden önce XML olarak kodlamanız gerekir.

<JSONPath>
   <Expression>$.store.book[*].author</Expression>
   <Pattern>REGEX PATTERN</Pattern>
   <Pattern>REGEX PATTERN</Pattern>
</JSONPath>

Hata referansı

Bu bölümde, bu politika bir hatayı tetiklediğinde Edge tarafından ayarlanan hata kodları, döndürülen mesajlar ve hata değişkenleri açıklanmaktadır. Hataları ele almak için hata kuralları geliştirip geliştirmediğinizi bilmek önemlidir. Bir hatayı yakalamak ve kendi özel hatanızı oluşturmak istiyorsanız politika kök öğesinde continueOnError="true" özelliğini ayarlayın. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler ve Hataları işleme bölümlerine bakın.

Edge politikalarından döndürülen hatalar, Hata kodu referansı bölümünde açıklanan tutarlı bir biçimde olur.

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Dağıtım hataları

Hata değişkenleri

Bu değişkenler, bu politika bir hatayı tetiklediğinde ayarlanır. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler bölümüne bakın.

Şemalar

İlgili konular

JSON Tehdidi Koruma politikası

XML Tehdidi Koruma politikası