Võtmete pööramine ja kustutamine
Sellel lehel
Pööramine: uuenda katkestusteta
Võtmete pööramine on kriitiline turvatava. See genereerib vana salajase võtme asendamiseks uue, kustutamata seejuures võtit ennast. Vana saladus tühistatakse koheselt ja pöördumatult.
Teosta pööramine
Pööramine lahendab probleemi, mida kustutamine ei suuda: salajase võtme uuendamine võtme identiteeti kaotamata. Selle ACL-id, kiirusepiirangud ja nimi jäävad alles, nii et sul pole vaja midagi ümber seadistada – muutub ainult sinu võlvis hoitav saladus. See muudab regulaarse pööramise praktiliseks; võtme uuesti loomine nõuaks iga kord kõige ümberseadistamist.
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"
Pööramise käitumine
- Vana salajane võti tühistatakse koheselt – kõik seda kasutavad päringud ebaõnnestuvad veaga 401
- Genereeritakse uus salajane võti ja tagastatakse see vastuses
- Võtme ID (
apiKeyId), nimi, ACL-id ja kiirusepiirangud jäävad muutumatuks - Uut salajast võtit näidatakse ainult üks kord – salvesta see viivitamatult
Turvaline pööramisprotsess
Üks protseduuri osa väärib rõhutamist, kuna see üllatab kasutajaid sageli: vana saladus tühistatakse koheselt. Puudub graatsiaperiood, mil mõlemad saladused töötaksid. Kõik teenused, mis kasutavad endist väärtust, lakkavad toimimast sekund pärast väljakutset. See määrab allpool toodud kuue sammu järjekorra: valmista oma võlv ette enne pööramise käivitamist, mitte pärast seda.
- Valmista oma taristu ette uue võtme vastuvõtmiseks (keskkonnamuutuja, võlv)
- Teosta pööramine API kaudu
- Uuenda saladust oma võlvis viivitamatult
- Paiguta oma teenused uuesti kasutusele uue võtmega
- Kontrolli, et päringud uue võtmega õnnestuvad
- Kontrolli levikut käsuga
GET /auth/api-keys/{apiKeyId}/propagation
Millal pöörata
Pööramist tingivad kolm olukorda, millest igaühel on erinev kiireloomulisus. Kahtlustatav lekkimine nõuab viivitamatut pööramist: meeskonnaliige, kellel oli võtmele juurdepääs, lahkub, logi, mis sisaldab võtit, avaldatakse või Git’i hoidla sisaldab võtit lihttekstina. Nendel juhtudel on iga ootetund üks tund riski, seega pööra võti enne intsidentanalüüsi lõpetamist. Poliitikapõhine pööramine on ennetav: iga 30, 60 või 90 päeva tagant, sõltuvalt sinu turvanõuetest, piirab see võtme eluiga, mis võinuks märkamatult lekkida. Lõpuks on keskkonnamuutused – taristu migratsioon või teenusepakkuja vahetus – loomulik võimalus alustada puhtalt lehelt uute võtmetega, selle asemel et viia vanad võtmed konteksti, mille jaoks need kunagi mõeldud polnud.
Kustuta võti
Kustutamine on püsiv ja pöördumatu. Küsimus, mille enne kustutamist endalt küsida, ei ole „Kas see võti on kompromiteeritud?“, vaid „Kas mul on seda juurdepääsuvahemikku veel vaja?“. Kui vastus on jaatav, vajad pööramist: see neutraliseerib lekkinud saladuse, säilitades samal ajal konfiguratsiooni. Kustutamine on õigustatud ainult võtme puhul, mis pole enam kasulik – peatatud projekt, lahkunud teenusepakkuja või likvideeritud keskkond.
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"
Kustutamise tagajärjed
- Võti ja kõik selle parameetrid kustutatakse püsivalt
- Kõik seda võtit kasutavad päringud ebaõnnestuvad koheselt
- Tegevus on pöördumatu – pead looma uue võtme uute parameetritega
- Võtme kasutusajalugu jääb analüütikas kättesaadavaks
Pööramine vs kustutamine
| Aspekt | Pööramine | Kustutamine |
|---|---|---|
| Võti on alles | Jah | Ei |
| Genereeritakse uus saladus | Jah | Ei |
| ACL-id säilivad | Jah | Ei |
| Piirangud säilivad | Jah | Ei |
| Pööratav | Ei (vana saladus kadunud) | Ei (võti kustutatud) |
| Tüüpiline kasutus | Regulaarne uuendamine | Aegunud võti või kinnitatud kompromiteerimine |
Automatiseeri pööramine
Automatiseeritud pööramine on mõttekas ainult siis, kui kirjutamine võlvi on sama skripti osa, ilma vahepealse manualse sekkumiseta. Vastasel juhul lihtsalt nihutad riski: masina genereeritud saladus, mis kopeeritakse käsitsi, satub suurema tõenäosusega lõikelauale või terminali ajalukku kui konsoolist loodud võti.
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
KEY_ID = "key-123"
# Pööra
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")
# Salvesta oma võlvi (näide .env failiga)
# Tootmiskeskkonnas kasuta Vaulti, AWS Secrets Managerit vms.
print(f"Uus võti genereeritud. Uuenda oma võlvi.")
Planeeritud pööramine
Integreeri pööramine oma CI/CD torustikku või cron-tööna:
# Croni näide: pööramine iga kuu 1. kuupäeval kell 3
0 3 1 * * /opt/scripts/rotate-xai-keys.sh
Peamised punktid
POST /auth/api-keys/{apiKeyId}/rotatetühistab vana saladuse ja genereerib uue- Vana saladuse tühistamine on kohene ja püsiv
DELETE /auth/api-keys/{apiKeyId}kustutab võtme pöördumatult- Eelista pööramist kustutamisele, et säilitada olemasolevad ACL-id ja piirangud
- Automatiseeri pööramine skripti ja saladuste võlviga
- Kontrolli alati levikut pärast pööramist