Skip to main content
Lai izmantotu Public API, OAuth nav nepieciešams. Privātai, servera pusē darbināmai integrācijai sāciet ar API atslēgu ar ierobežotu piekļuves apjomu un izpildiet ātrās darbības sākšanas norādījumus. Izvēlieties OAuth klienta akreditācijas datus, ja jūsu drošības politika pieprasa īslaicīgus piekļuves marķierus vai ja jūsu integrācijas platforma šo plūsmu jau atbalsta. Abas iespējas izmanto pakalpojuma kontu. Pakalpojuma konts ir integrācijas identitāte, nevis trešā autentifikācijas metode.

​
Kā elementi savā starpā sader

Katrai integrācijai izveidojiet vienu pakalpojuma kontu. Šim kontam izvēlieties API atslēgu vai OAuth klientu; katrā API pieprasījumā abas metodes nav nepieciešamas. Neviens akreditācijas datu veids nevar pārsniegt konta pašreizējās atļaujas. Ātrās darbības sākšanas norādījumos tiek izmantota Basic autentifikācija. API atslēgām tiek atbalstīta arī Bearer galvene; šīs galvenes izmantošana nenozīmē, ka jums ir nepieciešams OAuth klients.

​
Izvēlieties API atslēgu vienkāršai integrācijai

Izmantojiet API atslēgu savām plānotajām darbībām, atskaišu skriptiem, datu plūsmām vai citiem aizmugursistēmas pakalpojumiem, ja jūsu noslēpumu pārvaldniekā glabāts noslēpums atbilst jūsu drošības prasībām.
  • Veiciet autentificētus pieprasījumus tieši; marķieru apmaiņa nav nepieciešama.
  • Atlasiet tikai tās atļaujas, kas nepieciešamas darbslodzei, un iestatiet derīguma termiņu.
  • Mainiet atslēgu, izmantojot tās pārklāšanās periodu, vai nekavējoties atsauciet to, ja tā ir kļuvusi pieejama nepiederošām personām.
Integrācijai ar API atslēgu OAuth klients nav nepieciešams. Sāciet ar ātrās darbības sākšanas norādījumiem, pēc tam skatiet API atslēgas, lai uzzinātu par izveidi un nomaiņu.

​
Izvēlieties OAuth īslaicīgiem piekļuves marķieriem

Izmantojiet OAuth klienta akreditācijas datus konfidenciālam aizmugursistēmas pakalpojumam, ja jūsu organizācija pieprasa piekļuves marķierus ar derīguma termiņu vai ja integrācijas rīks sagaida client_credentials piešķiršanas veidu.
  1. Izveidojiet pakalpojuma kontam OAuth klientu ar ierobežotu piekļuves apjomu.
  2. Autentificējiet klientu sava reģiona marķieru galapunktā, izmantojot klienta autentifikācijas metodi, kas norādīta iestatīšanas laikā.
  3. Sūtiet iegūto piekļuves marķieri kopā ar saviem API pieprasījumiem. Iegūstiet jaunu marķieri, pirms beidzas pašreizējā marķiera derīguma termiņš.
OAuth jūsu integrācijai pievieno marķieru iegūšanu un derīguma termiņa apstrādi. Klienta noslēpumu joprojām ir jāglabā drošā vietā un regulāri jānomaina; īslaicīgi marķieri šo atbildību neatceļ. Klienta akreditācijas dati neizmanto atjaunošanas marķierus: lai iegūtu jaunu piekļuves marķieri, klients ir jāautentificē atkārtoti. Jūsu organizācijai ir jābūt iespējotai OAuth piekļuvei. Ja tā nav iespējota, izmantojiet API atslēgu vai sazinieties ar Living Security atbalsta dienestu par savām prasībām. Informāciju par klienta izveidi, vienreizējiem noslēpumiem, atsaukšanu un atjaunošanu skatiet sadaļā OAuth klienta akreditācijas dati.

​
Glabājiet akreditācijas datus savā aizmugursistēmā

Pakalpojuma kontu API atslēgām un OAuth klientu noslēpumiem jāatrodas servera puses noslēpumu glabātuvē. Neievietojiet tos pārlūkprogrammas kodā, mobilajās lietotnēs, versiju kontroles sistēmā vai žurnālos. Pakalpojuma konta akreditācijas dati darbojas kā darbslodze; tie nepierakstina personu un nenodrošina klienta piekrišanas plūsmu. Abām metodēm izmantojiet savas organizācijas reģionālo API resursdatoru. Mainot autentifikācijas metodi, resursa URL, API versija un operācijai nepieciešamās atļaujas nemainās.