Siirry sisältöön
Tarkistettu

API-avainten hallinta

Täysi ja mukautettu käyttöoikeus, avaimen peruminen ja vaihtaminen sekä käyttämättömän avaimen tunnistaminen.

API-avain toimii tililläsi ilman sinua: mistä päin tahansa, kunnes se perutaan. Todennus kertoo, miten avain luodaan ja miten se lähetetään kutsun mukana. Tällä sivulla opit pitämään jo olemassa olevat avaimet kurissa.

Anna avaimelle vain se, mitä se tarvitsee

Jokainen avain on joko Täysi käyttöoikeus tai Mukautettu käyttöoikeus. Valinta tehdään avainta luotaessa, ja sitä voi muuttaa myöhemmin samasta lomakkeesta.

  • Täysi käyttöoikeus yltää kaikkiin metodeihin, joita tilisi voi kutsua, myös avaimen luomisen jälkeen lisättyihin. Mitään yksityiseksi merkittyä ei koskaan sisällytetä, olipa avaimen käyttötila mikä tahansa.
  • Mukautettu käyttöoikeus yltää vain metodeihin, jotka olet erikseen valinnut. Metodit on ryhmitelty mikropalveluittain, ja kunkin metodin omat parametrit näkyvät sen vieressä. Myöhemmin lisätty metodi ei kuulu avaimelle, ennen kuin palaat ja valitset sen.
Valitse mukautettu käyttöoikeus kaikelle automaattiselle

Skriptiin, CI-ajoon tai palvelimeen kytketty avain tarvitsee vain ne muutamat metodit, joita kyseinen työ oikeasti kutsuu. Mukautettu käyttöoikeus estää vuotaneen avaimen tekemästä enempää kuin mihin se on tarkoitettu.

Luo, näytä ja kopioi

Avaimen luominen vaatii, että tilisi on varmennettu tasolle 2. Katso Varmennus. Luo avain -painike selittää tämän ja vie suoraan seuraavaan keskeneräiseen vaiheeseen, jos et ole vielä siinä. Juuri luodun avaimen arvo näytetään kerran luettelon yläreunan Pikakopiointi-paneelissa. Sen jälkeen jokainen rivi pitää arvon piilotettuna, ja rivin oma näyttöpainike paljastaa sen uudelleen 20 sekunnin ajaksi, minkä jälkeen se piilotetaan taas.

Avain on salaisuus, ei nimilappu

Arvoa ei koskaan kirjoiteta lokiin, ilmoitukseen tai osoiteriville, vaan ainoastaan leikepöydällesi. Käsittele sitä täsmälleen kuin salasanaa. Jokainen, jolla se on, voi toimia tilisi nimissä.

Vaihda, peru ja huomaa käyttämätön avain

Erillistä kierrätystoimintoa ei ole, koska avaimen arvo on sen oma tunniste. Vaihda luo uuden avaimen samalla nimellä ja samoilla oikeuksilla, perii vanhan ja näyttää uuden arvon kerran, jotta ehdit kopioida sen ennen ikkunan sulkemista. Peru poistaa avaimen kokonaan ja pyytää ensin vahvistamaan sen nimellä, koska toimintoa ei voi kumota.

Jokaisen avaimen rivillä näkyy, milloin sitä käytettiin viimeksi, viimeisen 7 päivän toiminnasta laskettuna. Jos rivin alla ei ole riviä, avaimella ei tehty yhtään kutsua kyseisenä aikana. Juuri se rivi kannattaa katsoa tarkemmin.

Vaihda avain, joka on voinut vuotaa

Avaa avain, paina Vaihda ja kopioi uusi arvo heti, kun se tulee näkyviin. Vanha arvo lakkaa toimimasta sillä hetkellä, kun vaihto valmistuu.

Peru avain, jota et enää tarvitse

Paina rivin Peru-painiketta ja vahvista nimellä. Peruttu avain poistuu aktiivisten luettelosta, eikä sitä voi palauttaa.

Tarkista, onko jokin avain käyttämättä

Käy luettelo läpi ja etsi rivi, jolla ei ole "Viimeksi käytetty" -riviä, etenkin Täysi käyttöoikeus -avaimista, ja peru se, jos et osaa selittää sitä.