Definitie en mogelijkheden van de Penneo Super API-gebruiker
De Penneo Super API-gebruiker is een gespecialiseerde gebruikersrol met zowel beperkte als uitgebreide rechten. Deze rol is ontworpen om accountbrede controle te bieden voor integraties, specifiek met betrekking tot de toegang tot ondertekende documenten. De rol is gecreëerd om organisaties meer controle te geven over specifieke aspecten van hun Penneo-integratie.
Accountbrede gegevenstoegang voor Super API-gebruikers
Penneo Super API-gebruikers hebben uitgebreide rechten waarmee zij toegang krijgen tot alle dossiers en documenten binnen het gehele account. Dit geldt ongeacht of deze items door de gebruiker zelf zijn verzonden of met de gebruiker zijn gedeeld. Waar andere gebruikersrollen alleen toegang hebben tot inhoud die zij zelf hebben aangemaakt of die expliciet met hen is gedeeld, biedt de Super API-gebruiker een volledig, holistisch overzicht van alle Penneo-documenten en -gegevens. Dit maakt het de ideale rol voor systeembrede integraties.
Beperkingen en restricties van de Super API-rol
De Penneo Super API-gebruikersrol is onderworpen aan specifieke beperkingen om de systeemintegriteit te waarborgen:
Toegang: Gebruikers met deze rol hebben uitsluitend via de API toegang tot Penneo; zij kunnen niet inloggen op de webapplicatie of het archief.
Functionaliteit: Super API-gebruikers kunnen geen dossiers aanmaken of verzenden voor ondertekening.
Rolwijziging: Eenmaal aangemaakt, kan een Super API-gebruiker niet worden omgezet in een reguliere gebruiker of beheerder. De rol en bijbehorende rechten staan vast.
Een Penneo Super API-gebruiker aanmaken
Volg deze stappen om een Super API-gebruiker aan te maken binnen de Penneo-bedrijfsconfiguratie:
Navigeer naar het gebruikersoverzicht onder de bedrijfsinstellingen.
Klik op 'Nieuwe gebruiker aanmaken'.
Voer een naam en e-mailadres in voor de gebruiker.
Selecteer ‘Super API-gebruiker’ als rol. Let op: API-sleutels worden automatisch ingesteld als de enige beschikbare inlogmethode.
Klik op 'Gebruiker aanmaken'. Er wordt voor deze gebruikersrol geen uitnodigingsmail verzonden.
Kopieer onmiddellijk de API-sleutel en het geheime wachtwoord. Deze worden hierna niet meer weergegeven.
Belangrijk: Het is cruciaal om de inloggegevens tijdens de laatste stap van het aanmaakproces te kopiëren. Je ontvangt geen e-mail met deze gegevens en ze kunnen niet meer worden opgevraagd nadat het venster is gesloten.
Penneo API-inloggegevens resetten
Als API-sleutels verloren zijn gegaan of vervangen moeten worden, kunnen beheerders de inloggegevens voor een Super API-gebruiker resetten. Let op: Elke integratie die de oude sleutels gebruikt, zal onmiddellijk stoppen met werken zodra de gegevens zijn gereset.
Navigeer naar het gebruikersoverzicht en zoek de Super API-gebruiker in de lijst.
Selecteer de optie om de gebruiker te bewerken.
Kies voor de optie om de inloggegevens te resetten.
Er worden nieuwe API-sleutels gegenereerd die eenmalig worden getoond. Kopieer en sla deze direct op; ze zijn niet meer toegankelijk zodra het venster wordt gesloten.
Een Super API-gebruiker verwijderen
Penneo-beheerders kunnen een Super API-gebruiker op dezelfde manier verwijderen als andere gebruikers. Gedetailleerde instructies hiervoor vind je in deze gids: Administrator Basic Setup Resources.
Het verwijderen van de gebruiker deactiveert onmiddellijk de bijbehorende API-sleutel en het geheime wachtwoord. Elke integratie die van deze gegevens gebruikmaakt, zal direct stoppen met functioneren.