Scopes voor API-sleutels: geef elke sleutel alleen de toegang die nodig is
Maak je een API-sleutel aan in het Dashboard, dan kies je nu precies wat die mag doen, met scopes gegroepeerd onder Returns, Logistics, Analytics, Store settings en Credentials. Bestaande sleutels houden volledige toegang.
Ik deel graag een update over de API-sleutels die je in het Dashboard aanmaakt. Tot vandaag kreeg elke nieuwe sleutel volledige toegang. Vanaf nu kies je bij het aanmaken precies wat elke sleutel mag doen.
Maak kennis met: Scopes voor API-sleutels
Hoe werkt het?
Wanneer je een sleutel aanmaakt in Account → Integrations → API keys, kies je de scopes ervan. Ze zijn gegroepeerd, zodat je ze snel vindt:
- Returns: van retouren lezen en opmerkingen toevoegen tot retouren autoriseren, controleren, de terugbetaalmethode wijzigen of annuleren.
- Logistics: bestellingen, ophaalafspraken, labels, verzendstatus en vervoerders.
- Analytics: retourpercentages, rapporten en inzichten in maatvoering.
- Store settings: retour- en omruilvoorwaarden, branding, magazijnen en workflows.
- Credentials: de inloggegevens van je platform en vervoerders, gemarkeerd als gevoelig.
Elke groep heeft een eigen selectievakje, en Select all vinkt alle scopes in één keer aan. Weet je niet zeker wat een scope doet? What each scope allows, direct in het formulier, opent een gids die elke scope uitlegt en de bijbehorende endpoints opsomt.
Waarom is dit belangrijk?
Elke tool krijgt alleen wat hij nodig heeft: je helpdesk kan retouren lezen en opmerkingen toevoegen, je BI-dashboard kan analytics lezen, en verder niets. We raden één sleutel per integratie aan: lekt een sleutel ooit uit, dan kan die alleen doen wat die integratie doet, en kun je hem verwijderen zonder de andere te raken. Een aanroep buiten de scopes van een sleutel wordt geweigerd, met een melding die de ontbrekende scope noemt.
Wat moet ik nog meer weten?
- Bestaande sleutels houden volledige toegang: de integraties die je al hebt, blijven gewoon werken.
- Scopes zijn niet te bewerken: wil je ze wijzigen, maak dan een nieuwe sleutel met de juiste scopes aan en verwijder de oude.
- Geen volledige toegang vanuit het Dashboard: Select all geeft alle scopes die daar worden aangeboden. Sleutels met volledige toegang kunnen alleen door REVER worden uitgegeven.
Wanneer kan ik het gebruiken?
Het staat vanaf vandaag live, voor elke nieuwe sleutel die je aanmaakt. Heb je vragen? Laat het ons gewoon weten.