IPs oficiais dos webhooks da Raims

Todos os webhooks enviados pela Raims utilizam os IPv4 listados nesta página. Adicione os cinco endereços à lista de permissões da infraestrutura que protege o seu endpoint de recebimento.

IPs de origem dos webhooks

18.230.162.249
54.94.189.157
54.21.10.37
54.233.100.88
54.232.137.193

Permita todos os endereços: uma entrega pode partir de qualquer um deles. Se a ferramenta exigir a notação CIDR, acrescente /32 a cada IPv4 para autorizar somente aquele endereço.

Produção e Sandbox

Os webhooks de Produção e Sandbox utilizam os mesmos cinco IPs. Libere essa lista no firewall também nos testes de integração em Sandbox; não há uma lista adicional de endereços para esse ambiente.

Quando configurar a lista de permissões

Configure a lista quando o acesso ao endpoint depender de uma regra de origem, como em um firewall, WAF, Security Group, proxy reverso ou balanceador de carga. Em uma infraestrutura que já aceita requisições públicas, confira se alguma outra regra pode bloquear os webhooks.

Configure o acesso ao endpoint

1. Localize a camada que controla o acesso ao endereço cadastrado para receber os webhooks.
2. Adicione os cinco IPv4 oficiais como origens permitidas.
3. Restrinja a regra ao domínio e ao caminho do endpoint de webhook, quando a ferramenta permitir. Autorize as requisições POST recebidas por HTTPS.
4. Confira se outras regras de segurança continuam bloqueando a requisição, mesmo depois de o IP ter sido permitido.

Se o endpoint for exclusivo para webhooks da Raims, você pode restringir suas origens a essa lista. Preserve o acesso necessário às outras rotas da aplicação; não aplique essa restrição ao site inteiro.

Cloudflare e outros proxies

Se o domínio utiliza o proxy da Cloudflare, configure a lista de IPs da Raims nas regras de entrada da Cloudflare. O servidor de origem recebe a conexão da Cloudflare, por isso seu firewall precisa continuar permitindo os endereços do proxy. Restringir esse firewall diretamente aos cinco IPs da Raims pode bloquear as requisições encaminhadas.

O mesmo cuidado vale para outros proxies e balanceadores. Ao usar um cabeçalho como CF-Connecting-IP ou X-Forwarded-For para identificar a origem, aceite essa informação somente de proxies confiáveis. Um cabeçalho enviado diretamente por um cliente não comprova o IP de origem.

Consulte a documentação da Cloudflare sobre endereços IP e exceções de WAF para configurar sua infraestrutura.

Valide a configuração

Depois de salvar as regras, acompanhe uma entrega de webhook:

1. Confira nos registros do firewall, WAF ou proxy se a requisição foi permitida.
2. Confirme nos registros da aplicação que o POST chegou ao endpoint correto.
3. Se houver uma resposta 403 Forbidden, identifique qual camada a gerou e revise a regra correspondente. Outras regras de WAF ou da própria aplicação podem recusar a requisição mesmo quando o IP já está permitido.

Se não houver registro da requisição na aplicação, confira também o endereço cadastrado, a resolução DNS, o certificado HTTPS e as regras das camadas que ficam antes do servidor.