Azure ön kapı kuralları ile eşleşen koşullar

azure ön kapı kuralları altyapısında ve azure ön kapısının standart/Premium kural kümesinde, bir kural hiçbiri veya bazı eşleşme koşullarından ve bir eylemden oluşur. Bu makalede, Azure ön kapısı kural kümesi veya kuralları altyapısında kullanabileceğiniz eşleşme koşullarına ilişkin ayrıntılı açıklamalar sağlanmaktadır.

Bir kuralın ilk bölümü eşleşme koşullarıdır veya eşleştirme koşulları kümesidir. Bir kural, en fazla 10 eşleşme koşullarından oluşabilir. Bir eşleşme koşulu, tanımlı eylemlerin yapıldığı belirli istek türlerini tanımlar. Birden çok eşleşme koşulu kullanırsanız, eşleşme koşulları ve Logic kullanılarak birlikte gruplandırılır. Birden çok değeri destekleyen tüm eşleşme koşulları veya mantık kullanılır.

Eşleştirme koşulunu şu şekilde kullanabilirsiniz:

  • İstekleri belirli bir IP adresine, ülkeye veya bölgeye göre filtreleyin.
  • İstekleri üst bilgi bilgisine göre filtreleyin.
  • Mobil cihazlardan veya masaüstü cihazlardan gelen istekleri filtreleyin.
  • İstek dosya adı ve dosya uzantısından gelen istekleri filtreleyin.
  • İstek URL 'SI, protokol, yol, sorgu dizesi, post args, vb. için istekleri filtreleyin.

Önemli

Azure ön kapı standart/Premium (önizleme) şu anda genel önizleme aşamasındadır. Önizleme sürümü bir hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yüklerinde kullanılması önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Cihaz Türü

Bir mobil cihazdan veya masaüstü cihazdan yapılmış istekleri belirlemek için cihaz türü eşleşme koşulunu kullanın.

Özellikler

Özellik Desteklenen değerler
Operatör
  • Azure portal: Equal , Not Equal
  • ARM şablonlarında: Equal ; negateCondition eşit değil belirtmek için özelliğini kullanın
Değer Mobile, Desktop

Örnek

Bu örnekte, bir mobil cihazdan geldiği algılanan tüm istekleri eşleştik.

Cihaz türü eşleşme koşulunu gösteren Portal ekran görüntüsü.

Post bağımsız değişkenleri

POST isteğinin gövdesinde belirtilen bağımsız değişkenlere göre istekleri tanımlamak için Post args Match koşulunu kullanın. Tek bir eşleştirme koşulu, POST isteğinin gövdesinden tek bir bağımsız değişkenle eşleşir. Eşlemek için birden çok değer belirtebilirsiniz, bu, OR mantığı kullanılarak birleştirilir.

Not

Post args ile eşleşen durum, içerik türü ile birlikte kullanılabilir application/x-www-form-urlencoded .

Özellikler

Özellik Desteklenen değerler
Post bağımsız değişkenleri POST bağımsız değişkeninin adını temsil eden bir dize değeri.
Operatör Standart işleç listesindenherhangi bir operatör.
Değer Eşleştirilecek POST bağımsız değişkeninin değerini temsil eden bir veya daha fazla dize veya tamsayı değeri. Birden çok değer belirtilmişse, veya mantığı kullanılarak değerlendirilir.
Örnek dönüştürme Lowercase, Uppercase

Örnek

Bu örnekte, customerName istek gövdesinde bir bağımsız değişken sağlandığı ve değeri harfle başladığı tüm post istekleri eşleşeceğiz customerName J K . ,, Ve ile başlayan değerlerin J j K k Tümü eşleştirilmek üzere giriş değerlerini büyük harfe dönüştürmek için bir Case dönüştürmesi kullanıyoruz.

Post args eşleşme koşulunun gösterildiği Portal ekran görüntüsü.

Sorgu dizesi

Belirli bir sorgu dizesi içeren istekleri tanımlamak için sorgu dizesi eşleştirme koşulunu kullanın. Eşlemek için birden çok değer belirtebilirsiniz, bu, OR mantığı kullanılarak birleştirilir.

Not

Tüm sorgu dizesi, baştaki değer olmadan tek bir dize olarak eşleştirilir ? .

