Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Võtmete pööramine ja kustutamine

Õppetund 4 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Pööramine: uuenda katkestusteta
  2. Teosta pööramine
  3. Kustuta võti
  4. Automatiseeri pööramine
  5. Peamised punktid

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.

  1. Valmista oma taristu ette uue võtme vastuvõtmiseks (keskkonnamuutuja, võlv)
  2. Teosta pööramine API kaudu
  3. Uuenda saladust oma võlvis viivitamatult
  4. Paiguta oma teenused uuesti kasutusele uue võtmega
  5. Kontrolli, et päringud uue võtmega õnnestuvad
  6. 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

AspektPööramineKustutamine
Võti on allesJahEi
Genereeritakse uus saladusJahEi
ACL-id säilivadJahEi
Piirangud säilivadJahEi
PööratavEi (vana saladus kadunud)Ei (võti kustutatud)
Tüüpiline kasutusRegulaarne uuendamineAegunud 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}/rotate tü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