Adresses IP | Développeurs

Traduit pour votre confort. Le code, les noms de champs et la référence de l'API restent en anglais. Version anglaise

Autorisez ces adresses dans votre pare-feu si vos endpoints n’acceptent que du trafic de sources connues. Elles couvrent les webhooks, les actions webhook des déclencheurs et automatisations, le proxy des apps de la barre latérale, le connecteur de données clients, la découverte SSO et les requêtes de token des utilisateurs finaux, et tout autre appel HTTP que HelpFalcon fait pour vous.

Adresses de la bêta privée

HelpFalcon est en bêta privée sur un seul serveur à Falkenstein, en Allemagne : une seule paire d’adresses couvre donc les deux sens.

Sens	IPv4	IPv6
Sortant (requêtes que nous vous envoyons)	`2.31.172.241`	`2a01:4f8:c015:94d4::1`
Entrant (cible de votre DNS pour un domaine personnalisé du centre d’aide)	`2.31.172.241`	`2a01:4f8:c015:94d4::1`

Autorisez l’adresse IPv4 et l’adresse IPv6 : celle que nous utilisons dépend de votre DNS.

La liste lisible par machine

Il existe aussi un endpoint lisible par machine, au format du 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"] }
  }
}

Pendant la bêta privée, l’endpoint ne répond pas encore : prenez les adresses dans le tableau ci-dessus. Dès qu’il répondra, lisez-les là plutôt que de les copier dans votre code ; nous l’annoncerons dans le journal des modifications de l’API.

Ces adresses changent au lancement public

Le tableau ci-dessus est celui de la bêta privée, pas la liste définitive. Au lancement public, la plateforme passe sur son cluster de production, avec des passerelles NAT et des répartiteurs de charge en bordure par région, et les adresses changent. Ce déménagement est le seul changement prévu.

Avant tout changement d’adresse :

les nouvelles adresses sont publiées ici et dans /public/ips.json au moins 30 jours avant tout déplacement du trafic,
les anciennes et les nouvelles adresses fonctionnent pendant ces 30 jours,
les administrateurs des espaces de travail reçoivent un e-mail.

Si vous ne pouvez pas autoriser une plage à la main dans un court délai, écrivez-nous à hello@helpfalcon.com et nous planifierons la bascule avec vous.

Stabilité entre les déploiements

Pendant la bêta, les adresses appartiennent au serveur, pas à un conteneur : déploiements, redémarrages et mises à l’échelle ne les changent jamais. Après le lancement, elles appartiennent à la passerelle NAT et au répartiteur de charge de la région, pas aux pods ni aux nœuds, pour la même raison.

Entrant, pour les domaines personnalisés du centre d’aide

Si vous faites pointer votre propre domaine vers votre centre d’aide HelpFalcon, utilisez un CNAME vers hc.helpfalcon.com partout où votre fournisseur DNS le permet : vous n’aurez alors jamais à vous soucier de ces adresses. Utilisez les enregistrements A et AAAA ci-dessus uniquement pour un domaine apex dont le fournisseur ne gère pas le CNAME (décrit aussi dans utiliser votre propre domaine), et prévoyez de les mettre à jour au lancement.

Pas une méthode d’authentification

Une liste d’autorisation est une deuxième couche utile, mais ne considérez pas l’adresse source d’une requête comme la preuve qu’elle vient de nous. Vérifiez la signature du webhook à chaque livraison ; c’est ce contrôle qui compte.