Özellikler

Özellik Desteklenen değerler
Operatör Standart işleç listesindenherhangi bir operatör.
Sorgu dizesi Eşleştirilecek sorgu dizesinin değerini temsil eden bir veya daha fazla dize veya tamsayı değeri. ?Sorgu dizesinin başlangıcına dahil etmeyin. Birden çok değer belirtilmişse, veya mantığı kullanılarak değerlendirilir.
Örnek dönüştürme Lowercase, Uppercase

Örnek

Bu örnekte, sorgu dizesinin dizeyi içerdiği tüm istekleri eşleşeceğiz language=en-US . Eşleştirme koşulunun büyük/küçük harfe duyarlı olmasını istiyoruz, bu nedenle büyük/küçük harf dönüştürmemelidir.

Sorgu dizesi eşleşme koşulunu gösteren Portal ekran görüntüsü.

Uzak adres

Uzak adres eşleştirme koşulu, istek sahibinin konumuna veya IP adresine göre istekleri tanımlar. Eşlemek için birden çok değer belirtebilirsiniz, bu, OR mantığı kullanılarak birleştirilir.

  • IP adresi blokları belirtirken CıDR gösterimini kullanın. Bu, bir IP adresi bloğunun sözdiziminin, ardından bir eğik çizgi ve ön ek boyutu gelen taban IP adresi olduğu anlamına gelir. Örneğin:
    • IPv4 örneği: 5.5.5.64/26 5.5.5.64 adresinden 5.5.5.127 'e ulaşan tüm istekleri eşleştirir.
    • IPv6 örneği: 1:2:3:/48 1:2:3:0:0:0:0:0 ile 1:2:3 arasındaki adresten gelen tüm istekleri eşleştirir: ffff: ffff: ffff: ffff: ffff.
  • Birden çok IP adresi ve IP adresi bloğu belirttiğinizde, ' veya ' mantığı uygulanır.
    • IPv4 örneği: iki IP adresi eklerseniz 1.2.3.4 ve 10.20.30.40 Bu koşul, 1.2.3.4 veya 10.20.30.40 adresinden gelen istekler için eşleştirilir.
    • IPv6 örneği: iki IP adresi eklerseniz 1:2:3:4:5:6:7:8 ve 10:20:30:40:50:60:70:80 Bu koşul, 1:2:3:4:5:6:7:8 veya 10:20:30:40:50:60:70:80 adresinden gelen istekler için eşleştirilir.
  • Uzak adres, ağ bağlantısından ya da Kullanıcı bir proxy 'nin arkasındaysa, genellikle X-Iletilen istek üst bilgisi olan özgün istemci IP 'sini temsil eder.

Özellikler

Özellik Desteklenen değerler
Operatör
  • Azure Portal:,, Geo Match Geo Not Match IP Match veya IP Not Match
  • ARM şablonlarında: GeoMatch , IPMatch ; coğrafi olarak negateCondition eşleşmeyen veya IP eşleşmeyen ' i belirtmek için özelliğini kullanın
Değer
  • IP MatchVeya IP Not Match işleçleri: bir veya daha fazla IP adres aralığı belirtin. Birden çok IP adresi aralığı belirtilmişse, veya mantığı kullanılarak değerlendirilir.
  • veya Geo Match Geo Not Match işleçleri için: ülke kodunu kullanarak bir veya daha fazla konum belirtin.

Örnek

Bu örnekte, isteğin kaynağı olarak kaynaklandığı tüm istekler Birleşik Devletler.

Uzak adres eşleşme koşullarını gösteren portal ekran görüntüsü.

İstek gövdesi

İstek gövdesi eşleşme koşulu, istekleri isteğin gövdesinde görünen belirli bir metne göre tanımlar. Eşleşecek birden çok değer belirtebilirsiniz. Bu değer OR mantığı kullanılarak bir araya gelecektir.

Not

İstek gövdesi boyutu 64 KB'yi aşarsa, istek gövdesi eşleşme koşulu için yalnızca ilk 64 KB dikkate alınır.

Özellikler

