Kondisi kecocokan aturan

Dalam Seperangkat aturan Azure Front Door, aturan terdiri dari beberapa kondisi kecocokan atau pun tidak ada kecocokan sama sekali, dan sebuah tindakan. Artikel ini memberikan deskripsi mendetail tentang kondisi kecocokan yang dapat Anda gunakan di seperangkat aturan Azure Front Door.

Penting

Azure Front Door (klasik) akan dihentikan pada 31 Maret 2027. Untuk menghindari gangguan layanan apa pun, penting untuk memigrasikan profil Azure Front Door (klasik) Anda ke Azure Front Door Standard atau tingkat Premium paling lambat Maret 2027. Untuk informasi selengkapnya, lihat Penghentian Azure Front Door (klasik).

Di Mesin aturan Azure Front Door (klasik), aturan terdiri dari beberapa kondisi kecocokan atau pun tidak ada kecocokan sama sekali, dan sebuah tindakan. Artikel ini memberikan deskripsi mendetail tentang kondisi kecocokan yang dapat Anda gunakan di Mesin aturan Azure Front Door (klasik).

Bagian pertama dari aturan adalah kondisi kecocokan atau set kondisi kecocokan. Aturan dapat terdiri dari hingga 10 kondisi kecocokan. Kondisi kecocokan mengidentifikasi jenis permintaan tertentu yang membutuhkan tindakan tertentu untuk dilakukan. Jika Anda menggunakan beberapa kondisi kecocokan, kondisi kecocokan dikelompokkan bersama dengan menggunakan logika DAN. Untuk semua kondisi kecocokan yang mendukung beberapa nilai, logika ATAU digunakan.

Misalnya, Anda dapat menggunakan kondisi kecocokan untuk:

  • Filter permintaan berdasarkan alamat IP, port, atau negara/wilayah tertentu.
  • Memfilter permintaan menurut informasi header.
  • Memfilter permintaan dari perangkat seluler atau perangkat desktop.
  • Memfilter permintaan dari nama file permintaan dan ekstensi file.
  • Memfilter permintaan berdasarkan nama host, protokol SSL, URL permintaan, protokol, jalur, untai (karakter) kueri, argumen posting, dan nilai lainnya.
  • Filter permintaan berdasarkan alamat IP tertentu, atau negara/wilayah.
  • Memfilter permintaan menurut informasi header.
  • Memfilter permintaan dari perangkat seluler atau perangkat desktop.
  • Memfilter permintaan dari nama file permintaan dan ekstensi file.
  • Memfilter permintaan berdasarkan URL permintaan, protokol, jalur, untai (karakter) kueri, argumen posting, dan nilai lainnya.

Jenis perangkat

Gunakan kondisi kecocokan jenis perangkat untuk mengidentifikasi permintaan yang berasal dari perangkat seluler atau perangkat desktop.

Properti

Properti Nilai yang Didukung
Operator
  • Dalam portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan properti negateCondition untuk menentukan Tidak Sama
Nilai Mobile, Desktop

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan yang terdeteksi berasal dari perangkat seluler.

Cuplikan layar portal menunjukkan kondisi kecocokan jenis perangkat.

Versi HTTP

Gunakan kondisi kecocokan versi HTTP untuk mengidentifikasi permintaan yang dibuat dengan menggunakan versi protokol HTTP tertentu.

Catatan

Kondisi kecocokan versi HTTP hanya tersedia di Azure Front Door Standard/Premium.

Properti

Properti Nilai yang Didukung
Operator
  • Dalam portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan properti negateCondition untuk menentukan Tidak Sama
Nilai 2.0, , 1.11.0,0.9

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan yang dikirim dengan menggunakan protokol HTTP 2.0.

Cuplikan layar portal memperlihatkan kondisi kecocokan versi HTTP.

Cookie permintaan

Gunakan kondisi pencocokan cookie permintaan untuk mengidentifikasi permintaan yang menyertakan cookie tertentu.

Catatan

Kondisi kecocokan cookie permintaan hanya tersedia di Azure Front Door Standard/Premium.

Properti

Properti Nilai yang Didukung
Nama cookie Nilai untai (karakter) yang mewakili nama cookie.
Operator Setiap operator dari daftar operator standar.
Nilai Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai header permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan yang memiliki cookie bernama deploymentStampId dengan nilai 1.

Cuplikan layar portal memperlihatkan kondisi kecocokan cookie permintaan.

Argumen pos

