Passer au contenu principal

Restreindre l'accès à l'API REST par liste blanche d'IP

Utilisez la liste blanche d'IP de l'API REST pour restreindre les adresses IP pouvant appeler votre API REST Intercom.

Écrit par Penny Gray

Si vos systèmes qui appellent l'API REST Intercom fonctionnent à partir d'adresses IP fixes et connues, la liste blanche d'IP de l'API REST vous permet de faire en sorte que seules ces adresses puissent s'authentifier — même si une clé API est compromise.

Cela ajoute une couche de protection au niveau réseau en plus de l'authentification par jeton, réduisant le risque d'accès non autorisé depuis des emplacements inattendus.


Comment ça fonctionne

  • Intercom valide d'abord le jeton d'accès de la requête.

  • Si la liste blanche d'IP de l'API REST est activée et que votre liste contient des entrées, Intercom vérifie l'adresse IP source de la requête.

  • Si l'IP n'est pas autorisée, la requête renvoie une réponse 403 Forbidden avec le message « Votre adresse IP ne figure pas sur la liste blanche pour l'accès à l'API »

Configurer

Résumé du comportement

  • Fonction désactivée → toutes les IP sont autorisées

  • Fonction activée + liste vide → toutes les IP sont autorisées

  • Fonction activée + entrées → seules les IP/plages listées sont autorisées

  • IP non listée → 403 Forbidden

Note

  • IPv4 uniquement ; IPv6 n'est pas encore pris en charge.

  • S'applique à toutes les méthodes d'authentification de l'API REST (jetons OAuth ou clés API).

  • Ce contrôle est distinct des « Restrictions d'accès à l'espace de travail », qui régissent qui peut se connecter au tableau de bord Intercom ; les deux peuvent être utilisés ensemble.

Surveillance

Un journal d'activité des coéquipiers sera généré lors des modifications de la liste blanche, vous permettant de surveiller les changements.

Note : Pour surveiller l'activité réussie de l'API REST, vous pouvez consommer le sujet webhook api.request.completed.

Avez-vous trouvé la réponse à votre question ?