Scopes für API-Schlüssel: nur so viel Zugriff, wie jeder Schlüssel braucht
Wenn Sie im Dashboard einen API-Schlüssel erstellen, legen Sie jetzt genau fest, was er darf, mit Scopes, die nach Returns, Logistics, Analytics, Store settings und Credentials gruppiert sind. Bestehende Schlüssel behalten den vollen Zugriff.
Ich freue mich, Ihnen eine Neuerung bei den API-Schlüsseln vorzustellen, die Sie im Dashboard erstellen. Bis heute erhielt jeder neue Schlüssel vollen Zugriff. Ab jetzt legen Sie beim Erstellen genau fest, was jeder Schlüssel darf.
Wir stellen vor: Scopes für API-Schlüssel
Wie funktioniert es?
Wenn Sie unter Account → Integrations → API keys einen Schlüssel erstellen, wählen Sie seine Scopes aus. Sie sind gruppiert, damit Sie sie schnell finden:
- Returns: vom Lesen von Rückgaben und Hinzufügen von Kommentaren bis zum Autorisieren, Prüfen, Ändern der Erstattungsmethode oder Stornieren.
- Logistics: Bestellungen, Abholungen, Versandetiketten, Versandstatus und Versanddienstleister.
- Analytics: Retourenquoten, Berichte und Größen-Insights.
- Store settings: Rückgabe- und Umtauschbedingungen, Branding, Lager und Workflows.
- Credentials: die Zugangsdaten Ihrer Plattform und Ihrer Versanddienstleister, als sensibel gekennzeichnet.
Jede Gruppe hat ihr eigenes Kontrollkästchen, und Select all wählt alle Scopes auf einmal aus. Sie sind nicht sicher, was ein Scope bewirkt? What each scope allows, direkt im Formular, öffnet eine Anleitung, die jeden Scope erklärt und seine Endpoints auflistet.
Warum ist das wichtig?
Jedes Tool bekommt nur, was es braucht: Ihr Helpdesk kann Rückgaben lesen und Kommentare hinzufügen, Ihr BI-Dashboard kann Analytics lesen, und mehr nicht. Wir empfehlen einen Schlüssel pro Integration: Gerät ein Schlüssel jemals in falsche Hände, kann er nur das, was diese Integration tut, und Sie können ihn löschen, ohne die anderen anzufassen. Ein Aufruf außerhalb der Scopes eines Schlüssels wird abgelehnt, mit einer Meldung, die den fehlenden Scope nennt.
Was sollte ich sonst noch wissen?
- Bestehende Schlüssel behalten den vollen Zugriff: Ihre bestehenden Integrationen funktionieren weiter wie bisher.
- Scopes lassen sich nicht bearbeiten: Um sie zu ändern, erstellen Sie einen neuen Schlüssel mit den richtigen Scopes und löschen den alten.
- Kein Vollzugriff über das Dashboard: Select all vergibt alle dort angebotenen Scopes. Schlüssel mit Vollzugriff kann nur REVER ausstellen.
Wann kann ich es nutzen?
Es ist ab heute verfügbar, für jeden neuen Schlüssel, den Sie erstellen. Wenn Sie Fragen haben, sagen Sie uns einfach Bescheid.