Özellik Desteklenen değerler
Operatör Standart işleç listesinden herhangi bir işleç.
Değer Eşleşmesi gereken istek gövdesi metninin değerini temsil eden bir veya daha fazla dize veya tamsayı değeri. Birden çok değer belirtilirse OR mantığı kullanılarak değerlendirilir.
Durum dönüştürme Lowercase, Uppercase

Örnek

Bu örnekte, istek gövdesinin dizesini içerdiği tüm istekler ile ERROR eşleriz. Eşleşmeyi değerlendirmeden önce istek gövdesinde büyük harfe dönüştürmemiz gerekir ve diğer büyük/küçük harf varyasyonları da bu error eşleşme koşullarını tetikler.

İstek gövdesi eşleşme koşullarını gösteren portal ekran görüntüsü.

İstek dosyası adı

İstek dosyası adı eşleşme koşulu, istek URL'sinde belirtilen dosya adını içeren istekleri tanımlar. Eşleşecek birden çok değer belirtebilirsiniz. Bu değer OR mantığı kullanılarak bir araya gelecektir.

Özellikler

Özellik Desteklenen değerler
Operatör Standart işleç listesinden herhangi bir işleç.
Değer Eşleşmesi gereken istek dosyası adının değerini temsil eden bir veya daha fazla dize veya tamsayı değeri. Birden çok değer belirtilirse OR mantığı kullanılarak değerlendirilir.
Durum dönüştürme Lowercase, Uppercase

Örnek

Bu örnekte, istek dosyası adının olduğu tüm istekler ile media.mp4 eşlemiz. Eşleşmeyi değerlendirmeden önce dosya adını küçük harfe dönüştürüruz, böylece diğer büyük/küçük harf varyasyonları da bu MEDIA.MP4 eşleşme koşullarını tetikler.

İstek dosyası adı eşleşme koşullarını gösteren portal ekran görüntüsü.

İstek dosyası uzantısı

İstek dosyası uzantısı eşleşme koşulu, istek URL'sinde dosya adına belirtilen dosya uzantısını içeren istekleri tanımlar. Eşleşecek birden çok değer belirtebilirsiniz. Bu değer OR mantığı kullanılarak bir araya gelecektir.

Not

Baştaki dönemi dahil etme. Örneğin .html yerine html kullanın.

Özellikler

Özellik Desteklenen değerler
Operatör Standart işleç listesinden herhangi bir işleç.
Değer Eşleşmesi gereken istek dosyası uzantısının değerini temsil eden bir veya daha fazla dize veya tamsayı değeri. Baştaki dönemi dahil etme. Birden çok değer belirtilirse OR mantığı kullanılarak değerlendirilir.
Durum dönüştürme Lowercase, Uppercase

Örnek

Bu örnekte, istek dosyası uzantısının veya olduğu tüm istekler ile pdf docx eşleriz. Eşleşmeyi değerlendirmeden önce istek dosyası uzantısını küçük harfe dönüştürür, bu nedenle , ve diğer büyük/küçük harf varyasyonları da bu PDF DocX eşleşme koşullarını tetikler.

İstek dosyası uzantısı eşleşme koşullarını gösteren portal ekran görüntüsü.

İstek üst bilgisi

İstek üst bilgisi eşleşme koşulu, istekte belirli bir üst bilgi içeren istekleri tanımlar. Bu eşleşme koşullarını kullanarak bir üst bilginin değeri ne olursa olsun var olup olduğunu veya üst bilginin belirtilen bir değerle eş değerle eş olup oiyrini kontrol etmek için kullanabilirsiniz. Eşleşecek birden çok değer belirtebilirsiniz. Bu değer OR mantığı kullanılarak bir araya gelecektir.

Özellikler

Özellik Desteklenen değerler
Üst bilgi adı POST bağımsız değişkeninin adını temsil eden bir dize değeri.
Operatör Standart işleç listesinden herhangi bir işleç.
Değer Eşleşmesi gereken istek üst bilgisi değerini temsil eden bir veya daha fazla dize veya tamsayı değeri. Birden çok değer belirtilirse OR mantığı kullanılarak değerlendirilir.
Durum dönüştürme Lowercase, Uppercase

Örnek

Bu örnekte, isteğin değerinden bağımsız olarak adlı bir üst bilgi içerdiği MyCustomHeader tüm istekler ile eşlemiz.

