Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Raktų sukimas ir šalinimas

Paskaita 4 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Sukimas: atnaujinimas be trikdžių
  2. Kaip atlikti sukimą
  3. Rakto šalinimas
  4. Automatizuokite sukimą
  5. Svarbiausi punktai

Sukimas: atnaujinimas be trikdžių

Raktų sukimas yra kritinė saugumo praktika. Ji sugeneruoja naują slaptąjį raktą, kuris pakeičia senąjį, nepašalinant paties rakto. Senasis slaptasis raktas iškart ir negrįžtamai panaikinamas.

Kaip atlikti sukimą

Sukimas išsprendžia problemą, kurios negali išspręsti šalinimas: slaptojo rakto atnaujinimą neprarandant rakto tapatybės. Jo ACL, spartos ribos ir pavadinimas išlieka nepakitę po operacijos, todėl nieko nereikia konfigūruoti iš naujo – jūsų saugykloje keičiasi tik slaptasis raktas. Tai daro reguliarų sukimą praktišku; rakto kūrimas iš naujo reikalautų viską konfigūruoti iš naujo kiekvieną kartą.

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"

Sukimo elgsena

  • Senasis slaptasis raktas iškart panaikinamas – bet kokie užklausos su juo nepavyks ir grąžins 401 klaidą
  • Sugeneruojamas ir atsakyme grąžinamas naujas slaptasis raktas
  • Rakto ID (apiKeyId), pavadinimas, ACL ir spartos ribos lieka nepakitę
  • Naujas slaptasis raktas rodomas tik vieną kartą – nedelsiant jį įsisaugokite

Saugus sukimo procesas

Viena šios procedūros dalis nusipelno ypatingo dėmesio, nes ji dažnai nustebina naudotojus: senasis slaptasis raktas panaikinamas iškart. Nėra jokio lengvatinio laikotarpio, kai veiktų abu slaptieji raktai. Bet kurios paslaugos, vis dar naudojančios senąją reikšmę, nustos veikti antrąją sekundę po iškvietimo. Tai lemia žemiau pateiktų šešių žingsnių eiliškumą: paruoškite savo saugyklą prieš inicijuodami sukimą, o ne po jo.

  1. Paruoškite savo infrastruktūrą priimti naują raktą (aplinkos kintamasis, saugykla)
  2. Atlikite sukimą per API
  3. Atnaujinkite slaptąjį raktą savo saugykloje nedelsiant
  4. Perdiekite savo paslaugas su naujuoju raktu
  5. Patikrinkite, ar užklausos su naujuoju raktu vyksta sėkmingai
  6. Patikrinkite plitimą naudodami GET /auth/api-keys/{apiKeyId}/propagation

Kada sukti raktus

Trys situacijos skatina raktų sukimą, kiekviena su skirtingu skubumu. Įtariamas nutekėjimas reikalauja neatidėliotino sukimo: komandos narys, turėjęs prieigą prie rakto, palieka įmonę, viešai atskleidžiamas žurnalas su raktu arba „Git“ saugykloje yra raktas grynuoju tekstu. Tokiais atvejais kiekviena laukimo valanda yra papildoma poveikio valanda, todėl sukkite raktus prieš baigdami incidento analizę. Politika pagrįstas sukimas yra prevencinis: kas 30, 60 arba 90 dienų, priklausomai nuo jūsų saugumo reikalavimų, jis riboja galimo netyčia nutekėjusio rakto gyvavimo trukmę. Galiausiai, aplinkos pokyčiai – infrastruktūros migracija arba tiekėjo keitimas – yra natūrali proga pradėti nuo švaraus lapo su naujais raktais, užuot perkeliant senus į kontekstą, kuriam jie niekada nebuvo skirti.

Rakto šalinimas

Šalinimas yra negrįžtamas ir neatšaukiamas. Klausimas, kurį reikia užduoti prieš šalinant, yra ne „Ar šis raktas kompromituotas?“, o „Ar man vis dar reikia šios prieigos apimties?“. Jei atsakymas taip, jums reikia sukimo: jis neutralizuoja atskleistą slaptąjį raktą, išsaugodamas konfigūraciją. Šalinimas yra pateisinamas tik tada, kai raktas nebenaudingas – sustabdytas projektas, išėjęs tiekėjas arba nenaudojama aplinka.

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"

Šalinimo pasekmės

  • Raktas ir visi jo parametrai yra visam laikui ištrinami
  • Visos užklausos, naudojant šį raktą, iškart nepavyks
  • Veiksmas yra negrįžtamas – teks sukurti naują raktą su naujais parametrais
  • Rakto naudojimo istorija lieka prieinama analitikos skiltyje

Sukimas prieš šalinimą

AspektasSukimasŠalinimas
Raktas vis dar egzistuojaTaipNe
Sugeneruojamas naujas slaptasis raktasTaipNe
ACL išsaugomiTaipNe
Ribos išsaugomosTaipNe
GrįžtamumasNe (senas slaptasis raktas prarastas)Ne (raktas ištrintas)
Tipinis naudojimasReguliarus atnaujinimasPasenęs raktas arba patvirtintas kompromitavimas

Automatizuokite sukimą

Automatizuotas sukimas turi prasmę tik tada, kai rašymas į saugyklą yra tos pačios scenarijaus dalis, be jokio rankinio įsikišimo tarp jų. Priešingu atveju jūs tiesiog perkeliate riziką: mašinos sugeneruotas slaptasis raktas, nukopijuotas rankiniu būdu, greičiau atsidurs iškarpinėje arba terminalo istorijoje nei konsolėje sukurtas raktas.

import requests
import json

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

# Sukti
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")

# Įrašyti į savo saugyklą (pavyzdys su .env failu)
# Gamyboje naudokite Vault, AWS Secrets Manager ir kt.
print(f"Sugeneruotas naujas raktas. Atnaujinkite savo saugyklą.")

Suplanuotas sukimas

Integruokite sukimą į savo CI/CD vamzdyną arba cron užduotį:

# Cron pavyzdys: sukimas kiekvieno mėnesio 1-ąją 3 val. ryto
0 3 1 * * /opt/scripts/rotate-xai-keys.sh

Svarbiausi punktai

  • POST /auth/api-keys/{apiKeyId}/rotate panaikina senąjį slaptąjį raktą ir sugeneruoja naują
  • Senojo slaptojo rakto panaikinimas yra momentinis ir negrįžtamas
  • DELETE /auth/api-keys/{apiKeyId} negrįžtamai ištrina raktą
  • Teikite pirmenybę sukimui, o ne šalinimui, kad išlaikytumėte esamus ACL ir ribas
  • Automatizuokite sukimą naudodami scenarijų ir slaptųjų duomenų saugyklą
  • Visada patikrinkite plitimą po sukimo