Pular para o conteúdo principal

Controle de IPs habilitados para acesso à API

🔒 A API do Koncili possui um mecanismo adicional de segurança baseado em IP, garantindo que apenas endereços previamente autorizados possam realizar chamadas autenticadas.

Cada gumgaToken está vinculado a uma lista de IPs liberados, e somente esses endereços podem consumir os recursos do endpoint /externalapi/.

Consultar IPs habilitados​

  • Retorna todos os IPs cadastrados e habilitados para o gumgaToken atual.
  • Somente os IPs listados podem realizar chamadas à API.

Habilitar novo IP​

  • Registra um novo IP para o token de acesso informado, permitindo seu uso na API.
  • Após o registro, o IP informado passa a ter permissão imediata para acessar os endpoints protegidos da API.

Remover IP habilitado​

  • Remove um IP anteriormente autorizado, desabilitando seu acesso à API.
  • Após a remoção, o IP deixa de ter acesso à API, mesmo que ainda utilize o mesmo gumgaToken.

⚙️ Boas práticas​

  • Sempre mantenha atualizado o cadastro de IPs ativos.
  • Remova endereços que não estejam mais em uso.
  • Caso o ambiente de integração utilize IP dinâmico, entre em contato com erp@koncili.com para orientação sobre exceções.