Saltar al contenido principal

Control de IPs habilitadas para acceder a la API

🔒 La API de Koncili tiene un mecanismo adicional de seguridad basado en IP, que garantiza que solo las direcciones autorizadas previamente puedan realizar llamadas autenticadas.

Cada gumgaToken está vinculado a una lista de IPs habilitadas, y solo esas direcciones pueden consumir los recursos del endpoint /externalapi/.

Consultar las IPs habilitadas​

  • Devuelve todas las IPs registradas y habilitadas para el gumgaToken actual.
  • Solo las IPs listadas pueden realizar llamadas a la API.

Habilitar una nueva IP​

  • Registra una nueva IP para el token de acceso informado, lo que permite su uso en la API.
  • Después del registro, la IP informada obtiene permiso inmediato para acceder a los endpoints protegidos de la API.

Eliminar una IP habilitada​

  • Elimina una IP autorizada anteriormente, deshabilitando su acceso a la API.
  • Después de la eliminación, la IP deja de tener acceso a la API, aunque siga usando el mismo gumgaToken.

⚙️ Buenas prácticas​

  • Mantén siempre actualizado el registro de IPs activas.
  • Elimina las direcciones que ya no estén en uso.
  • Si el ambiente de integración usa IP dinámica, comunícate con erp@koncili.com para recibir orientación sobre excepciones.