Tunnistautuminen
Tunnistaudu Nordvecin API-pyyntöihin työpistekohtaisella API-avaimella, joka lähetetään kantajatunnuksena.
Tämä opas on koneellisesti käännetty englanninkielisestä alkuperäisestä versiosta. Käännöksessä hyödynnettiin tekoälyn käsittely Ranskassa, eikä sitä ole tarkastanut ihminen. Englanninkielinen versio on virallinen. Lue englanninkielinen alkuperäinen versio
Jokainen pyyntö Nordvec-sovellusrajapintaan tunnistautuu API-avaimella, joka lähetetään kantoava tokenina Authorization-otsakkeessa.
curl https://nordvec.com/api/v1/documents/list \
-H "Authorization: Bearer $NORDVEC_API_KEY"Avaimen luominen
Luo avain työtilasi asetuksista. Raaka-avain palautetaan täsmälleen kerran, eikä sitä voi hakea myöhemmin, joten kopioi se salaisuuksien tallennuspaikkaan heti. Avaimet ovat rajattuja siihen työtilaan, joka ne loi.
Avaimen pyörittäminen ja peruuttaminen
Kohtele API-avainta kuin salasanaa. Jos se vuotaa, pyöritä tai peruuta se välittömästi.
- Pyörittäminen korvaa avaimen tunnistetiedot paikallaan. Edellinen tunniste toimii vielä lyhyen siirtymäajan, joten voit ottaa avaimen käyttöön palveluissasi keskeytyksettä.
- Peruuttaminen poistaa avaimen käytöstä välittömästi; sitä ei voi enää käyttää tunnistautumiseen.
Molemmat toiminnot vaativat kirjautuneen istunnon (ne eivät ole itse API-avaimella tehtäviä operaatioita), joten vuotanut avain ei voi käyttää itseään pyörittämiseen.
Hyvät käytännöt
- Tallenna avaimet salaisuuksien hallintatyökaluun tai ympäristömuuttujaan, älä koskaan lähdekoodiin.
- Käytä erillistä avainta kutakin palvelua tai ympäristöä kohden, jotta voit peruuttaa avaimen tarkasti.
- Suosi lyhytikäisiä avaimia CI- ja skriptikäytössä.