> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API atslēgas

> Izveidojiet, nomainiet un atsauciet akreditācijas datus, kas autentificē pieprasījumus Living Security Public API.

API atslēgas autentificē pieprasījumus `/v1` Public API. Katra atslēga pieder
[pakalpojuma kontam](/lv/developers/developer-hub/service-accounts) un tiek
izveidota no šī konta informācijas lapas
[Developer Hub](/lv/developers/developer-hub/overview).

Izmantojiet ierobežota tvēruma API atslēgu privātai aizmugursistēmas integrācijai, ja slepenās vērtības droša glabāšana
un nomaiņa atbilst jūsu prasībām. OAuth klients vai pilnvaras
apmaiņa nav nepieciešama. Ja jūsu organizācijai tā vietā ir nepieciešamas īslaicīgas OAuth piekļuves pilnvaras, skatiet sadaļu
[Authentication](/lv/developers/v1/authentication).

## Atslēgas uzbūve

* **Identifier** — sākas ar `ak_`. Droši atsaukties uz to pieteikumos, žurnālos
  un konfigurācijā; pati par sevi tā nepiešķir nekādas tiesības.
* **Secret** — sākas ar `lsk_live_`. Tie ir akreditācijas dati, ko jūsu
  integrācija uzrāda. Tā tiek parādīta **vienu reizi** — izveides vai nomaiņas brīdī — un
  vēlāk to nevar atgūt. Atslēgu sarakstā tiek rādīti tikai pēdējie četri
  rakstzīmes (piemēram, `lsk_live_…xQc4`), lai varētu saskaņot rindu ar
  akreditācijas datiem, kas ir pieprasījuma veicējam.
* **Permissions** — pakalpojuma konta atļauju apakškopa,
  kas izvēlēta izveides brīdī. Atslēga nekad nevar darīt vairāk, nekā atļauj tās konts.
* **Expiration** — obligāts. Katrai atslēgai ir derīguma termiņš.

<Warning>
  Uzglabājiet slepenās vērtības slepeno datu pārvaldniekā uzreiz pēc to parādīšanas. Nekad
  neiekļaujiet tās versiju vadībā, neievietojiet klienta puses kodā un nedalieties ar tām
  tērzēšanā. Ikviens, kam ir slepenā vērtība, var darboties ar atslēgas atļaujām.
</Warning>

## Atslēgas izveide

Pakalpojuma konta informācijas lapā atslēgu izveidojiet četros soļos:
piešķiriet nosaukumu, izvēlieties atļaujas, kas nepieciešamas tieši šai atslēgai, izvēlieties derīguma termiņu
— 30, 90 vai 365 dienas, vai pielāgotu periodu līdz vienam gadam — un pārskatiet iestatījumus. Slepenā
vērtība tiek parādīta pēc pabeigšanas, vienu reizi.

Ierobežojiet katras atslēgas tvērumu līdz šaurākajam atļauju kopumam, kas nepieciešams tās lietotājam, pat ja
konts atļauj vairāk. Ja atslēga noplūst, tās atļaujas nosaka iespējamo seku apjomu.

## Nomaiņa bez dīkstāves

Nomaiņas laikā tiek izsniegta jauna slepenā vērtība un sākas pārklāšanās periods — 1 stunda,
24 stundas vai 7 dienas —, kura laikā **vecā slepenā vērtība turpina darboties**. Tas
ļauj ieviest jauno slepeno vērtību jūsu izvietojumos jums piemērotā tempā:

<Steps>
  <Step title="Nomainiet atslēgu">
    Izvēlieties pārklāšanās periodu, kas aptver jūsu lēnāko izvietošanas ceļu. Jaunā
    slepenā vērtība tiek parādīta vienu reizi — nekavējoties to saglabājiet.
  </Step>

  <Step title="Atjauniniet savas integrācijas">
    Aizstājiet veco slepeno vērtību visur, kur tā ir konfigurēta. Atslēgas statuss
    tiek rādīts kā in-overlap, līdz periods beidzas.
  </Step>

  <Step title="Pārbaudiet, pirms periods beidzas">
    Izmantojiet [pieprasījumu žurnālus](/lv/developers/developer-hub/request-logs), lai pārliecinātos, ka
    datplūsma ir pārgājusi uz jauno slepeno vērtību. Kad pārklāšanās periods beidzas, vecā slepenā vērtība
    vairs nenodrošina autentifikāciju.
  </Step>
</Steps>

Nomainiet atslēgu arī pirms derīguma termiņa beigām: atslēgas, kuru derīguma termiņš tuvojas beigām,
atslēgu sarakstā tiek atzīmētas kā expiring. Atslēga ar beigušos termiņu vairs nenodrošina autentifikāciju —
pieprasījumi, kas veikti ar to, atgriež `401` ar kodu
[`credential_expired`](/lv/developers/v1/errors/credential_expired).

## Tūlītēja atsaukšana

Atsaukšana stājas spēkā nekavējoties un ir neatgriezeniska — nav ne pārklāšanās
perioda, ne atsaukšanas iespējas. Atsauciet atslēgu tajā pašā brīdī, kad aizdomas, ka tās slepenā vērtība
ir atklāta; savukārt nomainiet atslēgu, ja aizstājat darbspējīgus akreditācijas datus.

Pieprasījumi, kas veikti ar atsauktu atslēgu, atgriež `401` ar kodu
[`credential_revoked`](/lv/developers/v1/errors/credential_revoked). Ja
nepieciešams vienlaikus apturēt visas integrācijas atslēgas, tā vietā atspējojiet tās
pakalpojuma kontu.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.