跳到主要内容

Configurar IP de Integração

Veja também

A QI Tech permite que você restrinja as chamadas à sua integração a uma lista de endereços IP públicos (ou ranges CIDR) previamente autorizados. Esse filtro é aplicado antes da validação de assinatura: requisições originadas de IPs fora da sua lista ativa serão recusadas com erro 403 Forbidden (GDF000029).

Como configurar​

Faça login na plataforma QI Tech, clique em "Meu perfil" no menu lateral esquerdo e entre na aba Integração. Role até a seção "Whitelist de IPs da API" e adicione um IP por vez no campo "IP / CIDR", clicando em "ADICIONAR IP" a cada inclusão.

Formatos aceitos:

  • Endereço IPv4 público (ex.: 189.10.20.30)
  • Range CIDR IPv4 com prefixo /24 ou maior (ex.: 200.100.50.0/24)
  • Endereço IPv6 público
  • Range CIDR IPv6 com prefixo /48 ou maior

Endereços privados/reservados (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 127.0.0.0/8, 169.254.0.0/16) não são aceitos.

Período de ativação (48 horas)​

Atenção!

Por motivos de segurança, todo IP cadastrado pelo painel fica em status Pendente por 48 horas antes de se tornar ativo automaticamente. Durante esse período o IP é registrado mas não autoriza requisições — quem está na sua whitelist ativa atual continua valendo.

Você receberá um e-mail de confirmação no cadastro do IP e outro quando ele passar para o status Ativo.

Após as 48 horas, o IP migra automaticamente para Ativo e passa a ser autorizado a chamar a API.

Ativação emergencial​

Liberação imediata

Se você precisar liberar um IP antes das 48 horas (ex.: migração de servidor não planejada, incidente de produção), entre em contato com nosso suporte por meio dos canais oficiais e solicite a ativação manual informando:

  • O IP / CIDR cadastrado
  • A client_integration_key da sua integração
  • O motivo da urgência

Nossa equipe de operações fará a promoção manual e o IP entrará em vigor imediatamente.

Erros comuns​

CódigoCausaSolução
403 / GDF000029Requisição partiu de um IP que não está em status Ativo na sua whitelistVerifique na tela de Integração quais IPs estão ativos. Se o IP recém-cadastrado ainda está Pendente, aguarde as 48h ou solicite ativação manual.
Cadastro de IP rejeitadoIP/CIDR inválido, privado, ou range muito grande (prefixo menor que /24 IPv4 ou /48 IPv6)Use somente endereços públicos e respeite os tamanhos mínimos de prefixo.