Edge Security Acceleration:Get started by creating a waiting room

Parâmetro

Descrição

Waiting Room Name

Defina um nome reconhecível, como promo_activity_room.

Waiting Room Name

A URL exata onde a sala de espera estará ativa. Aplica-se apenas ao Hostname and Path e Subdomain especificados. Exemplo: Se o hostname for event.example.com e o caminho for /route, a sala de espera se aplicará somente às solicitações para event.example.com/route.

Path

Os nós da ESA respondem ao cliente com um campo Set-Cookie (a credencial de enfileiramento da sala de espera usada para identificar e rastrear o status de cada usuário na fila). O cliente deve salvar esse cookie específico da sala de espera e incluí-lo em todas as solicitações subsequentes aos nós da ESA. O nome do cookie tem um prefixo fixo de Custom Cookie. Personalize o sufixo. Exemplo: __aliwaitingroom_promo_user.

Parâmetro

Descrição

Waiting Room Settings

Finalidade: Número máximo de usuários simultâneos permitidos no servidor de origem.

Descrição: Defina este valor com base na capacidade simultânea real da sua origem. Quando os usuários ativos atingirem esse limiar, novas solicitações entrarão na fila.

Nota: O valor mínimo é 200. Se sua origem suportar menos de 200 usuários simultâneos, defina este valor como 200 e use Total Active Users para controlar a taxa de admissão.

New Users per Minute

Finalidade: Número máximo de novos usuários admitidos da fila por minuto. Controla a taxa de crescimento da carga.

Descrição: Determina a velocidade de processamento da fila. Por exemplo, definir este valor como 300 admite até 300 usuários da página de espera por minuto.

Nota: O valor mínimo é 200. Deve ser menor ou igual a New Users per Minute.

Total Active Users

Finalidade: Tempo durante o qual a sessão de um usuário permanece válida após sair da fila.

Descrição: Se um usuário sair da origem (por exemplo, fechando a página) e retornar dentro deste período, ele pulará a fila. Padrão: 5 minutos.

Session Duration

Finalidade: Define se o temporizador da sessão do usuário é reiniciado durante a navegação ativa.

Nota: O nome da opção é oposto ao seu efeito:

• Off (Padrão): Ativa a renovação da sessão. Usuários ativos mantêm sua sessão viva e não voltam para a fila. Adequado para a maioria dos cenários.

• On: Desativa a renovação da sessão. O temporizador da sessão começa quando o usuário entra na origem e não é reiniciado. Após expirar, o usuário volta para a fila mesmo se ainda estiver navegando. Ideal para controle rigoroso da duração da visita, como em vendas relâmpago.

Disable Session Renewal

Política para admissão de usuários da fila.

• Queuing Method: Admite usuários na ordem das solicitações. Padrão recomendado.

• FIFO: Seleciona usuários da fila aleatoriamente. Mais indicado para sorteios ou cenários onde a ordem não importa.

• Random: Envia todos os novos usuários para a página de espera sem admitir nenhum. Útil para aquecimentos pré-evento, manutenção ou emergências.

• Reject All: Todas as solicitações ignoram a fila e vão diretamente para a origem. Desativa efetivamente a sala de espera. Use para restaurar o acesso normal após um evento ou para testes.

Parâmetro

Descrição

Custom Settings

Type: Uma página de espera fornecida pelo sistema que exibe o tempo estimado. Você pode selecionar um Default Waiting Room (Default Language Template, English ou Simplified Chinese).

Traditional Chinese: Permite fazer upload de uma página HTML personalizada. Para usar este recurso, entre em contato com seu representante de vendas.

• Edite o modelo ou importe diretamente um arquivo .html (tamanho máximo de 50 KB).

• Use variáveis dinâmicas (como ${waitTime}) no HTML para exibir informações da fila.

Custom Waiting Room

Visualize a página de espera em diferentes estados, como Preview ou Queuing.

Queue All

Finalidade: Fornece status estruturado da fila para clientes que não são navegadores (aplicativos, miniaplicativos).

Ative esta opção. Quando uma solicitação incluir o cabeçalho Accept: application/json, a ESA retornará o status da fila como JSON em vez de uma página HTML. Descrições dos parâmetros de resposta JSON.

Fluxo de interação:

1. Primeira solicitação: Acesse a URL de destino com o cabeçalho Accept: application/json.

2. Obtenha e armazene o cookie: Os nós da ESA respondem ao cliente com um campo Set-Cookie (a credencial de enfileiramento da sala de espera usada para identificar e rastrear o status de cada usuário na fila). O cliente deve salvar esse cookie específico da sala de espera e incluí-lo em todas as solicitações subsequentes aos nós da ESA.

3. Consulte o status: Inclua o cookie em cada solicitação. Solicite novamente a URL no intervalo especificado pelo campo refreshIntervalSeconds no corpo da resposta.

4. Acesse a origem: Quando inWaitingRoom mudar para false, o cliente terá saído da fila e poderá acessar os recursos de origem com o cookie.

Exemplo de resposta:

{
      "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 status HTTP retornado para usuários na fila. Padrão: 200. Altere para outro código, como 202, conforme necessário.