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 |
|
| Değer | Mobile, Desktop |
Örnek
Bu örnekte, bir mobil cihazdan geldiği algılanan tüm istekleri eşleştik.
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.
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.
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/265.5.5.64 adresinden 5.5.5.127 'e ulaşan tüm istekleri eşleştirir. - IPv6 örneği:
1:2:3:/481: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.
- IPv4 örneği:
- 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.4ve10.20.30.40Bu 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:8ve10:20:30:40:50:60:70:80Bu 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.
- IPv4 örneği: iki IP adresi eklerseniz
- 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 |
|
| Değer |
|
Örnek
Bu örnekte, isteğin kaynağı olarak kaynaklandığı tüm istekler Birleşik Devletler.
İ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 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ı 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 ü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 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 |
|
| İ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 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 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 |
|
| İstek yöntemi | HTTP, HTTPS |
Örnek
Bu örnekte, isteğin protokolü kullandığı tüm istekler ile HTTP eşleriz.
İ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.
İş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
\Cbir bayt yönergesi. - Yeni
\Rsatır eşleşme yönergesi. - Eşleşme
\Ksı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 Rules Engine hakkında daha fazla bilgi
- İlk Kural Altyapınızı yapılandırmayı öğrenin.
- Kural Altyapısı eylemleri hakkında daha fazla bilgi
Azure Front Door Standart/Premium:
- standart/Azure Front Door kural kümesi hakkında Premium daha fazla bilgi edinin.
- İlk Kural Kümenizi yapılandırmayı öğrenin.
- Kural Kümesi eylemleri hakkında daha fazla bilgi.