​

Fehlerbehebung: Authentifizierung und API-Schlüssel

Jede Orbit-Anfrage durchläuft die Prüfung der Zugangsdaten, Ablauf und Widerruf des Schlüssels, den Sandbox-/Live-Modus, die IP-Allowlist und anschließend die Berechtigungen. Lesen Sie code, denn mehrere Gates können denselben HTTP-Status verwenden.

​

401-Fehler

Bei UNAUTHORIZED prüfen Sie den Header X-API-Key und senden Sie den vollständigen Schlüssel. INVALID_API_KEY bedeutet, dass der Schlüssel unbekannt, widerrufen oder durch eine schlüsselbezogene IP-Allowlist blockiert ist. Kopieren Sie ihn unter Settings → API Keys neu oder erstellen Sie einen Ersatz. EXPIRED_TOKEN bedeutet, dass Ablaufzeit oder revoke_at erreicht sind; rotieren Sie den Schlüssel.

​

Sandbox und Live

Ein dv_test_sk_-Schlüssel gehört zur Sandbox, ein dv_live_sk_-Schlüssel zur Live-Umgebung. Eine falsche Kombination ergibt 403 WRONG_KEY_MODE, bevor ein Handler läuft. Erstellen Sie den Schlüssel in der Organisation, die Sie aufrufen.

​

IP-Allowlists

Eine blockierte schlüsselbezogene IP erscheint absichtlich als 401 INVALID_API_KEY. Die organisationsweite Liste antwortet mit 403 IP_NOT_ALLOWED. Ermitteln Sie die öffentliche NAT-IP, die Orbit sieht, und ergänzen Sie sie oder ihren CIDR-Bereich in den Sicherheitseinstellungen.

​

Öffentliche Schlüssel und SAML/SCIM

Öffentliche Schlüssel sind nur lesbar. Verwenden Sie für Schreibvorgänge wie messages:write einen geheimen Schlüssel auf Ihrem Backend. Bei SAML muss der Benutzer zur Organisation gehören; SCIM darf die konfigurierte Rollenobergrenze nicht überschreiten. Senden Sie niemals das Geheimnis an den Support. Teilen Sie Code, request_id und nur die Schlüsselpräfix-Information.