De Penneo Super API-gebruiker is een gespecialiseerde gebruikersrol met zowel beperkte als uitgebreide rechten, ontworpen om accountbrede controle te bieden voor integraties, specifiek met betrekking tot toegang tot ondertekende documenten. Deze rol is gecreëerd om organisaties meer controle te geven over specifieke aspecten van een Penneo-integratie.
Accountbrede gegevens toegang voor Super API-gebruikers
In tegenstelling tot reguliere gebruikers die alleen documenten kunnen zien die zij hebben aangemaakt of met hen zijn gedeeld, heeft een Super API-gebruiker accountbrede gegevens toegang.
- Volledige zichtbaarheid: Hij kan alle dossiers en documenten in uw hele Penneo-account openen.
- Ontworpen voor integraties: Hij biedt een uitgebreid, holistisch overzicht van alle documenten van uw organisatie, waardoor het perfect geschikt is voor geautomatiseerde, systeembrede integraties.
Beperkingen en restricties van de Super API-rol
Om de systeembeveiliging en integriteit te waarborgen, heeft de Super API-gebruiker een zeer specifieke set regels. Dit is wat hij wel en niet kan doen:
| Wat hij WEL kan doen: | Wat hij NIET kan doen: |
|---|---|
| Accountbrede toegang: Alle dossiers en documenten bekijken en ophalen. | Geen toegang tot Web App: Kan niet inloggen op de Penneo webinterface of archief. |
| Alleen API-toegang: Verbindt uitsluitend via de Penneo API. | Geen verzending: Kan geen dossierbestanden aanmaken of verzenden voor ondertekening. |
| Permanent rol: Eenmaal aangemaakt kan deze niet worden omgezet in een reguliere gebruiker of beheerder. |
Een Penneo Super API-gebruiker aanmaken
Volg deze stappen om een Super API-gebruiker aan te maken binnen de Penneo bedrijfsconfiguratie:
- Ga naar het gebruikersoverzicht onder bedrijfsconfiguratie.
- Klik op 'Nieuwe gebruiker aanmaken'.
- Voer een naam en e-mailadres voor de gebruiker in.
- Selecteer 'Super API-gebruiker' als rol. Let op: API-sleutels worden automatisch afgedwongen als de enige beschikbare inlogmethode.
- Klik op 'Gebruiker aanmaken'. Let op: er wordt geen uitnodigingsmail verzonden voor deze gebruikersrol.
- Kopieer onmiddellijk de API-sleutel en het geheim, want deze worden niet nogmaals getoond.
Het is cruciaal om de referenties tijdens de laatste stap van het aanmaakproces te kopiëren. U ontvangt geen e-mailuitnodiging met deze referenties, en ze kunnen niet worden teruggehaald zodra het venster is gesloten.
Penneo API-referenties resetten
Als API-sleutels verloren zijn of vervangen moeten worden, kunnen beheerders de referenties voor een Penneo Super API-gebruiker resetten. Houd er rekening mee dat elke integratie die de oude sleutels gebruikt onmiddellijk stopt met werken na het resetten van de referenties.
- Ga naar het gebruikersoverzicht en zoek de Super API-gebruiker in de gebruikerslijst.
- Selecteer de optie om de gebruiker te bewerken.
- Kies om de referenties te resetten.
- Nieuwe API-sleutels worden één keer gegenereerd en weergegeven. U moet deze onmiddellijk kopiëren en opslaan, want ze zijn niet meer toegankelijk zodra het venster gesloten is.
Een Super API-gebruiker verwijderen
Penneo-beheerders kunnen een Super API-gebruiker op dezelfde manier verwijderen als andere gebruikerstypen. Gedetailleerde instructies voor dit proces zijn te vinden in deze gids: Gebruikersbeheer in Penneo
Het verwijderen van de gebruiker deactiveert onmiddellijk de bijbehorende API-sleutel en het geheim. Elke integratie die op deze referenties vertrouwt, zal direct stoppen met functioneren.