Cloudflare Waiting Room
e CapMonster Cloud

Requisiti e preparazione

• Piano Cloudflare: Waiting Room è disponibile per i piani Business ed Enterprise.
• CDN e Proxying: Il tuo sito deve essere collegato a Cloudflare e il record DNS per il dominio o sottodominio deve essere proxied.
• Cookie: I visitatori devono supportare i cookie, poiché Cloudflare li utilizza per tracciare la posizione nella coda.
• Decidi quali pagine/utenti saranno in coda e quali bypasseranno la Waiting Room (ad esempio, amministratori, VIP, determinati percorsi).

1. Registrati su Cloudflare e collega il tuo sito.

2. Nella sezione Traffic → Waiting Room, crea una nuova coda:

3. Clicca su Create Waiting Room.

Indica:

• Hostname / URL, dove sarà attiva la Waiting Room.
• Nome della Waiting Room (per la gestione interna).
• Numero massimo di utenti ammessi contemporaneamente (facoltativo, se è necessario un carico limitato).

4. Personalizza il design della pagina di attesa:

• Puoi utilizzare il modello Cloudflare o HTML/CSS personalizzato.
• Aggiungi un logo, informazioni sul tempo di attesa e istruzioni per gli utenti.

5. Salva e attiva la Waiting Room.

6. Configurazione delle regole (Rules)

Cloudflare consente di escludere determinato traffico dalla coda.

Regole di bypass tipiche (Bypass Rules):

• Indirizzi IP dell'amministratore: consentire sempre.
• Percorsi/URL: escludere file statici (.js, .css, .png) o determinate pagine.
• Geo-targeting: escludere determinati paesi.
• Query string: escludere determinati parametri GET.

Esempio di regola di bypass del percorso nella Dashboard

1. In Waiting Room → Manage Rules → Create new bypass rule.

2. Configura:

   • Rule Name: Bypass JS Files
   • Expression: ends_with(http.request.uri.path, ".js")
   • Action: Bypass Waiting Room
3. Salva e distribuisci (Deploy).

Tutte le regole di bypass consentono di escludere il traffico dal conteggio degli utenti attivi, in modo che non influenzi la coda.

Funzionalità avanzate:

• Scheduled Event: attivazione della Waiting Room solo in momenti specifici (ad esempio, per i saldi).
• Analytics: monitoraggio del numero di utenti in coda, tempo di attesa e velocità di passaggio.
• Hostname/path aggiuntivi: una singola Waiting Room può funzionare su più sottodomini o percorsi.

Gestione tramite API:

L'API Cloudflare Waiting Room consente di:

• Creare, modificare ed eliminare regole di bypass.
• Visualizzare l'elenco delle regole.
• Gestire tutte le impostazioni della Waiting Room tramite programmazione.

Esempio di creazione di una regola di bypass tramite API

markup

POST zones/{zone_id}/waiting_rooms/{room_id}/rules
Content-Type: application/json
Authorization: Bearer <API_TOKEN>

{
  "description": "Bypass admins",
  "expression": "ip.src in { '1.2.3.4', '5.6.7.8' }",
  "action": "bypass_waiting_room",
  "enabled": true
}

Verifica del funzionamento

1) Apri il sito da diversi browser/dispositivi.

2) Verifica:

• La Waiting Room appare quando si supera il limite?
• La posizione in coda viene mantenuta quando si aggiorna la pagina?
• Le regole di bypass funzionano (ad esempio, l'IP amministratore passa senza attesa)?