Anmeldung und IP-Liste
Schlüssel
- Ein Schlüssel sieht aus wie
omk_live_plus 32 Zeichen. Wir speichern nur seinen SHA-256-Hash und können ihn nicht noch einmal zeigen. Verloren: erneuern oder sperren. - Schlüssel laufen ab (Standard 365 Tage, höchstens 730). Beim Erneuern entsteht ein neuer Schlüssel; der alte funktioniert bis zu 168 Stunden weiter, damit du ohne Ausfall wechselst.
- Schlüssel werden nur in einer angemeldeten Browsersitzung erstellt, geändert und gesperrt, nie mit einem Schlüssel.
Rechte
| Recht | Erlaubt |
|---|---|
catalog:read | Katalog und Produkte. |
orders:write (auch orders:create) | Bestellungen anlegen. |
orders:read | Eigene Bestellungen und den Guthaben-Platzhalter lesen. |
keys:read | Keys gelieferter Bestellungen abrufen. Nötig für jeden Key-Abruf über die API oder MCP. |
webhooks:manage | Eigene Webhook-Endpunkte verwalten. |
seller:read, offers:write, stock:write | Nur Verkäufer-Schlüssel: Angebote und Reservierungen lesen, Angebote und Preise ändern, Keys hochladen. |
Ein Schlüssel ohne Liste hat alle Rechte seines Bereichs. Ein Aufruf außerhalb der Liste antwortet 403 permission_required mit dem nötigen Recht.
IP-Liste (selbst einstellbar)
Bis zu 20 Einträge je Schlüssel: IPv4-Adressen, IPv4-Bereiche von /8 bis /32 oder IPv6-Adressen. Beim Erstellen oder später unter „Einstellungen“ auf der Schlüsselseite. Ein Aufruf von einer anderen Adresse antwortet 403 ip_not_allowed. Viele solche Antworten frieren den Schlüssel ein, denn meist ist er dann geleakt.
Signierte Anfragen (optional)
Für den stärksten Schutz hinterlegst du einen Ed25519-Public-Key am Schlüssel. Danach muss jeder Aufruf eine HTTP-Message-Signatur tragen (RFC 9421); der Schlüssel allein reicht nicht mehr. Details: /docs.
Wenn ein Schlüssel geleakt ist
Sperre ihn sofort auf der Schlüsselseite und erstelle einen neuen. Bis dahin begrenzen Tageslimit und IP-Liste den Schaden.