> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Fehlerbehebung: Authentifizierung und API-Schlüssel

> Ordnen Sie 401-, 403- und 422-Antworten dem ausgelösten Authentifizierungs-Gate zu.

# 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.

| Code | HTTP | Ausgelöstes Gate |
| - | - | - |
| `UNAUTHORIZED` | 401 | Keine verwendbaren Zugangsdaten |
| `INVALID_API_KEY` | 401 | Schlüssel unbekannt, widerrufen oder von nicht erlaubter IP |
| `EXPIRED_TOKEN` | 401 | Schlüssel abgelaufen oder planmäßig widerrufen |
| `WRONG_KEY_MODE` | 403 | Schlüsselmodus passt nicht zum Workspace |
| `IP_NOT_ALLOWED` | 403 | Workspace-Allowlist blockiert die Quell-IP |
| `INSUFFICIENT_PERMISSIONS` | 403 | Rolle oder Scope erlaubt die Route nicht |
| Schreiben mit öffentlichem Schlüssel | 422 | `dv_..._pk_`-Schlüssel ist schreibgeschützt |
| `STALE_WEBHOOK` | 401 | Webhook-Zeitstempel fehlt oder ist zu alt |

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.