Gunakan kondisi kecocokan argumen pos untuk mengidentifikasi permintaan berdasarkan argumen yang diberikan dalam badan permintaan POS. Kondisi kecocokan tunggal cocok dengan satu argumen dari badan permintaan POS. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Catatan

Kondisi pencocokan argumen pos berfungsi dengan jenis konten application/x-www-form-urlencoded.

Properti

Properti Nilai yang Didukung
Argumen pos Nilai untai yang mewakili nama argumen POS.
Operator Setiap operator dari daftar operator standar.
Nilai Satu atau beberapa nilai untai atau integer yang mewakili nilai argumen POS untuk dicocokkan. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan POS di mana argumen customerName disediakan di badan permintaan, dan di mana nilai customerName dimulai dengan huruf J atau K. Kita menggunakan transformasi huruf besar untuk mengubah nilai masukan menjadi huruf besar sehingga nilai yang dimulai dengan J, j, K, dan k semuanya cocok.

Cuplikan layar portal menunjukkan kondisi kecocokan argumen pos.

Untai kueri

Gunakan kondisi kecocokan untai kueri untuk mengidentifikasi permintaan yang berisi untai kueri tertentu. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Catatan

Seluruh untai kueri dicocokkan sebagai untai tunggal, tanpa awalan ?.

Properti

Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada yang cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan string kueri.
Untai kueri Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai untai kueri yang cocok. Jangan sertakan ? di awal untai kueri. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan di mana untai kueri berisi untai language=en-US. Kita ingin kondisi kecocokan peka huruf besar/kecil, jadi kita tidak mengubah kasus ini.

Cuplikan layar portal menunjukkan kondisi kecocokan untai kueri.

Alamat jarak jauh

Kondisi kecocokan alamat jarak jauh mengidentifikasi permintaan berdasarkan lokasi atau alamat IP pemohon. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

  • Gunakan notasi CIDR saat menentukan blok alamat IP. Sintaks untuk blok alamat IP adalah alamat IP dasar diikuti dengan garis miring dan ukuran awalan. Misalnya:
    • Contoh IPv4: 5.5.5.64/26 cocok dengan semua permintaan yang berasal dari alamat 5.5.5.64 hingga 5.5.5.127.
    • Contoh IPv6: 1:2:3:/48 cocok dengan semua permintaan yang berasal dari alamat 1:2:3:0:0:0:0:0 hingga 1:2:3: ffff:ffff:ffff:ffff:ffff.
  • Ketika Anda menentukan beberapa alamat IP dan blok alamat IP, logika 'ATAU' diterapkan.
    • Contoh IPv4: jika Anda menambahkan dua alamat IP 1.2.3.4 dan 10.20.30.40, kondisi ini cocok untuk setiap permintaan yang berasal dari alamat 1.2.3.4 atau 10.20.30.40.
    • Contoh IPv6: jika Anda menambahkan dua alamat IP 1:2:3:4:5:6:7:8 dan 10:20:30:40:50:60:70:80, kondisi ini cocok untuk setiap permintaan yang berasal dari salah satu alamat 1:2:3:4:5:6:7:8 atau 10:20:30:40:50:60:70:80.
  • Alamat jarak jauh mewakili IP klien asli yang berasal dari koneksi jaringan atau biasanya header permintaan X-Forwarded-For jika pengguna berada di belakang proksi. Gunakan kondisi kecocokan alamat soket (tersedia dalam Standar/Premium), jika Anda perlu mencocokkan berdasarkan alamat IP permintaan TCP.

Properti

Properti Nilai yang Didukung
Operator
  • Dalam portal Microsoft Azure: Geo Match, Geo Not Match, IP Match, atau IP Not Match
  • Dalam templat ARM: GeoMatch, IPMatch; gunakan properti negateCondition untuk menentukan Geo Tidak Cocok atau IP Tidak Cocok
Nilai
  • Untuk operator IP Match atau IP Not Match: tentukan satu atau beberapa rentang alamat IP. Jika beberapa rentang alamat IP ditentukan, mereka dievaluasi menggunakan logika ATAU.
  • Untuk operator Geo Match atau Geo Not Match: tentukan satu atau lebih lokasi menggunakan kode negaranya.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana permintaan tidak berasal dari Amerika Serikat.

Cuplikan layar portal menunjukkan kondisi kecocokan alamat jarak jauh.

Isi permintaan

Kondisi pencocokan isi permintaan mengidentifikasi permintaan berdasarkan teks tertentu yang muncul di isi permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Catatan