İstek üst bilgisi eşleşme koşullarını gösteren portal ekran görüntüsü.

İstek yöntemi

İstek yöntemi eşleşme koşulu, belirtilen HTTP isteği yöntemini kullanan istekleri tanımlar. Eşleşecek birden çok değer belirtebilirsiniz. Bu değer OR mantığı kullanılarak bir araya gelecektir.

Özellikler

Özellik Desteklenen değerler
Operatör
  • Aşağıdaki Azure portal: Equal , Not Equal
  • ARM şablonlarında: Equal ; Eşit negateCondition Değil'i belirtmek için özelliğini kullanın
İstek yöntemi Bir veya daha fazla HTTP yöntemi: GET , , , , , , POST PUT DELETE HEAD OPTIONS TRACE . Birden çok değer belirtilirse OR mantığı kullanılarak değerlendirilir.

Örnek

Bu örnekte, isteğin yöntemini kullandığı tüm istekler ile DELETE eşleriz.

İstek yöntemi eşleşme koşullarını gösteren portal ekran görüntüsü.

İstek yolu

İstek yolu eşleşme koşulu, istek URL'sinde belirtilen yolu içeren istekleri tanımlar. Eşleşecek birden çok değer belirtebilirsiniz. Bu değer OR mantığı kullanılarak bir araya gelecektir.

Not

Yol, URL'nin ana bilgisayar adı ve eğik çizgiden sonra gelen kısmıdır. Örneğin URL'de https://www.contoso.com/files/secure/file1.pdf yol files/secure/file1.pdf olur.

Özellikler

Özellik Desteklenen değerler
Operatör Standart işleç listesinden herhangi bir işleç.
Değer Eşleşmesi gereken istek yolunun değerini temsil eden bir veya daha fazla dize veya tamsayı değeri. Baştaki eğik çizgiyi dahil etme. Birden çok değer belirtilirse OR mantığı kullanılarak değerlendirilir.
Durum dönüştürme Lowercase, Uppercase

Örnek

Bu örnekte, istek dosyası yolunun ile başladığı tüm isteklerle files/secure/ eşleriz. Eşleşmeyi değerlendirmeden önce istek dosyası uzantısını küçük harfe dönüştürerek ve diğer büyük/küçük harf çeşitlemelerine yapılan istekler de bu files/SECURE/ eşleşme koşullarını tetikler.

İstek yolu eşleşme koşullarını gösteren portal ekran görüntüsü.

İstek protokolü

İstek protokolü eşleşme koşulu, belirtilen protokolü (HTTP veya HTTPS) kullanan istekleri tanımlar.

Not

Protokol bazen şema olarak da çağrılır.

Özellikler

Özellik Desteklenen değerler
Operatör
  • Şu Azure portal: Equal , Not Equal
  • ARM şablonlarında: Equal ; Eşit negateCondition Değil'i belirtmek için özelliğini kullanın
İstek yöntemi HTTP, HTTPS

Örnek

Bu örnekte, isteğin protokolü kullandığı tüm istekler ile HTTP eşleriz.

İstek protokolü eşleşme koşullarını gösteren portal ekran görüntüsü.

İstek URL’si

Belirtilen URL ile eşan istekleri tanımlar. URL'nin tamamı, protokol ve sorgu dizesi de dahil olmak üzere değerlendirilir, ancak parça değerlendirilmez. Eşleşecek birden çok değer belirtebilirsiniz. Bu değer OR mantığı kullanılarak bir araya gelecektir.

İpucu

Bu kural koşullarını kullanırken, protokolü dahil etmek için emin olun. Örneğin, yalnızca https://www.contoso.com yerine www.contoso.com kullanın.

Özellikler

Özellik Desteklenen değerler
Operatör Standart işleç listesinden herhangi bir işleç.
Değer Eşleşmesi gereken istek URL'sinin değerini temsil eden bir veya daha fazla dize veya tamsayı değeri. Birden çok değer belirtilirse OR mantığı kullanılarak değerlendirilir.
Durum dönüştürme Lowercase, Uppercase

Örnek

