Direcciones IP
Las direcciones IP de salida y de entrada que debes permitir en tu firewall para los webhooks de HelpFalcon, el proxy de apps y el conector de datos de clientes. Direcciones actuales de la beta privada, con aviso antes de cambiar.
Traducido para tu comodidad. El código, los nombres de campos y la referencia de la API siguen en inglés. Versión en inglés
Permite estas direcciones en tu firewall si tus endpoints solo aceptan tráfico de orígenes conocidos. Cubren los webhooks, las acciones de webhook en disparadores y automatizaciones, el proxy de las apps de la barra lateral, el conector de datos de clientes, el descubrimiento SSO y las peticiones de token para usuarios finales, y cualquier otra llamada HTTP que HelpFalcon haga en tu nombre.
Direcciones de la beta privada
HelpFalcon está en beta privada en un único servidor en Falkenstein, Alemania, así que un solo par de direcciones cubre ambas direcciones del tráfico.
| Sentido | IPv4 | IPv6 |
|---|---|---|
| Salida (peticiones que te enviamos) | 2.31.172.241 | 2a01:4f8:c015:94d4::1 |
| Entrada (adonde apunta tu DNS para un dominio propio del centro de ayuda) | 2.31.172.241 | 2a01:4f8:c015:94d4::1 |
Permite tanto la dirección IPv4 como la IPv6: cuál usamos depende de tu DNS.
La lista legible por máquinas
También hay un endpoint legible por máquinas, con la forma del GET /api/v2/ips de Zendesk:
GET https://api.helpfalcon.com/public/ips.json{
"ips": {
"egress": { "all": ["2.31.172.241/32", "2a01:4f8:c015:94d4::1/128"] },
"ingress": { "all": ["2.31.172.241", "2a01:4f8:c015:94d4::1"] }
}
}Durante la beta privada el endpoint todavía no responde, así que toma las direcciones de la tabla de arriba. Cuando responda, léelas de ahí en lugar de copiarlas en el código; lo anunciaremos en el registro de cambios de la API.
Estas direcciones cambian con el lanzamiento público
La tabla de arriba es la de la beta privada, no la lista final. En el lanzamiento público la plataforma pasa a su clúster de producción, con gateways NAT y balanceadores de carga de borde por región, y las direcciones cambian. Ese traslado es el único cambio previsto.
Antes de que cambie cualquier dirección:
- las nuevas direcciones se publican aquí y en
/public/ips.jsonal menos 30 días antes de mover tráfico, - las direcciones antiguas y las nuevas funcionan durante esos 30 días,
- los administradores de los espacios de trabajo reciben un correo.
Si no puedes permitir un rango a mano con poco margen, escríbenos a hello@helpfalcon.com y planificaremos el cambio contigo.
Estabilidad entre despliegues
En la beta las direcciones pertenecen al servidor, no a un contenedor, así que los despliegues, reinicios y el escalado nunca las cambian. Tras el lanzamiento pertenecen al gateway NAT y al balanceador de borde de la región, no a pods ni nodos, por la misma razón.
Entrada, para dominios propios del centro de ayuda
Si apuntas tu propio dominio a tu centro de ayuda de HelpFalcon, usa un CNAME a hc.helpfalcon.com siempre que tu proveedor de DNS lo permita: así nunca tendrás que preocuparte por estas direcciones. Usa los registros A y AAAA de arriba solo para un dominio raíz cuyo proveedor no admita CNAME (descrito también en usar tu propio dominio), y cuenta con actualizarlos en el lanzamiento.
No es un método de autenticación
Una lista de permitidos es una segunda capa útil, pero no tomes la dirección de origen de una petición como prueba de que viene de nosotros. Verifica la firma del webhook en cada entrega; esa es la comprobación que importa.