Jika isi permintaan melebihi ukuran 64KB, hanya 64KB pertama yang akan dipertimbangkan untuk kondisi kecocokan isi permintaan.

Properti

Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan isi permintaan.
Nilai Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai isi permintaan teks yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan di mana isi permintaan berisi untai ERROR. Kami mengubah isi permintaan menjadi huruf besar sebelum mengevaluasi kecocokan, sehingga error variasi kasus lainnya juga memicu kondisi kecocokan ini.

Cuplikan layar portal menunjukkan kondisi kecocokan isi permintaan.

Nama file permintaan

Kondisi kecocokan nama file permintaan mengidentifikasi permintaan yang menyertakan nama file yang ditentukan dalam URL permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Properti

Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan nama file permintaan.
Nilai Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai nama file permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan dengan nama file permintaan media.mp4. Kami mengubah nama file menjadi huruf kecil sebelum mengevaluasi kecocokan, sehingga MEDIA.MP4 variasi kasus lainnya juga memicu kondisi kecocokan ini.

Cuplikan layar portal menunjukkan kondisi kecocokan nama file permintaan.

Minta ekstensi file

Kondisi kecocokan ekstensi file permintaan mengidentifikasi permintaan yang menyertakan ekstensi file yang ditentukan dalam nama file di URL permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Catatan

Jangan sertakan titik di awal. Misalnya, gunakan html, bukan .html.

Properti

Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan ekstensi file permintaan.
Nilai Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai ekstensi file permintaan yang cocok. Jangan sertakan titik di awal. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan yang ekstensi file permintaannya adalah pdf atau docx. Kami mengubah ekstensi file permintaan menjadi huruf kecil sebelum mengevaluasi kecocokan, jadi PDF, DocX, dan variasi kasus lainnya juga memicu kondisi kecocokan ini.

Cuplikan layar portal menunjukkan kondisi pencocokan ekstensi file permintaan.

Header permintaan

Kondisi kecocokan header permintaan mengidentifikasi permintaan yang menyertakan header tertentu dalam permintaan. Anda dapat menggunakan kondisi kecocokan ini untuk memeriksa apakah ada header atau untuk memeriksa apakah header cocok dengan nilai yang ditentukan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Properti

Properti Nilai yang Didukung
Nama header Nilai untai yang mewakili nama argumen POS.
Operator Setiap operator dari daftar operator standar.
Nilai Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai header permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan yang permintaannya berisi header bernama MyCustomHeader, berapa pun nilainya.

Cuplikan layar portal menunjukkan kondisi kecocokan header permintaan.

Metode permintaan

Kondisi kecocokan metode permintaan mengidentifikasi permintaan yang menggunakan metode permintaan HTTP yang ditentukan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Properti

Properti Nilai yang Didukung
Operator
  • Dalam portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan properti negateCondition untuk menentukan Tidak Sama
Metode permintaan Satu atau beberapa metode HTTP dari: GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan yang permintaannya menggunakan metode DELETE.

Cuplikan layar portal menunjukkan kondisi kecocokan metode permintaan.

Jalur permintaan

Kondisi kecocokan jalur permintaan mengidentifikasi permintaan yang menyertakan jalur yang ditentukan dalam URL permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Catatan

Jalur ini adalah bagian dari URL setelah nama host dan garis miring. Misalnya, di URL https://www.contoso.com/files/secure/file1.pdf, jalurnya adalah files/secure/file1.pdf.

Properti

Properti Nilai yang Didukung
Operator
  • Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan jalur permintaan.
  • Wildcard: Sesuai ketika jalur permintaan menjadi sesuai dengan ekspresi wildcard. Ekspresi wildcard dapat mencakup karakter * agar sesuai dengan nol atau lebih karakter di dalam jalur. Misalnya, ekspresi files/customer*/file.pdf kartubebas files/customer1/file.pdfcocok dengan jalur , , files/customer109/file.pdfdan files/customer/file.pdf, tetapi tidak cocok files/customer2/anotherfile.pdfdengan .
    • Dalam portal Microsoft Azure: Wildcards, Not Wildcards
    • Dalam template ARM: Wildcard; gunakan properti negateCondition untuk menentukan Bukan Wildcard
