IP-Adressen | Entwickler

Zur besseren Verständlichkeit übersetzt. Code, Feldnamen und die API-Referenz bleiben auf Englisch. Englische Fassung

Geben Sie diese Adressen in Ihrer Firewall frei, wenn Ihre Endpunkte nur Datenverkehr aus bekannten Quellen annehmen. Sie gelten für Webhooks, Webhook-Aktionen in Triggern und Automatisierungen, den Proxy der Seitenleisten-Apps, den Kundendaten-Connector, SSO-Discovery und Token-Anfragen für Endnutzer und jeden anderen HTTP-Aufruf, den HelpFalcon in Ihrem Auftrag macht.

Adressen der privaten Beta

HelpFalcon läuft in der privaten Beta auf einem einzelnen Server in Falkenstein, Deutschland, daher deckt ein Adresspaar beide Richtungen ab.

Richtung	IPv4	IPv6
Ausgehend (Anfragen, die wir an Sie senden)	`2.31.172.241`	`2a01:4f8:c015:94d4::1`
Eingehend (worauf Ihr DNS für eine eigene Hilfe-Center-Domain zeigt)	`2.31.172.241`	`2a01:4f8:c015:94d4::1`

Geben Sie sowohl die IPv4- als auch die IPv6-Adresse frei: Welche wir nutzen, hängt von Ihrem DNS ab.

Die maschinenlesbare Liste

Es gibt auch einen maschinenlesbaren Endpunkt im Format von Zendesks GET /api/v2/ips:

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"] }
  }
}

Während der privaten Beta antwortet der Endpunkt noch nicht, nehmen Sie die Adressen daher aus der Tabelle oben. Sobald er antwortet, lesen Sie sie dort, statt sie in Code zu kopieren; wir kündigen das im API-Änderungsprotokoll an.

Diese Adressen ändern sich zum öffentlichen Start

Die Tabelle oben gilt für die private Beta, nicht als endgültige Liste. Zum öffentlichen Start zieht der Stack auf seinen Produktionscluster mit NAT-Gateways und Edge-Load-Balancern pro Region, und die Adressen ändern sich. Dieser Umzug ist die einzige geplante Änderung.

Bevor sich eine Adresse ändert:

werden die neuen Adressen hier und in /public/ips.json mindestens 30 Tage vor jeder Verlagerung des Datenverkehrs veröffentlicht,
funktionieren in diesen 30 Tagen alte und neue Adressen,
erhalten Workspace-Administratoren eine E-Mail.

Wenn Sie einen Bereich nicht kurzfristig von Hand freigeben können, schreiben Sie uns an [email protected], und wir planen die Umstellung mit Ihnen.

Stabilität zwischen Deploys

In der Beta gehören die Adressen zum Server, nicht zu einem Container, daher ändern Deploys, Neustarts und Skalierung sie nie. Nach dem Start gehören sie aus demselben Grund zum NAT-Gateway und Edge-Load-Balancer der Region, nicht zu Pods oder Nodes.

Eingehend, für eigene Hilfe-Center-Domains

Wenn Sie Ihre eigene Domain auf Ihr HelpFalcon-Hilfe-Center zeigen lassen, nutzen Sie einen CNAME auf hc.helpfalcon.com, wo immer Ihr DNS-Anbieter das erlaubt: Dann müssen Sie sich um diese Adressen nie kümmern. Nutzen Sie die A- und AAAA-Einträge oben nur für eine Apex-Domain, deren Anbieter keinen CNAME kann (auch beschrieben unter eigene Domain nutzen), und rechnen Sie damit, sie zum Start zu aktualisieren.

Keine Authentifizierungsmethode

Eine Allowlist ist eine nützliche zweite Schicht, aber werten Sie die Quelladresse einer Anfrage nicht als Beweis, dass sie von uns kommt. Prüfen Sie bei jeder Zustellung die Webhook-Signatur; das ist die Prüfung, auf die es ankommt.