Administrar su firewall desde su propio código
Permita o bloquee direcciones en un servidor o en todos, dé acceso a los agentes desde casa cuando empieza su turno y entérese de cada cambio, con la API de VICIfast.
Su servidor y solución de problemas · 3 min de lectura
Todo lo que se hace en la ventana Firewall de un servidor puede hacerse desde su propio código con la API de VICIfast: permitir o bloquear una dirección en un servidor, en varios o en todos a la vez; cambiar la configuración del firewall; agregar reglas de país programadas; bloquear o restablecer la MFA de un agente; y leer los intentos de inicio de sesión de los agentes y el registro de auditoría del firewall. Está disponible en todos los planes.
Obtener una clave
- En el panel, abra API, luego Claves, y cree una clave de producción (vf_live_).
- Marque firewall:read para leer reglas, configuración, intentos y el registro de auditoría. Marque también firewall:write para cambiar cualquier cosa.
- Opcionalmente, limite la clave a las direcciones desde las que se ejecuta su código. Las claves de prueba (vf_test_) no tienen sandbox de firewall: un cambio en el firewall no cuesta nada, así que use una clave de producción.
Qué puede abrir una regla
- Una regla de permiso con el perfil de agente (el predeterminado) abre la pantalla del agente (443), el webphone (8089) y SIP.
- Una regla de permiso con el perfil de carrier abre solo SIP.
- La API nunca abre SSH. Las reglas de administrador, que agregan SSH, se agregan desde el panel, y la API no tiene ninguna opción para desactivar el firewall.
- Una dirección por regla. Los rangos se rechazan; para dar acceso a toda una región, agregue una regla de país programada. IPv6 se rechaza porque el firewall del servidor no puede aplicarlo.
- Una regla de bloqueo impide el acceso de una dirección a todos los puertos.
Dar acceso a un agente desde casa
Su propio sistema de inicio de sesión puede dar acceso a un agente cuando empieza su turno: POST /api/v1/servers/{server id}/firewall/rules con action allow, la ip del agente, su vicidial_user y expires_in_hours (12 para un turno). La regla aparece bajo ese agente en la pestaña Agentes, y un agente tiene una regla por dirección: enviarla de nuevo reemplaza la anterior.
Muchos servidores a la vez
- POST /api/v1/firewall/rules con servers en "all" (o una lista de IDs de servidor) agrega una regla en todos lados, por ejemplo la dirección de una oficina nueva. Cada servidor responde por sí mismo, así que uno que ya tiene la regla no detiene al resto.
- POST /api/v1/firewall/rules/remove quita una dirección de todos los servidores, por ejemplo cuando un agente se va.
- GET /api/v1/firewall/rules?ip=… muestra todos los servidores en los que una dirección tiene acceso o está bloqueada.
Clústeres
Un clúster tiene un solo firewall. Indique cualquiera de sus servidores y la regla se agrega al firewall del clúster, copiada en cada servidor que este cubre: todos, o los marcadores de un carrier. Eliminarla quita todas las copias.
Webhooks
Agregue un endpoint de webhook (API, luego Webhooks) para firewall_rule.created, firewall_rule.updated, firewall_rule.deleted y firewall_rule.expired y así enterarse de cada cambio, ya sea desde el panel, la API o un agente que inicia sesión a través del portal del firewall o la app. Cada evento incluye la regla y changed_via.
Referencia
Cada endpoint, campo y error está en la referencia de la API en /api-docs, en Firewall. Los cambios hechos mediante la API aparecen en el registro de auditoría del firewall del servidor con la clave que los hizo.

