Wenn Ihre Systeme, die die Intercom REST API aufrufen, von bekannten, festen IP-Adressen aus arbeiten, ermöglicht die REST API-IP-Whitelist, dass nur diese Adressen sich authentifizieren können – selbst wenn ein API-Schlüssel kompromittiert wird.
Dies fügt eine netzwerkbasierte Schutzebene zusätzlich zur tokenbasierten Authentifizierung hinzu und verringert das Risiko unbefugten Zugriffs von unerwarteten Standorten.
Funktionsweise
Intercom validiert zuerst das Zugriffstoken der Anfrage.
Wenn die REST API-IP-Whitelist aktiviert ist und Ihre Liste Einträge enthält, prüft Intercom die Quell-IP der Anfrage.
Ist die IP nicht erlaubt, gibt die Anfrage eine
403 Forbidden-Antwort mit der Nachricht „Ihre IP-Adresse steht nicht auf der Whitelist für den API-Zugriff“ zurück.
Einrichten
Schalten Sie „REST API-IP-Whitelist aktivieren“ ein.
Geben Sie IPv4-Adressen oder CIDR-Bereiche (kommagetrennt) ein, z. B.:
203.0.113.42
203.0.113.0/24
Klicken Sie oben auf der Seite auf Speichern.
Verhaltensübersicht
Funktion aus → alle IPs erlaubt
Funktion an + leere Liste → alle IPs erlaubt
Funktion an + Einträge → nur gelistete IPs/Bereiche erlaubt
IP nicht auf der Liste → 403 Forbidden
Hinweis
Nur IPv4; IPv6 wird noch nicht unterstützt.
Gilt für alle REST API-Authentifizierungsmethoden (OAuth-Tokens oder API-Schlüssel).
Diese Steuerung ist getrennt von den „Workspace-Zugriffsbeschränkungen“, die regeln, wer sich im Intercom-Dashboard anmelden kann; beide können zusammen verwendet werden.
Überwachung
Ein Aktivitätsprotokoll für Teammitglieder wird erstellt, wenn Änderungen an der Whitelist vorgenommen werden, sodass Sie Änderungen überwachen können.
Hinweis: Um erfolgreiche REST API-Aktivitäten zu überwachen, können Sie das api.request.completed webhook-Thema nutzen.


