Sari la conținut
Verificat

Igiena cheilor API

Acces complet sau personalizat, revocarea și înlocuirea unei chei, și cum găsești una pe care nu o folosește nimeni.

O cheie API acționează în contul tău fără tine: de oriunde, până când este revocată. Autentificarea explică cum se creează o cheie și cum se trimite într-un apel; această pagină este despre cum să îți păstrezi în ordine cheile pe care le ai deja.

Dă unei chei doar ce îi trebuie

Fiecare cheie are Acces complet sau Acces personalizat, alese la creare și modificabile ulterior din același formular.

  • Acces complet ajunge la fiecare metodă pe care o poate apela contul tău, inclusiv la cele adăugate după crearea cheii. Nimic marcat ca privat nu este inclus vreodată, indiferent de modul de acces al cheii.
  • Acces personalizat ajunge doar la metodele pe care le-ai bifat explicit, grupate pe microserviciu, cu parametrii fiecărei metode afișați alături. O metodă adăugată mai târziu nu este acoperită până nu revii și o bifezi.
Preferă accesul personalizat pentru orice este automatizat

O cheie folosită într-un script, într-un job CI sau pe un server are nevoie doar de cele câteva metode pe care le apelează efectiv jobul respectiv. Accesul personalizat împiedică o cheie scursă să facă mai mult decât munca pentru care a fost creată.

Creează, afișează și copiază

Pentru a crea o cheie, contul tău trebuie verificat la nivelul 2; vezi Verificare. Butonul Creează cheie explică acest lucru și te duce direct la următorul pas nefinalizat, dacă încă nu ești acolo. Valoarea unei chei nou create este afișată o singură dată în panoul Copiere rapidă din partea de sus a listei; după aceea, fiecare rând o ține mascată, iar butonul de afișare al rândului o arată din nou timp de 20 de secunde, apoi se maschează singură.

O cheie este un secret, nu o etichetă

Valoarea nu este scrisă niciodată într-un jurnal, într-o notificare sau în bara de adrese, ci doar în clipboard. Tratează-o exact ca pe o parolă. Oricine o are poate acționa în numele contului tău.

Înlocuiește, revocă și descoperă o cheie nefolosită

Nu există o acțiune separată de rotire, deoarece valoarea unei chei este propriul ei identificator. Înlocuiește creează o cheie nouă cu același nume și același acces, revocă cheia veche și arată valoarea nouă o singură dată, ca să o poți copia înainte de a închide dialogul. Revocă șterge o cheie definitiv și îți cere mai întâi să confirmi după nume, deoarece nu se poate anula.

Rândul fiecărei chei arată când a fost folosită ultima dată, pe baza activității din ultimele 7 zile; o cheie fără nicio linie dedesubt nu a făcut niciun apel în acel interval. Acesta este rândul care merită o a doua privire.

Înlocuiește o cheie care s-ar putea să fi fost scursă

Deschide cheia, apasă Înlocuiește și copiază valoarea nouă imediat ce apare. Valoarea veche nu mai funcționează chiar în clipa în care înlocuirea se termină.

Revocă o cheie de care nu mai ai nevoie

Apasă Revocă pe rândul ei și confirmă după nume. O cheie revocată dispare din lista activă; nu există nicio cale de a o aduce înapoi.

Verifică dacă există una pe care n-o folosește nimeni

Parcurge lista în căutarea unui rând fără linia „Ultima utilizare", mai ales printre cheile cu Acces complet, și revocă-l dacă nu poți explica de unde vine.