API-sleutel of TOTP: wat is het verschil?
Paramant kent twee soorten inloggegevens, elk voor iets anders. De accountsleutel is voor machines en scripts. De code van 6 cijfers (of uw passkey) is om zelf in te loggen op de website. U heeft ze nooit allebei tegelijk nodig.
In het kort
API-sleutel
- Een vaste geheime reeks:
pgp_gevolgd door 64 hexadecimale tekens - Vertelt de API welk account het is
- Verloopt niet vanzelf
- U krijgt hem één keer en bewaart hem zelf
- Voor machines, scripts en koppelingen
TOTP-code
- Een code van 6 cijfers die elke 30 seconden verandert
- Bewijst dat u er zelf bij bent
- Uw authenticator-app maakt hem
- Kan niet opnieuw gebruikt of uit logs gestolen worden
- Om zelf in te loggen op de website, samen met uw e-mailadres
Wanneer u alleen de API-sleutel nodig heeft
Verkeer tussen machines gebruikt alleen de API-sleutel. Denk aan IoT-apparaten, CI-pipelines en serverscripts. De sleutel gaat bij elk verzoek mee in de X-Api-Key-header. Een TOTP-code is niet nodig, want een machine kan geen authenticator-app openen. U vindt de sleutel op Account onder Geavanceerde accountsleutel.
Elk account heeft één accountsleutel. De API-sleutels die u met een Firm-abonnement of hoger op uw accountpagina maakt (beginnend met psk_live_), zijn voor de ParaSign-API. Die maakt en trekt u zelf in, per koppeling. Ze staan los van de accountsleutel.
Zelf inloggen op de website
Inloggen via paramant.app/auth/login vraagt geen API-sleutel. Zo gaat het:
- Vul uw e-mailadres in
- Log in met uw passkey, of kies Liever een code van 6 cijfers en vul de huidige code uit uw authenticator-app in
Heeft u uw authenticator-app niet bij de hand, dan logt u in met een back-upcode op paramant.app/auth/backup.
Waarom geen gewoon wachtwoord?
Paramant heeft geen wachtwoorden. U bewijst wie u bent met iets dat u heeft: een passkey op uw apparaat of de authenticator-app op uw telefoon. Er is dus geen wachtwoord om te onthouden, te hergebruiken of via een herstelmail over te nemen.
Sleutel vervangen
Een nieuwe accountsleutel maakt u nu niet zelf op de website. Denkt u dat hij is uitgelekt, mail dan meteen naar privacy@paramant.app vanaf het e-mailadres van uw account; wij vervangen hem. Zet de nieuwe sleutel daarna in elke koppeling die hem gebruikt. Een psk_live_-sleutel trekt u wel zelf in, op uw accountpagina.
Veelgestelde vragen
psk_live_-sleutel, trek die dan zelf in op uw accountpagina. Beschouw verzendingen met de oude sleutel als mogelijk gelekt en laat uw ontvangers het weten als de inhoud gevoelig was.