Atslēgu rotācija un dzēšana
Šajā lapā
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.
- Sagatavo savu infrastruktūru jaunas atslēgas pieņemšanai (vides mainīgais, glabātuve)
- Veic rotāciju, izmantojot API
- Atjaunina noslēpumu savā glabātuvē nekavējoties
- Pārpublicē savus servisus ar jauno atslēgu
- Pārbaudi, vai pieprasījumi ar jauno atslēgu izdodas
- 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
| Aspekts | Rotācija | Dzēšana |
|---|---|---|
| Atslēga joprojām eksistē | Jā | Nē |
| Ģenerēts jauns noslēpums | Jā | Nē |
| ACL saglabāti | Jā | Nē |
| Ierobežojumi saglabāti | Jā | Nē |
| Atgriezeniska | Nē (vecs noslēpums zaudēts) | Nē (atslēga dzēsta) |
| Tipiska izmantošana | Regulāra atjaunošana | Novecojusi 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}/rotateanulē 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