API Security Settings
Schützen Sie Ihren Zugriff mit IP Allowlist, Request Signing oder beidem. Richten Sie die Sicherheit für Address Label API und Risk Score API separat ein.
Öffnen Sie Settings → APIs → API Keys, suchen Sie die betreffende API und wählen Sie Security Settings. Erstellen Sie zuerst einen API-Schlüssel, falls noch keiner vorhanden ist.
Sicherheitsmethoden auswählen
IP Allowlist beschränkt den Zugriff auf die öffentlichen Ausgangs-IP-Adressen Ihrer Server.
Request Signing prüft Anfragen mithilfe eines API-Secrets, das Ihre Anwendung aufbewahrt.
Sind beide aktiviert, muss jede Anfrage beide Prüfungen bestehen. Das Aktivieren oder Deaktivieren eines Kontrollkästchens wendet die Änderung noch nicht an: Prüfen Sie die Konfiguration und wählen Sie Save Changes.
Eine gespeicherte Signaturkonfiguration mit späterer Durchsetzung gilt als abgeschlossene Sicherheitseinrichtung. Bis zum angezeigten Zeitpunkt gelten für unsignierte Anfragen weiterhin alle anderen aktiven Sicherheitsprüfungen.
IP Allowlist konfigurieren
Wählen Sie IP Allowlist.
Geben Sie öffentliche IPv4- oder IPv6-Ausgangsadressen Ihrer Server oder CIDR-Bereiche ein.
Fügen Sie mit Add IP einen Eintrag hinzu oder mit Bulk Add mehrere Einträge, jeweils einen pro Zeile.
Prüfen Sie die gesamte Liste und wählen Sie Save Changes. Bestätigen Sie die Änderungen, wenn Sie dazu aufgefordert werden.
Sie können höchstens 10 eindeutige Einträge pro API-Schlüssel speichern. Jede IP-Adresse oder jeder CIDR-Bereich zählt als ein Eintrag. Duplikate werden entfernt; überlappende Netzwerke werden nicht automatisch zusammengeführt.
Verwenden Sie öffentliche Ausgangsadressen, etwa die NAT-Gateway-Adressen Ihrer Anwendung. Die Browser-IP wird nicht automatisch hinzugefügt. Erfassen Sie vor dem Anwenden alle Ausgangs-IPs Ihrer Anwendungsserver.
Platzhalter (*, ?), Domains, URLs, Ports, IP-Bereiche als Start-/Endadresse, private Adressen, Loopback-Adressen und vollständig offene Bereiche wie 0.0.0.0/0 oder ::/0 werden nicht unterstützt.
Änderungen an IP Allowlist gelten sofort nach dem Speichern. Anfragen entfernter IPs werden abgelehnt. Bulk Add aktualisiert nur die ungespeicherte Liste; zum Anwenden wählen Sie Save Changes.
IP Allowlist bearbeiten oder deaktivieren
Bearbeiten und speichern Sie die Einträge, um die aktive Liste zu ersetzen. Zum Deaktivieren entfernen Sie die Auswahl bei IP Allowlist und speichern. Gespeicherte Einträge bleiben für die spätere Verwendung erhalten.
Benötigt Ihr Schlüssel zwingend Schutz, muss bereits eine andere Methode wirksam sein, bevor Sie den letzten aktiven Schutz entfernen. Beachten Sie beim Wechsel die Prüfungen in Security Settings.
Request Signing aktivieren
Wählen Sie Request Signing und erstellen Sie ein API-Secret.
Kopieren Sie das Secret und bewahren Sie es sicher auf. Es wird nur einmal angezeigt und kann nach Schließen des Dialogs nicht erneut eingesehen werden.
Wählen Sie I have saved this API secret.
Wählen Sie In 24 hours oder Immediately, danach Save Changes, und bestätigen Sie.
Mit In 24 hours funktioniert das neue Secret nach dem Speichern. Stellen Sie alle Anwendungen vor dem angezeigten Durchsetzungszeitpunkt auf signierte Anfragen um. Bis dahin unterliegen unsignierte Anfragen anderen Zugriffsregeln. Ungültige Signaturen werden auch während des Übergangs abgelehnt.
Mit Immediately benötigt jede Anfrage unmittelbar nach dem Speichern eine gültige Signatur. Stellen Sie vorher sicher, dass Ihre Anwendung bereit ist.
Signatur-Header, Codebeispiele und Fehlerbehebung finden Sie unter Request Signing. Testaufrufe sind echte Geschäftsanfragen und können API-Kontingent verbrauchen.
Signaturstatus
Not enabled
Die erste Signaturkonfiguration wurde noch nicht gespeichert.
Scheduled
Die Konfiguration wurde gespeichert; ab dem angezeigten Zeitpunkt sind signierte Anfragen erforderlich.
Active
Jede Anfrage muss eine gültige Signatur enthalten.
Während einer Secret-Rotation bleibt die Signatur Active. Not saved bei einem neu erstellten Secret bedeutet, dass der Austausch noch nicht angewendet wurde.
API-Secret rotieren
Rotieren Sie das Secret bei Verlust, Offenlegung oder fälligem Austausch. Der API-Schlüssel bleibt unverändert. Könnte das alte Secret offengelegt sein, wählen Sie Immediately; eine 24-stündige Überlappung lässt das alte Secret bis zum Ablauf oder Widerruf gültig.
Wählen Sie in Request Signing das Rotationssymbol, um ein neues Secret zu erstellen.
Kopieren und speichern Sie den neuen Wert sicher und bestätigen Sie die Speicherung.
Wählen Sie den Ablaufzeitpunkt des alten Secrets und anschließend Save Changes:
In 24 hours: Beide Secrets funktionieren nach dem Speichern 24 Stunden lang. Aktualisieren Sie alle Anwendungen vor Ablauf des alten Secrets.
Immediately: Das neue Secret ersetzt das alte sofort nach dem Speichern. Anfragen mit alter Signatur werden abgelehnt.
Vor dem Speichern bleibt Ihr aktuelles Secret unverändert. Abbrechen verwirft den ungespeicherten Ersatz.
Während einer laufenden Rotation können Sie keine weitere starten. Warten Sie auf den Ablauf des alten Secrets oder beenden Sie den Übergang mit Revoke Old Secret vorzeitig. Danach werden Anfragen mit dem alten Secret sofort abgelehnt.
Request Signing deaktivieren
Entfernen Sie die Auswahl bei Request Signing, wählen Sie Save Changes und bestätigen Sie. Die Signatur wird sofort deaktiviert, alle zugehörigen API-Secrets werden widerrufen und geplante Durchsetzungen oder laufende Rotationen beendet.
Aktualisieren Sie Anwendungen so, dass sie keine Signaturen mit widerrufenen Secrets mehr senden. Zum erneuten Aktivieren erstellen Sie ein neues Secret.
Bleibt IP Allowlist aktiv, müssen Anfragen weiterhin von einer erlaubten IP kommen. Ohne aktive Sicherheitsmethode erfolgt nur die Authentifizierung per API-Schlüssel. Schlüssel mit Schutzpflicht müssen mindestens eine wirksame Methode behalten.
Änderungen speichern oder verwerfen
Ausgewählte Methoden und IP-Liste gelten erst nach erfolgreichem Speichern. Cancel verwirft ungespeicherte Änderungen. Prüfen Sie bei Speicherfehlern die aktuelle Konfiguration vor einem erneuten Versuch; ein Timeout bedeutet nicht zwingend, dass die Anfrage fehlgeschlagen ist.
API-Antwortfehler finden Sie unter Antwortformat.
Zuletzt aktualisiert