Configurar IP de Integração
As chamadas à API do Insurance-as-a-Service são restritas a uma lista de endereços IP públicos previamente autorizados para a sua integração. Uma requisição originada de um IP fora da lista é recusada, por mais correta que seja a sua assinatura.
Como configurar
No Insurance-as-a-Service o cadastro dos IPs não está disponível pelo portal QI Tech. A lista é registrada pelo time de Integração da QI Tech.
Envie a relação dos endereços IP públicos de onde a sua integração fará as chamadas para api@qitech.com.br, informando o ambiente (sandbox ou produção) de cada endereço.
O que é aceito em cada entrada:
- Um endereço IPv4 público, individual (ex.:
189.10.20.30) - Um endereço IPv6 público, individual
Cada endereço é comparado exatamente como foi cadastrado, portanto informe um endereço por entrada — inclusive quando eles forem vizinhos na mesma faixa.
Informe todos os endereços de uma vez no onboarding da sua integração. Incluir um endereço depois exige uma nova solicitação ao time de Integração, e até que ela seja processada as chamadas partindo dele são recusadas.
Avise-nos antes de passar a chamar a API a partir de uma rede nova — um novo escritório, uma VPN, um NAT gateway adicional ou um runner de CI. O cadastro passa a valer imediatamente após ser registrado, mas só depois de ser registrado.
Possíveis erros
Todo erro (non-2xx) retorna o corpo padrão de erro — trate programaticamente apenas o campo code.
| Status | Código | Descrição |
|---|---|---|
403 | EGW000007 | O IP de origem da requisição não está na lista de IPs permitidos da integração. |
{
"title": "Forbidden",
"description": "The request source IP is not in the integration's allowed IP list.",
"translation": "O IP de origem da requisição não está na lista de IPs permitidos da integração.",
"code": "EGW000007",
"extra_fields": {}
}
Se você receber esse erro, confirme qual endereço a sua infraestrutura está de fato usando para sair (o IP público de saída pode não ser o do servidor, no caso de NAT, proxy ou balanceador) e compare com a lista que você nos enviou.