Bu örnekte, istek URL'sinin ile başladığı tüm isteklerle https://api.contoso.com/customers/123 eşleriz. Eşleşmeyi değerlendirmeden önce istek dosyası uzantısını küçük harfe dönüştürerek ve diğer büyük/küçük harf çeşitlemelerine yapılan istekler de bu https://api.contoso.com/Customers/123 eşleşme koşullarını tetikler.

İstek URL'si eşleşme koşullarını gösteren portal ekran görüntüsü.

İşleç listesi

Standart işleç listesinden değerleri kabul eden kurallar için aşağıdaki işleçler geçerlidir:

İşleç Açıklama ARM şablonu desteği
Herhangi biri Ne olduğu ne olursa olsun herhangi bir değer olduğunda eşler. operator: Any
Eşittir Değerin belirtilen dizeyle tam olarak eşleşmesi gerekir. operator: Equal
Contains Değer belirtilen dizeyi içerdiğinde eşler. operator: Contains
KüçükTen Küçük Değerin uzunluğu belirtilen tamsayıdan küçük olduğunda eşler. operator: LessThan
Büyüktür Değerin uzunluğu belirtilen tamsayıdan büyük olduğunda eşler. operator: GreaterThan
Küçük veya Eşit Değerin uzunluğu belirtilen tamsayıdan küçük veya ona eşit olduğunda eşler. operator: LessThanOrEqual
Büyüktür veya Eşittir Değerin uzunluğu belirtilen tamsayıdan büyük veya ona eşit olduğunda eşler. operator: GreaterThanOrEqual
Şununla Başlar: Değer belirtilen dizeyle başladığında eşler. operator: BeginsWith
Şununla Biter: Değer belirtilen dizeyle sona erdiğinde eşler. operator: EndsWith
Regex Değerin belirtilen normal ifadeyle eşleşmesi ile eşler. Diğer ayrıntılar için aşağıya bakın. operator: RegEx
Hiç Yok Değer yok olduğunda eşler. operator: Any ve negateCondition : true
Eşit Değil Değer belirtilen dizeyle eşleşmezse eşler. operator: Equal ve negateCondition : true
Contains Değil Değerin belirtilen dizeyi içermesi ile eşler. operator: Contains ve negateCondition : true
Küçük Değil Değerin uzunluğu belirtilen tamsayıdan küçük değilse eşler. operator: LessThan ve negateCondition : true
Büyük Değil Değerin uzunluğu belirtilen tamsayıdan büyük değilse eşler. operator: GreaterThan ve negateCondition : true
Küçük Veya Eşit Değil Değerin uzunluğu belirtilen tamsayıdan küçük veya ona eşit değilse eşler. operator: LessThanOrEqual ve negateCondition : true
Büyüktür veya Eşittir Değerin uzunluğu belirtilen tamsayıdan büyük veya ona eşit değilse eşler. operator: GreaterThanOrEqual ve negateCondition : true
Ile Başlanmaz Değer belirtilen dizeyle başlamazsa eşler. operator: BeginsWith ve negateCondition : true
Ile Bitmiyor Değer belirtilen dizeyle bitilmezse eşler. operator: EndsWith ve negateCondition : true
RegEx Değil Değer belirtilen normal ifadeyle eşleşmezse eşler. Diğer ayrıntılar için aşağıya bakın. operator: RegEx ve negateCondition : true

İpucu

Küçük ve Büyüktür veya eşittir gibi sayısal işleçler için, kullanılan karşılaştırma uzunluğu temel almaktadır. Eşleşme koşulunda yer alan değer, karşılaştırmak istediğiniz uzunluğu belirten bir tamsayı olmalıdır.

Normal ifadeler

Normal ifadeler aşağıdaki işlemleri desteklemez:

  • Yeniden başvurular ve alt ifadeleri yakalama.
  • Rastgele sıfır genişlik onayları.
  • Alt yönlendiren başvurular ve tekrarlayıcı desenler.
  • Koşullu desenler.
  • Geri izleme denetimi fiilleri.
  • Tek \C bir bayt yönergesi.
  • Yeni \R satır eşleşme yönergesi.
  • Eşleşme \K sıfırlama yönergesi başlangıcı.
  • Callouts ve embedded code.
  • Atomik gruplama ve iyelik niceci niceller.

Sonraki adımlar

Azure Front Door:

Azure Front Door Standart/Premium: