Skip to main content
Nu aveți nevoie de OAuth pentru a utiliza API-ul public. Pentru o integrare privată, pe partea de server, începeți cu o cheie API cu permisiuni limitate și urmați ghidul de pornire rapidă. Alegeți datele de autentificare client OAuth atunci când politica dvs. de securitate impune tokenuri de acces cu durată scurtă de viață sau când platforma dvs. de integrare acceptă deja acest flux. Ambele opțiuni folosesc un cont de serviciu. Un cont de serviciu este identitatea integrării, nu o a treia metodă de autentificare.

​
Cum se îmbină componentele

Creați câte un cont de serviciu pentru fiecare integrare. Alegeți pentru acel cont fie o cheie API, fie un client OAuth; nu aveți nevoie de ambele metode pentru fiecare solicitare API. Niciuna dintre aceste date de autentificare nu poate depăși permisiunile curente ale contului. Ghidul de pornire rapidă folosește autentificarea Basic. Pentru cheile API este acceptat și un antet Bearer; utilizarea acestui antet nu înseamnă că aveți nevoie de un client OAuth.

​
Alegeți o cheie API pentru o integrare simplă

Folosiți o cheie API pentru propriile joburi programate, scripturi de raportare, fluxuri de date sau alte servicii backend, atunci când un secret stocat în managerul dvs. de secrete corespunde cerințelor dvs. de securitate.
  • Efectuați direct solicitări autentificate; nu este necesar niciun schimb de tokenuri.
  • Selectați doar permisiunile de care are nevoie sarcina de lucru și stabiliți o dată de expirare.
  • Rotiți cheia folosind perioada de suprapunere sau revocați-o imediat dacă a fost expusă.
O integrare bazată pe cheie API nu necesită un client OAuth. Începeți cu ghidul de pornire rapidă, apoi consultați cheile API pentru creare și rotire.

​
Alegeți OAuth pentru tokenuri de acces cu durată scurtă de viață

Folosiți datele de autentificare client OAuth pentru un serviciu backend confidențial atunci când organizația dvs. impune tokenuri de acces cu expirare sau când un instrument de integrare se așteaptă la tipul de acordare client_credentials.
  1. Creați un client OAuth cu permisiuni limitate pentru contul de serviciu.
  2. Autentificați clientul la punctul final regional de tokenuri, folosind metoda de autentificare a clientului furnizată în timpul configurării.
  3. Trimiteți tokenul de acces obținut împreună cu solicitările API. Obțineți un token nou înainte ca tokenul curent să expire.
OAuth adaugă integrării dvs. obținerea tokenurilor și gestionarea expirării. Secretul clientului necesită în continuare stocare securizată și rotire; tokenurile cu durată scurtă de viață nu elimină această responsabilitate. Datele de autentificare client nu folosesc tokenuri de reîmprospătare: autentificați din nou clientul pentru a obține un nou token de acces. Accesul OAuth trebuie activat pentru organizația dvs. Dacă nu este activat, folosiți o cheie API sau contactați asistența Living Security în legătură cu cerințele dvs. Consultați datele de autentificare client OAuth pentru crearea clientului, secretele afișate o singură dată, revocare și recuperare.

​
Păstrați datele de autentificare în backend

Cheile API ale contului de serviciu și secretele clientului OAuth trebuie păstrate în spațiul de stocare a secretelor de pe partea de server. Nu le includeți în codul din browser, în aplicații mobile, în controlul versiunilor sau în jurnale. O credențială de cont de serviciu acționează ca sarcina de lucru; nu autentifică o persoană și nu oferă un flux de consimțământ al clientului. Folosiți gazda API regională pentru organizația dvs. cu oricare dintre metode. Schimbarea metodei de autentificare nu modifică URL-ul resursei, versiunea API sau permisiunile necesare pentru o operațiune.