Service User (JWT)

Aanmaken en gebruiken van een Service User (JWT)

Het is mogelijk dat u toegang moet verschaffen tot een licentie of project aan een geautomatiseerd proces om informatie uit te wisselen. Voorbeelden zijn:

  • Koppelingen met software van andere partijen
  • Gebruik maken van een van de integraties (PowerBI, Excel etc.) waarvoor geautomatiseerde toegang benodigd is.

Een Service User is een gebruiker zonder gebruikersnaam en wachtwoord maar met een unieke sleutel. Deze sleutel wordt gegenereerd door de Account Owner in de Portal en wordt beheerd door de klant zelf. Sensus slaat de sleutel nergens op maar kan wel valideren of een ingevulde sleutel geldig is en tot welke licentie en service user deze behoort.

De Service User is ook gekoppeld aan een bepaald Licentie Kenmerk. Dit is een manier om te identificeren met welke intentie de Service User contact maakt. Ook wel de scope genoemd. Het is van belang dat de juiste scope geselecteerd wordt, omdat niet alle onderdelen van Sensus toegankelijk zijn voor alle scopes.

De sleutel die gegenereerd wordt is een JSON Web Token (JWT). Dit is een gestandaardiseerde manier van het veilig inloggen in systemen door een geautomatiseerd systeem.

De Service User is net als een reguliere gebruiker toe te voegen aan licenties en projecten met dezelfde rechten als reguliere gebruikers.

Het is mogelijk de Service User te verwijderen waarna de JWT niet meer geldig is, of voor een Service User de JWT te resetten waarna er een nieuwe gegenereerd wordt. Dat betekent dat de oude JWT ook niet meer geldig is.

Een service user (JWT) aanmaken

  • Ga naar Mijn Bedrijf
  • Klik op Gebruikers  bovenin het menu
  • Druk op “Maak Service User aan”

  • Stel de rollen in die de Service User mag hebben binnen de licenties
  • Selecteer een kenmerk / scope waartoe deze Service User behoort. Indien u koppelt met een partner selecteert u de partner uit deze lijst. Indien u een eigen koppeling maakt kiest u API.
  • De JSON Web Token verschijnt in beeld.
  • Sla deze zelf op! Sensus slaat deze JWT niet op en wordt maar eenmalig getoond.

Een service user JWT verversen

  • Ga naar Mijn Bedrijf
  • Klik op Gebruikers bovenin het menu
  • Navigeer naar de service user en druk op het vergrootglas
  • Scroll naar beneden en druk op “Ververs JWT”

  • Een nieuwe JSON Web Token verschijnt in beeld.
  • Sla deze zelf op! Sensus slaat deze JWT niet op en wordt maar eenmalig getoond.

Een service user verwijderen

  • Een service user verwijderen gebeurt op dezelfde manier als het verwijderen van een reguliere gebruiker
  • Hou er rekening mee dat na het verwijderen van de service user geen van de koppelingen waartoe de JWT van de service user gebruikt is niet meer werkt

Gerelateerde artikelen