API-sleutels genereren en beheren
Maak een API-sleutel aan in de Developers-sectie, kopieer hem één keer bij het aanmaken en hernoem, roteer of verwijder sleutels. Je kunt er tot 10 hebben, gedeeld in je organisatie.
API-sleutels laten je eigen systemen verbinding maken met VerifyPDF. Je beheert ze in het dashboard onder Developers. Dit artikel laat zien hoe je een sleutel aanmaakt en je sleutels netjes houdt.
Een API-sleutel aanmaken
- Log in op secure.verifypdf.com.
- Open Developers in de linkerzijbalk. Hij staat daar altijd zichtbaar.
- Kies Create key en geef hem een duidelijke naam, bijvoorbeeld
Billing systemofTest integration. - De volledige sleutel wordt één keer getoond, vlak nadat je hem hebt aangemaakt. Kopieer hem nu en bewaar hem ergens veilig.
Nadat je dat scherm hebt gesloten, toont VerifyPDF alleen een gemaskeerde versie van de sleutel (de laatste paar tekens) plus een tijdstip van last used. Er is geen manier om de volledige waarde opnieuw te tonen.
Je kunt er tot 10 tegelijk hebben. Bereik je het limiet, verwijder dan een sleutel die je niet meer gebruikt om een plek vrij te maken.
Sleutels zijn gedeeld in je organisatie
API-sleutels zijn organisatiebreed, niet persoonlijk. Elk teamlid met dashboardtoegang kan de gemaskeerde sleutels zien en beheren. Behandel een sleutel als een gedeeld wachtwoord. Voor wie toegang heeft, zie Admin- en lidrollen.
Een sleutel hernoemen, roteren of verwijderen
Vanuit de Developers-sectie kun je:
- Een sleutel hernoemen zodat zijn doel duidelijk blijft naarmate je team groeit.
- Een sleutel roteren als hij mogelijk is gelekt of als je een nieuwe waarde wilt. Roteren geeft je een nieuwe sleutel om één keer te kopiëren, waarna je je integratie bijwerkt.
- Een sleutel verwijderen die je niet meer gebruikt. Elk systeem dat nog een verwijderde sleutel gebruikt, stopt met werken, dus haal hem eerst uit je integratie.
Houd je sleutels veilig
- Kopieer de volledige sleutel op het moment dat hij wordt getoond. Je ziet hem niet meer terug.
- Plak een sleutel nooit in openbare code, chat of schermafbeeldingen.
- Roteer een sleutel meteen als je denkt dat hij is blootgesteld.
Wat je daarna kunt doen
- Bouw je voor het eerst? Zie Test- versus live-API-sleutels.
- Klaar om de API aan te roepen? Zie Een document verifiëren met de API.