Raktų sukimas ir šalinimas
Šiame puslapyje
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.
- Paruoškite savo infrastruktūrą priimti naują raktą (aplinkos kintamasis, saugykla)
- Atlikite sukimą per API
- Atnaujinkite slaptąjį raktą savo saugykloje nedelsiant
- Perdiekite savo paslaugas su naujuoju raktu
- Patikrinkite, ar užklausos su naujuoju raktu vyksta sėkmingai
- 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ą
| Aspektas | Sukimas | Šalinimas |
|---|---|---|
| Raktas vis dar egzistuoja | Taip | Ne |
| Sugeneruojamas naujas slaptasis raktas | Taip | Ne |
| ACL išsaugomi | Taip | Ne |
| Ribos išsaugomos | Taip | Ne |
| Grįžtamumas | Ne (senas slaptasis raktas prarastas) | Ne (raktas ištrintas) |
| Tipinis naudojimas | Reguliarus atnaujinimas | Pasenę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}/rotatepanaikina 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