Hoppa till innehållet
Verifierad

Ordning och reda med API-nycklar

Full eller anpassad åtkomst, att återkalla och byta ut en nyckel och att hitta en som ingen använder.

En API-nyckel agerar på ditt konto utan att du själv är med: var som helst, tills den återkallas. Authentication beskriver hur en nyckel skapas och skickas med ett anrop. Den här sidan handlar om att hålla ordning på de nycklar du redan har.

Ge en nyckel bara det den behöver

Varje nyckel har Full åtkomst eller Anpassad åtkomst. Du väljer när nyckeln skapas och kan ändra det senare i samma formulär.

  • Full åtkomst når alla metoder som ditt konto kan anropa, även sådana som läggs till efter att nyckeln skapades. Inget som är markerat som privat ingår någonsin, oavsett nyckelns åtkomstläge.
  • Anpassad åtkomst når bara de metoder du uttryckligen har kryssat i, grupperade per mikrotjänst, med varje metods egna parametrar bredvid. En metod som läggs till senare täcks inte förrän du kommer tillbaka och kryssar i den.
Föredra anpassad åtkomst för allt automatiserat

En nyckel som används i ett skript, ett CI-jobb eller en server behöver bara de få metoder som jobbet faktiskt anropar. Med anpassad åtkomst kan en läckt nyckel inte göra mer än det arbete den byggdes för.

Skapa, visa och kopiera

För att skapa en nyckel måste ditt konto vara verifierat till nivå 2, se Verification. Knappen Skapa nyckel förklarar detta och länkar direkt till nästa olösta steg om du inte har kommit dit ännu. Värdet på en nyss skapad nyckel visas en enda gång i panelen Quick copy överst i listan. Därefter är det maskerat på varje rad, och radens egen visa-knapp visar det igen i 20 sekunder innan det maskeras på nytt.

En nyckel är en hemlighet, inte en etikett

Värdet skrivs aldrig till en logg, ett meddelande eller adressfältet, bara till ditt urklipp. Behandla det precis som ett lösenord. Den som har det kan agera som ditt konto.

Byt ut, återkalla och hitta en som inte används

Det finns ingen separat rotationsåtgärd, eftersom en nyckels värde också är dess identitet. Byt ut skapar en ny nyckel med samma namn och åtkomst, återkallar den gamla och visar det nya värdet en gång så att du hinner kopiera det innan du stänger dialogrutan. Återkalla tar bort en nyckel helt och ber dig först bekräfta med nyckelns namn, eftersom det inte går att ångra.

Varje nyckels rad visar när den senast användes, baserat på de senaste 7 dagarnas aktivitet. En nyckel utan rad under sig har helt enkelt inte gjort något anrop under den perioden. Det är den raden som är värd en extra titt.

Byt ut en nyckel som kan ha läckt

Öppna nyckeln, tryck på Byt ut och kopiera det nya värdet i samma stund som det visas. Det gamla värdet slutar fungera i samma ögonblick som utbytet är klart.

Återkalla en nyckel du inte längre behöver

Tryck på Återkalla på nyckelns rad och bekräfta med namnet. En återkallad nyckel försvinner från listan över aktiva nycklar och går inte att få tillbaka.

Leta efter en som ingen använder

Gå igenom listan efter en rad utan raden "Senast använd", särskilt bland nycklar med full åtkomst, och återkalla den om du inte kan förklara varför den finns.