Luo ja mitätöi API-avaimia

Pro-paketista alkaen

Ylläpitäjä luo API-avaimet kohdassa Asetukset → Kehittäjille → API-avaimet. Avain kuuluu organisaatiolle eikä sen luoneelle ylläpitäjälle, joten se toimii edelleen, vaikka luoja poistuisi organisaatiosta. Mitätöinti lopettaa avaimen heti ja pysyvästi.

Luo avain

1. Avaa Asetukset → Kehittäjille → API-avaimet.
2. Anna avaimelle nimi, joka kertoo, missä se on käytössä, esimerkiksi Grafana tai yöllinen skripti. Vain ylläpitäjät näkevät nimen.
3. Valitse voimassaoloaika. Se voi olla 30 päivää, 90 päivää tai 365 päivää, tai avain voi olla voimassa toistaiseksi. Oletus on 365 päivää.
4. Teams-paketista alkaen valitse avaimen oikeudet: Vain luku tai Luku ja kirjoitus. Oletus on Vain luku. Kirjoitusoikeudella avain voi aloittaa vientejä, eikä se voi tehdä muuta.
5. Paina Luo avain.

Seuraava sivu näyttää avaimen vain kerran. Kopioi se silloin: tallennamme avaimesta vain tiivisteen, joten kukaan ei voi näyttää sitä sinulle uudelleen. Sivulla on myös curl-esimerkki, jossa uusi avain on valmiina, sekä Prometheus- ja MCP-esimerkit, jos paketti sisältää ne. Avainluettelossa kustakin avaimesta näkyy mm_ ja muutama ensimmäinen merkki, joten erotat avaimet toisistaan.

Mihin avain pääsee

Avain lukee organisaationsa verkkotunnukset, raportit, lähteet, DNS-tarkistukset ja hälytykset API:n kautta. Jos paketti sisältää ne, avain lukee myös päätepistettä /metrics ja MCP-palvelinta. Jokaisella avaimella on oma tuntikohtainen pyyntölaskurinsa.

Avain pitää ne oikeudet, jotka se sai luotaessa. Jos skriptin pitää kirjoittaa, luo uusi avain kirjoitusoikeudella, vaihda se skriptiin ja mitätöi vanha avain.

Montako avainta

Paketti määrää, montako aktiivista avainta organisaatiolla voi olla, kuten pakettitaulukko näyttää. Määrään lasketaan avaimet, joita ei ole mitätöity ja jotka eivät ole vanhentuneet. Kun kaikki avaimet ovat käytössä, sivu kertoo sen. Mitätöi silloin avain, jota et enää käytä, ja luo sitten uusi.

Kun avain vanhenee

Kun avaimen vanhenemiseen on 14 päivää, luettelossa sen kohdalla näkyy Vanhenee pian. Luo uusi avain, vaihda se skriptiin ja mitätöi vanha ennen vanhenemispäivää. Vanhentuneella avaimella tehty pyyntö saa vastauksen token_expired. Avain pysyy luettelossa vanhentuneeksi merkittynä, kunnes ylläpitäjä mitätöi sen.

Kun paketti vaihtuu

• Paketti, jossa on vähemmän avaimia. Vanhimmat avaimet toimivat uuden paketin sallimaan määrään asti. Uudempien kohdalla näkyy Keskeytetty paketin vuoksi, ja niillä tehty pyyntö saa vastauksen plan. Keskeytetty avain toimii taas, kun vanhempi avain mitätöidään tai vanhenee tai kun paketti sisältää enemmän avaimia.
• Paketti ilman API:a. Kaikki avaimet säilyvät, ja jokainen niillä tehty pyyntö saa vastauksen plan, kunnes organisaatiolla on taas Pro-paketti tai sitä parempi. Sen jälkeen avaimet toimivat kuten ennenkin.
• Paketti ilman kirjoitusoikeutta. Avain, jolla on luku- ja kirjoitusoikeus, voi yhä lukea. Kirjoittava pyyntö saa vastauksen plan.

Mitätöi avain

Paina avaimen rivillä Mitätöi. Siitä hetkestä alkaen jokainen avaimella tehty pyyntö saa vastauksen unauthorized, joten jokainen sitä käyttävä skripti pysähtyy. Mitätöintiä ei voi perua. Mitätöinti toimii kaikissa paketeissa, joten ylläpitäjä voi siivota avaimet myös pienempään pakettiin siirtymisen jälkeen.

Jos avain on voinut päätyä vääriin käsiin, mitätöi se ja luo uusi. Lähetä avain vain Authorization-otsakkeessa: API hylkää osoitteessa olevan avaimen.

Julkaistu 27. lokakuuta 2026 · Tarkistettu 27. lokakuuta 2026