As regras de limitação de parâmetro hotspot para requisições HTTP aplicam controle granular a parâmetros individuais em requisições recebidas por aplicações que fornecem web services. Para aplicações que utilizam frameworks web populares, como contêineres Servlet, Spring Web e Spring Boot, o Microservices Engine (MSE) analisa os parâmetros da requisição no nível da API. Isso permite limitar as chamadas de recursos por dimensão de requisição, protegendo seus serviços e a estabilidade do sistema. Este tópico descreve como configurar uma regra de limitação de parâmetro hotspot para requisições HTTP em uma aplicação.
As regras de limitação de parâmetro hotspot para requisições HTTP eram anteriormente conhecidas como regras de proteção de aplicação web.
Informações básicas
Em cenários de web service, a proteção por limitação de chamadas de recursos baseada em dimensões — como o endereço IP de origem ou um parâmetro da requisição — complementa a limitação e a degradação no nível da API, ajudando a manter suas aplicações funcionando conforme o esperado. Por exemplo, em cenários web de alto tráfego, talvez seja necessário limitar não apenas a API atual, mas também o endereço IP de origem com maior frequência de acesso ou o ID de product mais acessado. Os exemplos a seguir ilustram esses casos:
Limite o ID de product comprado com mais frequência em um determinado período para evitar penetração de cache, que envia um grande volume de requisições ao banco de dados.
Restrinja o endereço IP de origem que envia um alto volume de requisições em curto espaço de tempo para impedir requisições em massa fraudulentas que submetem informações falsas.
Observações de uso
Antes de configurar uma regra de limitação de parâmetro hotspot para requisições HTTP, revise os comportamentos e limites a seguir:
Resolução de IP do cliente — Se você definir Parameter Properties como Client IP e a requisição passar por um proxy, o MSE tentará primeiro obter o endereço IP do cabeçalho de requisição
X-Forwarded-For. Caso esse cabeçalho contenha um endereço IP, o MSE o utilizará como o endereço IP real do cliente.Resposta a uma requisição limitada — Uma requisição rejeitada retorna a mensagem personalizada configurada no gerenciamento de comportamento. Se nenhuma mensagem personalizada estiver definida, o comportamento padrão será aplicado: código de erro HTTP 429 e a mensagem de texto padrão.
Teto de limiar para fila — Ao utilizar Waiting in line, não defina o QPS com valor superior a 1.000 (intervalo de requisição de 1 ms).
Procedimento
Faça login no console do MSE e selecione uma região na barra de navegação superior.
No painel de navegação à esquerda, escolha Microservices Governance > Application Governance.
Na página Application list, clique em no cartão de recursos da aplicação desejada.
Após acessar a aplicação, escolha API Details no painel de navegação à esquerda, clique em na aba Hotspot Parameter Protection (HTTP Requests) e, em seguida, clique em New.
-
Na caixa de diálogo Hotspot Parameter Protection (HTTP Requests), configure as informações da regra e clique em New.
Defina as informações da regra com base nas descrições em Parameters.
Na lista de regras, selecione a regra criada e clique em Open na coluna Status.
Na caixa de diálogo Tips, clique em OK para ativar a regra de proteção configurada.
Parâmetros
A tabela a seguir descreve os parâmetros da caixa de diálogo Hotspot Parameter Protection (HTTP Requests). Uma linha sem descrição indica a etapa de configuração ou a seção da caixa de diálogo que contém os parâmetros listados logo abaixo. Para obter detalhes sobre a regra de resolução de IP do cliente, a resposta retornada a uma requisição limitada e o teto de limiar para fila, consulte Usage notes. Para exemplos que mapeiam cenários a conjuntos de valores, veja Use cases.
|
Parâmetro |
Descrição |
|
Configure Protection Rule |
|
|
Parameter Properties |
Aplica limitação com base em uma propriedade de parâmetro da API selecionada. Para ver as propriedades suportadas, consulte Parameter property values. |
|
(Opcional) Match Pattern e Match String |
Disponível quando você define Parameter Properties como Header ou URL Parameters. Ative a chave Property Value Match e especifique Match Pattern e Match String. Para os padrões suportados, consulte Match patterns. |
|
Threshold Type |
O valor padrão é Number of requests. |
|
Threshold |
Limiar de QPS do objeto estatístico que aciona a limitação da API. Ao definir o limiar, selecione um intervalo estatístico. Há suporte para segundo, minuto, hora e dia. Por exemplo, se você definir o limiar como 10 e selecionar Points como intervalo, no máximo 10 requisições serão permitidas por minuto. |
|
Advanced Options |
|
|
Flow Control Method |
Especifica como o tráfego limitado é tratado. Para os métodos suportados, consulte Flow control methods. |
|
Burst size |
Caso defina Flow Control Method como Fast failure, é possível especificar um tamanho de burst adicional, que corresponde ao número extra de requisições permitidas para picos de tráfego. |
|
Timeout time |
Se você configurar Flow Control Method como Waiting in line, deverá especificar um tempo limite em milissegundos (ms). Por exemplo, se o QPS for 5, apenas uma requisição passa a cada 200 ms, e as requisições excedentes entram em fila. O tempo limite representa o tempo máximo de espera na fila. Requisições que ultrapassarem esse tempo são rejeitadas. |
|
Whether to open |
Enabled: A regra de limitação de parâmetro hotspot para requisições HTTP entra em vigor imediatamente após a criação. Disabled: A regra não entra em vigor após a criação. |
|
Configure Protection Behavior |
|
|
Association Behavior |
Define o comportamento pós-limitação da regra. Para as opções disponíveis, consulte Association behavior options. |
Valores de propriedade do parâmetro
Os seguintes valores são suportados para Parameter Properties:
Client IP: Endereço IP do cliente que envia a requisição.
Remote Host: Cabeçalho Host do cliente que envia a requisição.
Header: A limitação baseia-se no cabeçalho HTTP especificado. Se você inserir uma chave de cabeçalho específica, a regra limitará separadamente os valores hotspot sob essa chave. Após selecionar Header, configure uma política de correspondência para o valor do atributo da requisição. Apenas os valores de atributo correspondentes ao padrão serão contabilizados e limitados.
URL Parameters: A limitação baseia-se no parâmetro de requisição HTTP especificado. É necessário inserir o nome do parâmetro correspondente. Após selecionar URL Parameters, configure uma política de correspondência para o valor do atributo da requisição. Somente os valores de atributo correspondentes ao padrão serão contabilizados e limitados.
Padrões de correspondência
Valores válidos para Match Pattern:
accurate: Corresponde estritamente aos valores em relação à string de correspondência especificada.
Substring: Corresponde se o valor do atributo da requisição contiver a substring. Por exemplo, se a substring for
ab, tantoabaquantocabcserão correspondidos, mascbanão.Regular: Corresponde aos valores usando a expressão regular especificada.
Métodos de controle de fluxo
Os seguintes valores são suportados para Flow Control Method:
Fast failure: Se o tipo de limiar for QPS, o tráfego limitado falha rapidamente. Ou seja, as requisições são rejeitadas imediatamente ao atingir o limiar.
Waiting in line: Quando o tipo de limiar for QPS, as requisições limitadas passam a uma taxa constante e podem entrar em fila. É obrigatório especificar um tempo limite. Uma requisição cuja previsão de espera atinja o tempo limite falha imediatamente, sem entrar na fila. Por exemplo, se o QPS for 10, apenas uma requisição passa a cada 100 ms, e as requisições excedentes entram em fila. O tempo limite define a espera máxima. Requisições que excederem esse tempo são rejeitadas.
Opções de comportamento associado
Os seguintes valores são suportados para Association Behavior:
Default Behavior: Opção padrão. Utilize este comportamento caso não precise personalizar a ação pós-limitação.
-
New behavior: Adiciona um comportamento personalizado pós-limitação. Após criar o comportamento, selecione-o na lista suspensa Association Behavior.
Casos de uso
Cada um dos exemplos a seguir mapeia um cenário aos valores de parâmetro necessários na caixa de diálogo Hotspot Parameter Protection (HTTP Requests). Configure os parâmetros não listados em um exemplo, como Whether to open, conforme descrito em Parameters.
Venda relâmpago de um product popular
Em cenários como vendas relâmpago, o alto tráfego pode tornar a resposta do sistema lenta ou até mesmo derrubá-lo. Para manter a estabilidade, configure uma regra de limitação de parâmetro hotspot para requisições HTTP. Quando o limiar especificado for excedido, o sistema rejeitará o tráfego excedente para o product popular.
Por exemplo, para permitir no máximo 100 requisições de pedido por segundo para cada ID individual de product popular e rejeitar todas as requisições excedentes para esse product, configure os seguintes parâmetros:
Defina Parameter Properties como URL Parameters.
Em URL Parameter Name, insira
stockId.Configure Threshold para 100 requisições por Second.
Escolha Flow Control Method como Fast failure.
Para Parameter Properties, selecione o campo de parâmetro que carrega o ID do product popular atual. Neste exemplo, os parâmetros de URL contêm um campo stockId que transporta o ID do product requisitado.
Requisições em massa fraudulentas durante uma promoção
Durante promoções, um grande número de requisições em massa fraudulentas pode consumir o estoque de produtos ou recursos do servidor. Nesse caso, aplique Waiting in line aos endereços IP de origem das requisições para que elas passem a uma taxa constante, evitando que o excesso afete a estabilidade do service.
Por exemplo, configure os seguintes parâmetros. As requisições enviadas por cada endereço IP de origem diferente para esta API passarão a uma taxa constante de uma requisição a cada 10 ms (1 s/100 = 10 ms), e as requisições excedentes entrarão em fila. Uma requisição enfileirada que aguardar por mais de 30 ms falhará imediatamente.
Defina Parameter Properties como Client IP.
Mantenha o valor padrão Number of requests para Threshold Type.
Configure Threshold para 100 requisições por Second.
Escolha Flow Control Method como Waiting in line.
Em Timeout time, insira 30.
Defina Whether to open como Enabled.