Nilai Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai jalur permintaan yang cocok. Jika Anda menentukan garis miring di awal, garis miring akan diabaikan. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.
Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan jalur permintaan.
Nilai Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai jalur permintaan yang cocok. Jika Anda menentukan garis miring di awal, garis miring akan diabaikan. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan yang jalur file permintaannya dimulai dengan files/secure/. Kami mengubah ekstensi file permintaan menjadi huruf kecil sebelum mengevaluasi kecocokan, sehingga permintaan ke files/SECURE/ dan variasi kasus lainnya juga memicu kondisi kecocokan ini.

Cuplikan layar portal menunjukkan kondisi kecocokan jalur permintaan.

Protokol permintaan

Kondisi kecocokan protokol permintaan mengidentifikasi permintaan yang menggunakan protokol yang ditentukan (HTTP atau HTTPS).

Catatan

Protokol kadang-kadang juga disebut skema.

Properti

Properti Nilai yang Didukung
Operator
  • Dalam portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan properti negateCondition untuk menentukan Tidak Sama
Metode permintaan HTTP, HTTPS

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan yang permintaannya menggunakan protokol HTTP.

Cuplikan layar portal menunjukkan kondisi kecocokan protokol permintaan.

URL Permintaan

Mengidentifikasi permintaan yang cocok dengan URL yang ditentukan. Seluruh URL dievaluasi, termasuk protokol dan untai kueri, tetapi bukan fragmen. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Tip

Saat Anda menggunakan kondisi aturan ini, pastikan untuk menyertakan protokol dan garis miring /berikutnya. Misalnya, gunakan https://www.contoso.com/, bukan hanya www.contoso.com.

Properti

Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan URL permintaan.
Nilai Satu atau beberapa nilai untai atau bilangan bulat yang mewakili nilai URL permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan yang URL permintaannya dimulai dengan https://api.contoso.com/customers/123. Kita ubah ekstensi berkas permintaan menjadi huruf kecil sebelum mengevaluasi kecocokan, sehingga permintaan untuk https://api.contoso.com/Customers/123 dan variasi huruf lainnya juga akan memicu kondisi kecocokan ini.

Cuplikan layar portal menunjukkan kondisi kecocokan URL permintaan.

Nama host

Kondisi kecocokan nama host mengidentifikasi permintaan berdasarkan nama host yang ditentukan dalam permintaan dari klien. Kondisi kecocokan menggunakan nilai header Host untuk mengevaluasi nama host. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Properti

Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan nama host.
Nilai Satu atau beberapa nilai untai (karakter) yang mewakili nilai nama host permintaan untuk dicocokkan. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.
Transformasi kasus Kasus transformasi apa pun dari daftar transformasi untai (karakter) standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan dengan header Host yang diakhiri dengan contoso.com.

Cuplikan layar portal memperlihatkan kondisi kecocokan nama host.

Protokol SSL

Kondisi kecocokan Protokol SSL mengidentifikasi permintaan berdasarkan protokol SSL pada koneksi TLS yang sudah dibuat. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Properti

Properti Nilai yang Didukung
Operator
  • Dalam portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan properti negateCondition untuk menentukan Tidak Sama
Protokol SSL
  • Di portal Microsoft Azure: 1.0, 1.1, 1.2
  • Dalam templat ARM: TLSv1, TLSv1.1, TLSv1.2

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan yang menggunakan protokol TLS 1.2.

Cuplikan layar portal memperlihatkan kondisi kecocokan protokol SSL.

Alamat soket

Kondisi kecocokan alamat soket mengidentifikasi permintaan berdasarkan alamat IP koneksi langsung ke tepi Azure Front Door. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Catatan

Jika klien menggunakan proksi HTTP atau penyeimbang muatan untuk mengirim permintaan, alamat soket adalah alamat IP dari proksi atau penyeimbang muatan.

Gunakan kondisi kecocokan alamat jarak jauh jika Anda perlu mencocokkan berdasarkan alamat IP asli klien.

  • Gunakan notasi CIDR saat menentukan blok alamat IP. Ini berarti sintaksis untuk blok alamat IP adalah alamat IP dasar yang diikuti dengan garis miring dan ukuran awalan. Misalnya:
    • Contoh IPv4: 5.5.5.64/26 cocok dengan semua permintaan yang berasal dari alamat 5.5.5.64 hingga 5.5.5.127.
    • Contoh IPv6: 1:2:3:/48 cocok dengan semua permintaan yang berasal dari alamat 1:2:3:0:0:0:0:0 hingga 1:2:3: ffff:ffff:ffff:ffff:ffff.
  • Ketika Anda menentukan beberapa alamat IP dan blok alamat IP, logika 'ATAU' diterapkan.
    • Contoh IPv4: jika Anda menambahkan dua alamat IP 1.2.3.4 dan 10.20.30.40, kondisi ini cocok untuk setiap permintaan yang berasal dari alamat 1.2.3.4 atau 10.20.30.40.
    • Contoh IPv6: jika Anda menambahkan dua alamat IP 1:2:3:4:5:6:7:8 dan 10:20:30:40:50:60:70:80, kondisi ini cocok untuk setiap permintaan yang berasal dari salah satu alamat 1:2:3:4:5:6:7:8 atau 10:20:30:40:50:60:70:80.

