Edge Security Acceleration:Get started by creating a waiting room

Paramètre

Description

Waiting Room Name

Définissez un nom explicite, par exemple promo_activity_room.

Waiting Room Name

URL exacte où la salle d'attente est active. Ce paramètre s'applique uniquement au Hostname and Path et au Subdomain spécifiés. Exemple : si le nom d'hôte est event.example.com et le chemin /route, la salle d'attente ne concerne que les requêtes vers event.example.com/route.

Path

Les nœuds ESA renvoient au client un champ Set-Cookie (identifiant de file d'attente servant à reconnaître et suivre l'état de chaque utilisateur). Le client doit conserver ce cookie spécifique à la salle d'attente et l'inclure dans toutes les requêtes ultérieures adressées aux nœuds ESA. Le nom du cookie comporte un préfixe fixe Custom Cookie. Personnalisez le suffixe selon vos besoins. Exemple : __aliwaitingroom_promo_user.

Paramètre

Description

Waiting Room Settings

Objectif : nombre maximal d'utilisateurs simultanés autorisés sur le serveur d'origine.

Description : définissez cette valeur en fonction de la capacité réelle de votre origine. Une fois ce seuil atteint, les nouvelles requêtes sont placées en file d'attente.

Remarque : la valeur minimale est de 200. Si votre origine gère moins de 200 utilisateurs simultanés, fixez ce paramètre à 200 et utilisez Total Active Users pour réguler le taux d'admission.

New Users per Minute

Objectif : nombre maximal de nouveaux utilisateurs admis depuis la file d'attente par minute. Ce paramètre contrôle la vitesse de croissance de la charge.

Description : détermine la vitesse de traitement de la file d'attente. Par exemple, une valeur de 300 permet d'admettre jusqu'à 300 utilisateurs par minute depuis la page d'attente.

Remarque : la valeur minimale est de 200. Elle doit être inférieure ou égale à New Users per Minute.

Total Active Users

Objectif : durée de validité de la session d'un utilisateur après sa sortie de la file d'attente.

Description : si un utilisateur quitte l'origine (en fermant la page, par exemple) et revient dans ce délai, il n'est pas replacé en file d'attente. Valeur par défaut : 5 minutes.

Session Duration

Objectif : définit si le minuteur de session se réinitialise pendant la navigation active.

Remarque : l'intitulé du bouton est inverse à son effet :

• Off (par défaut) : active le renouvellement de session. Les utilisateurs actifs conservent leur session et ne retournent pas en file d'attente. Convient à la plupart des scénarios.

• On : désactive le renouvellement de session. Le minuteur démarre à l'entrée sur l'origine et ne se réinitialise plus. Une fois expiré, l'utilisateur retourne en file d'attente même s'il navigue encore. Recommandé pour un contrôle strict de la durée de visite, comme lors de ventes flash.

Disable Session Renewal

Politique d'admission des utilisateurs depuis la file d'attente.

• Queuing Method : admission selon l'ordre d'arrivée des requêtes. Option par défaut recommandée.

• FIFO : sélection aléatoire des utilisateurs dans la file. Adapté aux tirages au sort ou aux scénarios où l'ordre importe peu.

• Random : tous les nouveaux utilisateurs sont dirigés vers la page d'attente sans aucune admission. Utile pour les phases de préparation avant un événement, les maintenances ou les situations d'urgence.

• Reject All : toutes les requêtes contournent la file d'attente et atteignent directement l'origine. Cela désactive de fait la salle d'attente. À utiliser pour rétablir l'accès normal après un événement ou pour des tests.

Paramètre

Description

Custom Settings

Type : page d'attente fournie par le système qui affiche le temps d'attente estimé. Vous pouvez sélectionner un Default Waiting Room (Default Language Template, English ou Simplified Chinese).

Traditional Chinese : permet d'importer une page HTML personnalisée. Contactez votre représentant commercial pour activer cette fonctionnalité.

• Modifiez le modèle ou importez directement un fichier .html (taille maximale : 50 Ko).

• Insérez des variables dynamiques (comme ${waitTime}) dans le code HTML pour afficher les informations de file d'attente.

Custom Waiting Room

Prévisualisez la page d'attente dans différents états, tels que Preview ou Queuing.

Queue All

Objectif : fournit un état de file d'attente structuré pour les clients autres que les navigateurs (applications, mini-applications).

Activez cette option. Lorsqu'une requête contient l'en-tête Accept: application/json, ESA retourne l'état de la file d'attente au format JSON au lieu d'une page HTML. Consultez la section Description des paramètres de réponse JSON.

Flux d'interaction :

1. Première requête : accédez à l'URL cible avec l'en-tête Accept: application/json.

2. Récupération et stockage du cookie : les nœuds ESA renvoient au client un champ Set-Cookie (identifiant de file d'attente servant à reconnaître et suivre l'état de chaque utilisateur). Le client doit conserver ce cookie spécifique à la salle d'attente et l'inclure dans toutes les requêtes ultérieures adressées aux nœuds ESA.

3. Interrogation de l'état : incluez le cookie dans chaque requête. Réinterrogez l'URL à l'intervalle indiqué par le champ refreshIntervalSeconds dans le corps de la réponse.

4. Accès à l'origine : lorsque inWaitingRoom passe à false, le client a quitté la file d'attente et peut accéder aux ressources de l'origine en présentant le cookie.

Exemple de réponse :

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

JSON Response

Code de statut HTTP retourné aux utilisateurs en attente. Valeur par défaut : 200. Modifiez-le si nécessaire, par exemple en 202.