Edge Security Acceleration：Mulai dengan membuat ruang tunggu

Parameter

Deskripsi

Waiting Room Name

Tetapkan nama yang mudah dikenali untuk ruang tunggu Anda, misalnya promo_activity_room.

Hostname and Path

Menentukan URL tepat tempat ruang tunggu aktif. Satu situs dapat memiliki beberapa hostname (Nama domain). Aturan ini hanya berlaku untuk Hostname dan Path yang Anda tentukan.

Contoh: Jika hostname-nya adalah event.example.com dan path-nya adalah /route, ruang tunggu hanya berlaku untuk permintaan ke event.example.com/route.

Custom Cookie

Kredensial yang digunakan untuk mengidentifikasi dan melacak status antrian pengguna. Nama cookie memiliki awalan tetap __aliwaitingroom_. Anda dapat menyesuaikan akhirannya.

Contoh: __aliwaitingroom_promo_user.

Parameter

Deskripsi

Total Active Users

Tujuan: Menetapkan jumlah maksimum pengguna konkuren yang dapat mengakses server origin Anda secara bersamaan.

Deskripsi: Tetapkan nilai ini berdasarkan kapasitas pemrosesan konkuren aktual server origin Anda. Ketika jumlah pengguna aktif yang mengakses origin mencapai ambang batas ini, permintaan pengguna baru akan dikirim ke antrian.

Catatan: Nilai minimum adalah 200. Jika beban aktual origin Anda kurang dari 200, tetapkan nilai ini ke 200 dan gunakan parameter New Users per Minute untuk mengontrol laju penerimaan secara lebih presisi.

New Users per Minute

Tujuan: Menetapkan jumlah maksimum pengguna baru yang diterima dari antrian ke server origin setiap menit. Ini mengontrol laju pertumbuhan beban pada origin Anda.

Deskripsi: Parameter ini menentukan seberapa cepat antrian diproses. Misalnya, jika Anda menetapkannya ke 300, maksimal 300 pengguna baru dapat berpindah dari halaman tunggu ke server origin setiap menit.

Catatan: Nilai minimum adalah 200. Nilainya harus kurang dari atau sama dengan Total Active Users.

Session Duration

Tujuan: Menentukan periode validitas sesi pengguna setelah mereka meninggalkan antrian.

Deskripsi: Setelah pengguna berhasil mengakses server origin, jika mereka sementara meninggalkan (misalnya, menutup halaman) dan kembali dalam waktu yang ditetapkan oleh parameter ini, mereka tidak perlu mengantri lagi. Nilai default-nya adalah 5 menit.

Disable Session Renewal

Tujuan: Menentukan apakah periode validitas sesi pengguna diperbarui otomatis selama berinteraksi dengan server origin.

Catatan: Nama toggle ini berlawanan dengan perilakunya. Pilih opsi berdasarkan hasil yang Anda inginkan:

• Off (Default): Ini mengaktifkan perpanjangan sesi. Selama pengguna tetap aktif di server origin (dengan terus-menerus mengirim permintaan), sesi mereka tidak kedaluwarsa dan mereka tidak dikembalikan ke antrian. Ini cocok untuk sebagian besar skenario.

• On: Ini menonaktifkan perpanjangan sesi. Sesi pengguna dihitung ketat sejak pertama kali mereka masuk ke server origin. Setelah waktunya habis, pengguna harus mengantri lagi, meskipun mereka masih aktif menjelajah. Ini cocok untuk skenario yang memerlukan kontrol ketat atas durasi kunjungan tunggal pengguna, seperti penjualan kilat.

Queuing Method

Tujuan: Memilih kebijakan penerimaan pengguna dari halaman tunggu.

• FIFO: Menerima pengguna sesuai urutan permintaan diterima. Ini metode paling adil dan direkomendasikan sebagai default.

• Random: Memilih pengguna secara acak dari antrian untuk memberikan akses. Ini berlaku untuk skenario seperti undian di mana keadilan bukan prioritas utama.

• Reject All: Semua pengguna baru dikirim ke halaman tunggu dan tidak diterima. Ini berguna untuk pemanasan pra-event, maintenance sistem, atau keadaan darurat saat Anda perlu menutup akses.

• Passthrough: Semua permintaan melewati antrian dan langsung menuju server origin. Dalam mode ini, ruang tunggu dinonaktifkan secara efektif. Ini dapat digunakan untuk mengembalikan akses normal setelah event atau untuk pengujian fungsional.

Parameter

Deskripsi

Type

Default Waiting Room: Halaman tunggu standar yang disediakan sistem. Secara otomatis menampilkan perkiraan waktu tunggu. Anda dapat memilih Default Language Template (English, Simplified Chinese, atau Traditional Chinese).

Custom Waiting Room: Memungkinkan Anda mengunggah halaman HTML kustom. Untuk menggunakan fitur ini, hubungi perwakilan penjualan Anda.

• Anda dapat mengedit templat atau langsung mengimpor file .html (ukuran maksimal 50 KB).

• Anda dapat menggunakan variabel dinamis (seperti ${waitTime}) dalam HTML untuk menampilkan informasi antrian.

Preview

Klik tautan untuk melihat pratinjau tampilan halaman tunggu dalam berbagai kondisi, seperti Queuing atau Queue All.

JSON Response

Tujuan: Memberikan informasi status antrian terstruktur untuk klien non-browser, seperti aplikasi dan program mini.

Aktifkan toggle ini. Saat header permintaan klien menyertakan Accept: application/json, ESA akan mengembalikan informasi antrian dalam format JSON, bukan halaman tunggu HTML. Untuk detail parameter, lihat deskripsi parameter respons JSON.

Alur interaksi:

1. Permintaan pertama: Klien mengakses URL target dengan header permintaan Accept: application/json.

2. Dapatkan dan simpan cookie: Header respons ESA akan berisi bidang Set-Cookie. Klien harus menyimpan cookie ini untuk digunakan sebagai kredensial identitas pada permintaan berikutnya.

3. Polling status: Klien harus menyertakan cookie ini dalam permintaannya. Klien harus secara berkala mengirim ulang permintaan ke URL yang sama dengan interval yang ditentukan oleh bidang refreshIntervalSeconds dalam badan respons untuk memperbarui status antriannya.

4. Akses origin: Saat bidang inWaitingRoom dalam badan respons berubah menjadi false, klien telah keluar dari antrian. Klien kemudian dapat menggunakan cookie tersebut untuk mengakses sumber daya origin secara normal.

Contoh respons:

{
  "WaitingRoom": {
    "inWaitingRoom": true,
    "waitTime": 5,
    "waitTimeKnown": true,
    "waitTimeFormatted": "5 minutes",
    "queueIsFull": false,
    "queueAll": false,
    "lastUpdated": "2024-09-10T12:00:00.000Z",
    "refreshIntervalSeconds": 20
  }
}

Queuing Status Code

Sesuaikan kode status respons HTTP yang diterima pengguna saat berada dalam antrian. Default-nya adalah 200. Anda dapat mengubahnya ke kode status lain, seperti 202, sesuai kebutuhan.