Properti

Properti Nilai yang Didukung
Operator
  • Dalam portal Microsoft Azure: IP Match, Not IP Match
  • Dalam templat ARM: IPMatch; gunakan properti negateCondition untuk menentukan IP Tidak Cocok
Nilai Tentukan satu atau beberapa rentang alamat IP. Jika beberapa rentang alamat IP ditentukan, mereka dievaluasi menggunakan logika ATAU.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan dari alamat IP dalam rentang 5.5.5.64/26.

Cuplikan layar portal memperlihatkan kondisi kecocokan alamat soket.

Port klien

Kondisi kecocokan port klien mengidentifikasi permintaan berdasarkan port TCP klien yang membuat permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Properti

Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan port klien.
Nilai Satu atau beberapa nomor port, dinyatakan dalam bilangan bulat. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan dengan port klien 1234.

Cuplikan layar portal memperlihatkan kondisi kecocokan port klien.

Port server

Kondisi kecocokan port server mengidentifikasi permintaan berdasarkan port TCP server Azure Front Door yang menerima permintaan tersebut. Port harus 80 atau 443. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Properti

Properti Nilai yang Didukung
Operator Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, ketika digunakan dengan kondisi kecocokan port server.
Nilai Nomor port, yang harus 80 atau 443. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika ATAU.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan dengan port server 443.

Cuplikan layar portal memperlihatkan kondisi kecocokan port server.

Daftar operator

Untuk aturan yang menerima nilai dari daftar operator standar, operator berikut ini valid:

