Skip to Content

Limites de taxa

Como os pedidos são limitados por IP de cliente, o que recebe um cliente limitado (HTTP 429, cabeçalhos de limite) e onde estão os limites de objetos.

Para manter o serviço reativo e travar o abuso, a plataforma limita quantos pedidos um mesmo cliente pode fazer numa janela curta. Esta página explica a limitação de taxa de pedidos que se aplica ao início de sessão, à área da conta e à API REST, o que recebe um cliente limitado e em que difere das funcionalidades de proteção de contas documentadas noutro ponto.

A limitação de taxa aqui tratada diz respeito ao volume de pedidos. É distinta das defesas da superfície de início de sessão (limitação de taxa por IP, proteção contra força bruta, bloqueio de conta), abordadas em Proteção contra ameaças, e dos limites de objetos por nível (quantos utilizadores, aplicações e assim por diante pode criar), documentados em Planos e add-ons.

Como funciona a limitação de pedidos

  • Os pedidos são contados por endereço IP de cliente, não por utilizador nem por sessão, pelo que um autor de chamada não autenticado é limitado da mesma forma. Um cliente IPv6 é contado pelo respetivo prefixo /64, uma vez que uma ligação detém normalmente todo o prefixo.
  • A contagem é partilhada por toda a implementação. Uma vez que todos os nós leem o mesmo contador, um cliente não consegue passar mais pedidos ao alcançar um nó diferente.
  • O tráfego de início de sessão, de conta e da API REST é limitado. Quando um cliente excede o número de pedidos permitido na janela, os pedidos seguintes são rejeitados com HTTP 429 (Too Many Requests) até a janela mudar. O limite expira sozinho: o tráfego normal é retomado automaticamente assim que o cliente abranda.
  • Uma proteção separada, ao nível de toda a plataforma, defende contra inundações de grande volume (tentativas de denial-of-service), a acrescer à janela por IP.
  • Os e-mails que um autor de chamada não autenticado aciona para um endereço que introduz (verificação do registo, o respetivo reenvio, o link de reposição da palavra-passe) estão adicionalmente limitados a 5 por hora por endereço de destinatário, seja qual for o IP de onde vêm os pedidos. Para além disso, um novo pedido de registo ou de reposição para esse endereço é recusado, e um reenvio não envia nada, até ter passado a hora.

O que recebe um cliente limitado

Um pedido limitado à API REST ou de início de sessão devolve 429, juntamente com cabeçalhos que indicam ao cliente quando deve tentar de novo:

CabeçalhoSignificado
Retry-AfterSegundos a esperar antes de tentar de novo.
X-RateLimit-LimitO número de pedidos permitido na janela.
X-RateLimit-RemainingPedidos ainda permitidos na janela atual.
X-RateLimit-ResetQuando a janela é reposta, sob a forma de timestamp Unix (segundos).

Construa os clientes de modo a respeitarem estes cabeçalhos. Perante um 429, espere o Retry-After e volte a tentar, em vez de repetir imediatamente em ciclo. Ler o X-RateLimit-Remaining permite a um cliente bem comportado abrandar antes de ser limitado. Trate os cabeçalhos como o limite que vale; os números exatos podem mudar, e um cliente que os leia adapta-se automaticamente.

Pedidos de token machine-to-machine

Os tokens obtidos com o grant client credentials são limitados em separado, por cliente e não por endereço IP, uma vez que o token endpoint serve também inícios de sessão interativos e um serviço com comportamento incorreto não pode limitar os inícios de sessão de todos os que partilham a sua rede. O contingente depende da sua subscrição:

TierPedidos de token por minuto e por cliente
Trial30
Free60
Essential1.200
Advanced6.000
Pro30.000

Um cliente acima do seu limite recebe 429 com um cabeçalho Retry-After e o erro OAuth too_many_requests. Os inícios de sessão interativos nunca são afetados por este limite.

Um serviço que coloque o seu access token em cache e o reutilize até pouco antes de expirar precisa de cerca de um pedido de token por hora e fica muito abaixo do contingente de qualquer nível. Atingir o limite significa quase sempre que o cliente pede um token novo a cada chamada de API: corrija a colocação em cache, em vez de pedir um limite mais elevado. Os níveis de entrada têm ainda um orçamento mensal de tokens; ambos os limites estão documentados em APIs.

O que não é limitado desta forma

  • O bloqueio de contas e os bloqueios de IP resultantes de inícios de sessão falhados repetidos são um mecanismo diferente, configurado em Segurança e levantado em Monitoring → Limites de taxa e IPs bloqueados. Estes bloqueiam um IP específico ou trancam uma conta específica por um período mais longo e configurável; a limitação de pedidos apenas atrasa uma rajada de pedidos.
  • Os limites de objetos e de dimensionamento (número máximo de utilizadores, aplicações, ligações, políticas, zonas de rede, membros da equipa de administração) são determinados pela sua subscrição e licença, não pela taxa de pedidos. Consulte Planos e add-ons.

Relacionado

  • Proteção contra ameaças, que abrange a limitação de taxa por IP, a proteção contra força bruta, a deteção de palavras-passe comprometidas e a deteção de bots na superfície de início de sessão.
  • Limites de taxa e IPs bloqueados, para rever e libertar clientes bloqueados.
  • Planos e add-ons, para os limites de objetos por nível.
  • APIs, para obter e utilizar tokens para a API REST.

Nesta página