Edge Security Acceleration:Get started by creating a waiting room

Parámetro

Descripción

Waiting Room Name

Establezca un nombre reconocible, por ejemplo, promo_activity_room.

Waiting Room Name

La URL exacta donde la sala de espera está activa. Se aplica únicamente al Hostname and Path y la Subdomain especificados. Por ejemplo: si el hostname es event.example.com y la ruta es /route, la sala de espera solo se aplica a las solicitudes dirigidas a event.example.com/route.

Path

Los nodos de ESA responden al cliente con un campo Set-Cookie (la credencial de la cola de la sala de espera que identifica y rastrea el estado de cada usuario). El cliente debe guardar esta cookie específica de la sala de espera e incluirla en todas las solicitudes posteriores a los nodos de ESA. El nombre de la cookie tiene el prefijo fijo Custom Cookie. Personalice el sufijo. Por ejemplo: __aliwaitingroom_promo_user.

Parámetro

Descripción

Waiting Room Settings

Propósito: número máximo de usuarios simultáneos permitidos en el servidor de origen.

Descripción: establezca este valor según la capacidad concurrente real de su origen. Cuando los usuarios activos alcanzan este umbral, las nuevas solicitudes entran en la cola.

Nota: el valor mínimo es 200. Si su origen admite menos de 200 usuarios simultáneos, establézcalo en 200 y utilice Total Active Users para controlar la tasa de admisión.

New Users per Minute

Propósito: número máximo de usuarios nuevos admitidos desde la cola por minuto. Controla la tasa de crecimiento de la carga.

Descripción: determina la velocidad de procesamiento de la cola. Por ejemplo, si establece este valor en 300, se admiten hasta 300 usuarios por minuto desde la página de espera.

Nota: el valor mínimo es 200. Debe ser menor o igual que New Users per Minute.

Total Active Users

Propósito: tiempo durante el cual la sesión de un usuario sigue siendo válida después de salir de la cola.

Descripción: si un usuario abandona el origen (por ejemplo, al cerrar la página) y regresa dentro de este periodo, omite la cola. Valor predeterminado: 5 minutos.

Session Duration

Propósito: define si el temporizador de sesión del usuario se restablece durante la navegación activa.

Nota: el nombre del interruptor indica lo contrario de su efecto:

• Off (predeterminado): habilita la renovación de la sesión. Los usuarios activos mantienen su sesión vigente y no vuelven a entrar en la cola. Recomendado para la mayoría de los escenarios.

• On: deshabilita la renovación de la sesión. El temporizador comienza cuando el usuario entra al origen y no se restablece. Una vez que expira, el usuario vuelve a la cola aunque siga navegando. Más indicado para un control estricto de la duración de la visita, como en ventas flash.

Disable Session Renewal

Política para admitir usuarios desde la cola.

• Queuing Method: admite a los usuarios en el orden de sus solicitudes. Es la opción predeterminada recomendada.

• FIFO: selecciona usuarios de la cola de forma aleatoria. Diseñado para sorteos o escenarios donde el orden no importa.

• Random: envía a todos los usuarios nuevos a la página de espera sin admitir a ninguno. Útil para preparaciones previas a un evento, mantenimientos o emergencias.

• Reject All: todas las solicitudes omiten la cola y van directamente al origen. En la práctica, deshabilita la sala de espera. Utilice esta opción para restaurar el acceso normal después de un evento o durante pruebas.

Parámetro

Descripción

Custom Settings

Type: página de espera proporcionada por el sistema que muestra el tiempo estimado. Puede seleccionar una Default Waiting Room (Default Language Template, English o Simplified Chinese).

Traditional Chinese: le permite cargar una página HTML personalizada. Para usar esta función, comuníquese con su representante de ventas.

• Puede editar la plantilla o importar directamente un archivo .html (hasta 50 KB de tamaño).

• Puede usar variables dinámicas (como ${waitTime}) en el HTML para mostrar información de la cola.

Custom Waiting Room

Obtenga una vista previa de la página de espera en distintos estados, como Preview o Queuing.

Queue All

Propósito: proporciona el estado estructurado de la cola para clientes que no son navegadores (aplicaciones, miniapps).

Habilite este interruptor. Cuando una solicitud incluye el encabezado Accept: application/json, ESA devuelve el estado de la cola como JSON en lugar de una página HTML. JSON response parameter descriptions.

Flujo de interacción:

1. Primera solicitud: acceda a la URL de destino con el encabezado Accept: application/json.

2. Obtener y almacenar la cookie: los nodos de ESA responden al cliente con un campo Set-Cookie (la credencial de la cola de la sala de espera que identifica y rastrea el estado de cada usuario). El cliente debe guardar esta cookie específica de la sala de espera e incluirla en todas las solicitudes posteriores a los nodos de ESA.

3. Sondear el estado: incluya la cookie en cada solicitud. Vuelva a solicitar la URL en el intervalo que especifica el campo refreshIntervalSeconds del cuerpo de la respuesta.

4. Acceder al origen: cuando inWaitingRoom cambia a false, el cliente salió de la cola y puede acceder a los recursos de origen con la cookie.

Ejemplo de respuesta:

{
      "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

Código de estado HTTP que se devuelve a los usuarios en la cola. Valor predeterminado: 200. Cámbielo a otro código, como 202, según sea necesario.