Operator Deskripsi Dukungan templat ARM
Any Cocok ketika ada nilai apa pun, apa pun nilainya. operator: Any
Equal Cocok jika nilainya sama persis dengan untai yang ditentukan. operator: Equal
Contains Cocok ketika nilai berisi untai yang ditentukan. operator: Contains
Less Than Cocok ketika panjang nilai kurang dari bilangan bulat yang ditentukan. operator: LessThan
Greater Than Cocok jika panjang nilai lebih besar dari bilangan bulat yang ditentukan. operator: GreaterThan
Less Than or Equal Cocok ketika panjang nilai kurang dari atau setara dengan bilangan bulat yang ditentukan. operator: LessThanOrEqual
Greater Than or Equal Cocok ketika panjang nilai lebih besar dari atau setara dengan bilangan bulat yang ditentukan. operator: GreaterThanOrEqual
Begins With Cocok ketika nilai dimulai dengan untai yang ditentukan. operator: BeginsWith
Ends With Cocok ketika nilai diakhiri dengan untai yang ditentukan. operator: EndsWith
Not Any Cocok ketika tidak ada nilai. operator: Any dan negateCondition : true
Not Equal Cocok ketika nilai tidak cocok dengan untai (karakter) yang ditentukan. operator: Equal dan negateCondition : true
Not Contains Cocok ketika nilai tidak berisi untai (karakter) yang ditentukan. operator: Contains dan negateCondition : true
Not Less Than Cocok ketika panjang nilai tidak kurang dari bilangan bulat yang ditentukan. operator: LessThan dan negateCondition : true
Not Greater Than Cocok ketika panjang nilai tidak lebih besar dari bilangan bulat yang ditentukan. operator: GreaterThan dan negateCondition : true
Not Less Than or Equal Cocok ketika panjang nilai tidak kurang dari atau sama dengan bilangan bulat yang ditentukan. operator: LessThanOrEqual dan negateCondition : true
Not Greater Than or Equals Cocok ketika panjang nilai tidak lebih besar dari atau sama dengan bilangan bulat yang ditentukan. operator: GreaterThanOrEqual dan negateCondition : true
Not Begins With Cocok ketika nilai tidak dimulai dengan untai (karakter) yang ditentukan. operator: BeginsWith dan negateCondition : true
Not Ends With Cocok ketika nilai tidak diakhiri dengan untai (karakter) yang ditentukan. operator: EndsWith dan negateCondition : true
Operator Deskripsi Dukungan templat ARM
Any Cocok ketika ada nilai apa pun, apa pun nilainya. operator: Any
Equal Cocok jika nilainya sama persis dengan untai yang ditentukan. operator: Equal
Contains Cocok ketika nilai berisi untai yang ditentukan. operator: Contains
Less Than Cocok ketika panjang nilai kurang dari bilangan bulat yang ditentukan. operator: LessThan
Greater Than Cocok jika panjang nilai lebih besar dari bilangan bulat yang ditentukan. operator: GreaterThan
Less Than or Equal Cocok ketika panjang nilai kurang dari atau setara dengan bilangan bulat yang ditentukan. operator: LessThanOrEqual
Greater Than or Equal Cocok ketika panjang nilai lebih besar dari atau setara dengan bilangan bulat yang ditentukan. operator: GreaterThanOrEqual
Begins With Cocok ketika nilai dimulai dengan untai yang ditentukan. operator: BeginsWith
Ends With Cocok ketika nilai diakhiri dengan untai yang ditentukan. operator: EndsWith
RegEx Cocok ketika nilai cocok dengan ekspresi reguler yang ditentukan. Lihat di bawah ini untuk detail lebih lanjut. operator: RegEx
Not Any Cocok ketika tidak ada nilai. operator: Any dan negateCondition : true
Not Equal Cocok ketika nilai tidak cocok dengan untai (karakter) yang ditentukan. operator: Equal dan negateCondition : true
Not Contains Cocok ketika nilai tidak berisi untai (karakter) yang ditentukan. operator: Contains dan negateCondition : true
Not Less Than Cocok ketika panjang nilai tidak kurang dari bilangan bulat yang ditentukan. operator: LessThan dan negateCondition : true
Not Greater Than Cocok ketika panjang nilai tidak lebih besar dari bilangan bulat yang ditentukan. operator: GreaterThan dan negateCondition : true
Not Less Than or Equal Cocok ketika panjang nilai tidak kurang dari atau sama dengan bilangan bulat yang ditentukan. operator: LessThanOrEqual dan negateCondition : true
Not Greater Than or Equals Cocok ketika panjang nilai tidak lebih besar dari atau sama dengan bilangan bulat yang ditentukan. operator: GreaterThanOrEqual dan negateCondition : true
Not Begins With Cocok ketika nilai tidak dimulai dengan untai (karakter) yang ditentukan. operator: BeginsWith dan negateCondition : true
Not Ends With Cocok ketika nilai tidak diakhiri dengan untai (karakter) yang ditentukan. operator: EndsWith dan negateCondition : true
Not RegEx Cocok ketika nilai tidak cocok dengan regex yang ditentukan. Lihat di bawah ini untuk detail lebih lanjut. operator: RegEx dan negateCondition : true

Tip

Untuk operator numerik seperti Kurang dari dan Lebih Besar dari atau sama dengan, perbandingan yang digunakan didasarkan pada panjang. Nilai dalam kondisi kecocokan harus berupa bilangan bulat yang menentukan panjang yang ingin Anda bandingkan.

Regex

Ekspresi reguler tidak mendukung operasi berikut:

  • Referensi latar dan mengambil subekspresi.
  • Pernyataan lebar nol arbitrer.
  • Referensi subrutin dan pola rekursif.
  • Pola kondisional.
  • Kata kerja kontrol mundur.
  • Direktif byte tunggal \C.
  • Direktif kecocokan baris baru \R.
  • Awal \K direktif reset kecocokan.
  • Panggilan dan kode yang disematkan.
  • Pengelompokan atomik dan bilangan posesif.

Daftar transformasi untai (karakter)

Untuk aturan yang dapat mentransformasikan untai (karakter), transformasi berikut valid:

Transformasi Deskripsi Dukungan templat ARM
Menjadi huruf kecil Mengonversi untai (karakter) ke representasi huruf kecil. Lowercase
Menjadi huruf besar Mengonversi untai (karakter) ke representasi huruf besar. Uppercase
Trim Menghapus spasi putih awal dan akhir dari untai (karakter). Trim
Menghapus null Menghapus nilai null dari untai (karakter). RemoveNulls
Enkode URL URL-mengkodekan untai (karakter). UrlEncode
Dekode URL URL-Mendekode untai (karakter). UrlDecode

Langkah berikutnya