# 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](https://dts-identity.com/pt/docs/security/threat-protection.md), e dos **limites de objetos** por nível (quantos utilizadores, aplicações e assim por diante pode criar), documentados em [Planos e add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md#sizing-limits).

## 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çalho | Significado |
|---|---|
| `Retry-After` | Segundos a esperar antes de tentar de novo. |
| `X-RateLimit-Limit` | O número de pedidos permitido na janela. |
| `X-RateLimit-Remaining` | Pedidos ainda permitidos na janela atual. |
| `X-RateLimit-Reset` | Quando 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 [#machine-to-machine-token-requests]

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:

| Tier | Pedidos de token por minuto e por cliente |
|---|---|
| Trial | 30 |
| Free | 60 |
| Essential | 1.200 |
| Advanced | 6.000 |
| Pro | 30.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](https://dts-identity.com/pt/docs/integrations/apis.md#machine-to-machine-token-limits).

## 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](https://dts-identity.com/pt/docs/monitoring/rate-limits-and-blocked-ips.md). 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](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md#sizing-limits).

## Relacionado

- [Proteção contra ameaças](https://dts-identity.com/pt/docs/security/threat-protection.md), 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](https://dts-identity.com/pt/docs/monitoring/rate-limits-and-blocked-ips.md), para rever e libertar clientes bloqueados.
- [Planos e add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md#sizing-limits), para os limites de objetos por nível.
- [APIs](https://dts-identity.com/pt/docs/integrations/apis.md), para obter e utilizar tokens para a API REST.
