Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Atslēgu rotācija un dzēšana

Nodarbība 4 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Rotācija: atjaunošana bez pārtraukumiem
  2. Rotācijas veikšana
  3. Atslēgas dzēšana
  4. Automatizē rotāciju
  5. Galvenās atziņas

Rotācija: atjaunošana bez pārtraukumiem

Atslēgu rotācija ir kritiska drošības prakse. Tā ģenerē jaunu slepeno atslēgu, lai aizstātu veco, nedzēšot pašu atslēgu. Vecais noslēpums tiek nekavējoties un neatgriezeniski anulēts.

Rotācijas veikšana

Rotācija atrisina problēmu, ko dzēšana nevar atrisināt: noslēpuma atjaunošanu, nezaudējot atslēgas identitāti. Tās ACL, ātruma ierobežojumi un nosaukums saglabājas pēc operācijas, tāpēc tev nav jāpārkonfigurē nekas — mainās tikai noslēpums tavā glabātuvē. Tas padara regulāru rotāciju praktisku; atslēgas izveide no jauna prasītu visu konfigurēt no jauna katru reizi.

POST /auth/api-keys/{apiKeyId}/rotate
curl -X POST "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/rotate" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Rotācijas darbība

  • Vecā slepenā atslēga tiek nekavējoties anulēta — visi pieprasījumi, kas to izmanto, neizdosies ar 401 kļūdu
  • Tiek ģenerēta un atbildē atgriezta jauna slepenā atslēga
  • Atslēgas ID (apiKeyId), nosaukums, ACL un ātruma ierobežojumi paliek nemainīgi
  • Jaunā slepenā atslēga tiek parādīta tikai vienreiz — nekavējoties to saglabā

Drošs rotācijas process

Viena šīs procedūras daļa ir pelnījusi uzsvaru, jo tā bieži pārsteidz lietotājus: vecais noslēpums tiek anulēts nekavējoties. Nav iepazīšanās perioda, kurā darbotos abi noslēpumi. Visi servisi, kas joprojām izmanto veco vērtību, neizdosies sekundi pēc izsaukuma. Tas nosaka turpmāk minēto sešu soļu secību: sagatavo savu glabātuvi pirms rotācijas izraisīšanas, nevis pēc tās.

  1. Sagatavo savu infrastruktūru jaunas atslēgas pieņemšanai (vides mainīgais, glabātuve)
  2. Veic rotāciju, izmantojot API
  3. Atjaunina noslēpumu savā glabātuvē nekavējoties
  4. Pārpublicē savus servisus ar jauno atslēgu
  5. Pārbaudi, vai pieprasījumi ar jauno atslēgu izdodas
  6. Pārbaudi propagāciju, izmantojot GET /auth/api-keys/{apiKeyId}/propagation

Kad veikt rotāciju

Rotāciju izraisa trīs situācijas, katrai ar atšķirīgu steidzamību. Aizdomas par noplūdi prasa tūlītēju rotāciju: komandas loceklis ar piekļuvi atslēgai aiziet, tiek publiskots žurnāls, kas satur atslēgu, vai Git repozitorijā ir atslēga skaidrā tekstā. Šādos gadījumos katra gaidīšanas stunda ir pakļautības stunda, tāpēc veic rotāciju pirms incidenta analīzes pabeigšanas. Uz politiku balstīta rotācija ir preventīva: ik pēc 30, 60 vai 90 dienām, atkarībā no tavām drošības prasībām, tā ierobežo tādas atslēgas dzīves ilgumu, kas varētu būt noplūdusi nepamanīta. Visbeidzot, vides izmaiņas — infrastruktūras migrācija vai pakalpojumu sniedzēju maiņa — ir dabiska iespēja sākt no jauna ar tīrām atslēgām, nevis nest līdzi vecās uz kontekstu, kuram tās nekad nav paredzētas.

Atslēgas dzēšana

Dzēšana ir pastāvīga un neatgriezeniska. Jautājums, kas jāuzdod pirms dzēšanas, nav „Vai šī atslēga ir kompromitēta?”, bet gan „Vai man joprojām ir nepieciešama šī piekļuves darbības joma?”. Ja atbilde ir jā, tev ir nepieciešama rotācija: tā neitralizē atklāto noslēpumu, saglabājot konfigurāciju. Dzēšana ir attaisnojama tikai tad, ja atslēga vairs nav noderīga — apturēts projekts, aizgājis piegādātājs vai likvidēta vide.

DELETE /auth/api-keys/{apiKeyId}
curl -X DELETE "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Dzēšanas sekas

  • Atslēga un visi tās parametri tiek pastāvīgi dzēsti
  • Visi pieprasījumi, kas izmanto šo atslēgu, nekavējoties neizdosies
  • Darbība ir neatgriezeniska — tev būs jāizveido jauna atslēga ar jauniem parametriem
  • Atslēgas lietojuma vēsture paliek pieejama analītikā

Rotācija pret dzēšanu

AspektsRotācijaDzēšana
Atslēga joprojām eksistēJāNē
Ģenerēts jauns noslēpumsJāNē
ACL saglabātiJāNē
Ierobežojumi saglabātiJāNē
AtgriezeniskaNē (vecs noslēpums zaudēts)Nē (atslēga dzēsta)
Tipiska izmantošanaRegulāra atjaunošanaNovecojusi atslēga vai apstiprināta kompromitācija

Automatizē rotāciju

Automatizēta rotācija ir jēga tikai tad, ja rakstīšana glabātuvē ir daļa no tā paša skripta bez manuālas iejaukšanās starpā. Pretējā gadījumā tu vienkārši nobīdi risku: ar mašīnu ģenerēts noslēpums, kas nokopēts ar roku, visticamāk nonāks starpliktuvē vai termināļa vēsturē nekā atslēga, kas izveidota no konsoles.

import requests
import json

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
KEY_ID = "key-123"

# Rotācija
response = requests.post(
    f"{MANAGEMENT_API}/auth/api-keys/{KEY_ID}/rotate",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

new_key = response.json()
new_secret = new_key.get("secret")

# Saglabā savā glabātuvē (piemērs ar .env failu)
# Ražošanā izmanto Vault, AWS Secrets Manager utt.
print(f"Jauna atslēga ģenerēta. Atjaunini savu glabātuvi.")

Plānota rotācija

Integrē rotāciju savā CI/CD cauruļvadā vai cron uzdevumā:

# Cron piemērs: rotācija katra mēneša 1. datumā plkst. 3:00
0 3 1 * * /opt/scripts/rotate-xai-keys.sh

Galvenās atziņas

  • POST /auth/api-keys/{apiKeyId}/rotate anulē veco noslēpumu un ģenerē jaunu
  • Vecā noslēpuma anulēšana ir nekavējoša un pastāvīga
  • DELETE /auth/api-keys/{apiKeyId} dzēš atslēgu neatgriezeniski
  • Dod priekšroku rotācijai nevis dzēšanai, lai saglabātu esošos ACL un ierobežojumus
  • Automatizē rotāciju ar skriptu un noslēpumu glabātuvi
  • Vienmēr pārbaudi propagāciju pēc rotācijas