Wenn Ihre Systeme, die die Intercom REST API aufrufen, von bekannten, festen IP-Adressen aus arbeiten, ermöglicht die REST API IP-Allowlist, 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-Allowlist 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 Allowlist für den API-Zugriff“ zurück.
Einrichten
Schalten Sie „REST API IP-Allowlist 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 Allowlist 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, das sich derzeit in der Beta-Phase befindet. Wenn Sie an dieser Funktion interessiert sind, wenden Sie sich bitte an den Support und fordern Sie sie an.