Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Rotazzjoni u tħassir ta' ċwievet

Lezzjoni 4 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Rotazzjoni: Ġeddid mingħajr interruzzjoni
  2. Eżegwixxi rotazzjoni
  3. Meta tagħmel rotazzjoni
  4. Ħassar ċavetta
  5. Awtomatizza r-rotazzjoni
  6. Punti Ewlenin

Rotazzjoni: Ġeddid mingħajr interruzzjoni

Ir-rotazzjoni taċ-ċwievet hija prattika kritika ta’ sigurtà. Din tiġġenera ċavetta sigrieta ġdida biex tissostitwixxi dik antika mingħajr ma tħassar iċ-ċavetta nnifisha. Is-sigriet antik jiġi invalidat immedjatament u b’mod permanenti.

Eżegwixxi rotazzjoni

Ir-rotazzjoni ssolvi problema li t-tħassir ma jistax isolvi: it-tiġdid tas-sigriet mingħajr ma tintilef l-identità taċ-ċavetta. L-ACLs, il-limiti tar-rata, u l-isem tagħha jibqgħu ħajjin wara l-operazzjoni, allura m’għandekx bżonn terġa’ tikkonfigura xejn—biss is-sigriet jinbidel fil-vault tiegħek. Dan jagħmel ir-rotazzjoni regolari prattika; il-ħolqien mill-ġdid ta’ ċavetta jkun jeħtieġ li terġa’ tikkonfigura kollox kull darba.

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"

Imġiba tar-rotazzjoni

  • Iċ-ċavetta sigrieta antika tiġi invalidata immedjatament—kull talba li tużaha se tfalli b’żball 401
  • Ċavetta sigrieta ġdida tiġi ġġenerata u rritornata fir-rispons
  • L-ID taċ-ċavetta (apiKeyId), l-isem, l-ACLs, u l-limiti tar-rata jibqgħu mingħajr bidla
  • Iċ-ċavetta sigrieta ġdida tintwera darba biss—aħżinha immedjatament

Proċess sigur ta’ rotazzjoni

Parti waħda minn din il-proċedura teħtieġ enfasi għax spiss tissorpri lill-utenti: is-sigriet antik jiġi invalidat immedjatament. M’hemm l-ebda perjodu ta’ grazzja fejn iż-żewġ sigrieti jaħdmu. Kwalunkwe servizz li għadu juża l-valur antik se jfalli fit-tieni sekonda wara s-sejħa. Dan jiddetta l-ordni tas-sitt passi hawn taħt: ipprepara l-vault tiegħek qabel ma ttriggerja r-rotazzjoni, mhux wara.

  1. Ipprepara l-infrastruttura tiegħek biex taċċetta ċavetta ġdida (varjabbli tal-ambjent, vault)
  2. Eżegwixxi r-rotazzjoni permezz tal-API
  3. Aġġorna s-sigriet fil-vault tiegħek immedjatament
  4. Erġa’ ddispjega s-servizzi tiegħek biċ-ċavetta l-ġdida
  5. Ivverifika li t-talbiet jirnexxu biċ-ċavetta l-ġdida
  6. Ivverifika il-propagazzjoni permezz ta’ GET /auth/api-keys/{apiKeyId}/propagation

Meta tagħmel rotazzjoni

Tliet sitwazzjonijiet jipprovokaw ir-rotazzjoni, kull waħda b’urġenza differenti. Tnissil suspettat jeħtieġ rotazzjoni immedjata: membru tat-tim b’aċċess għaċ-ċavetta jitlaq, log li fih ċavetta jiġi espost pubblikament, jew repository Git ikun fih ċavetta b’test ċar. F’dawn il-każijiet, kull siegħa ta’ stennija hija siegħa ta’ esponiment, allura agħmel ir-rotazzjoni qabel ma ttemm l-analiżi tal-inċident. Ir-rotazzjoni bbażata fuq il-politika hija preventiva: kull 30, 60, jew 90 jum, skont ir-rekwiżiti ta’ sigurtà tiegħek, dan jillimita t-tul tal-ħajja ta’ ċavetta li setgħet tnisslet mingħajr ma ndunajt. Fl-aħħar nett, bidliet fl-ambjent—migrazzjoni tal-infrastruttura jew bidliet tal-fornitur—huma opportunità naturali biex tibda mill-ġdid b’ċwievet nodfa minflok ma ġġorr dawk antiki f’kuntest li għalih qatt ma ġew iddisinjati.

Ħassar ċavetta

It-tħassir huwa permanenti u irrevokabbli. Il-mistoqsija li għandek tagħmel qabel ma tħassar mhix “Din iċ-ċavetta hija kompromessa?” iżda “Għadni bżonn dan l-ambitu ta’ aċċess?” Jekk it-tweġiba hija iva, għandek bżonn rotazzjoni: din tnewtralizza s-sigriet espost filwaqt li tippreserva l-konfigurazzjoni. It-tħassir huwa ġustifikat biss għal ċavetta li m’għadhiex utli—proġett waqaf, fornitur li telaq, jew ambjent li ġie diżattivat.

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"

Konsegwenzi tat-tħassir

  • Iċ-ċavetta u l-parametri kollha tagħha huma mħassra b’mod permanenti
  • It-talbiet kollha li jużaw din iċ-ċavetta se jfallu immedjatament
  • L-azzjoni hija irreversibbli—se jkollok bżonn toħloq ċavetta ġdida b’parametri ġodda
  • L-istorja tal-użu taċ-ċavetta tibqa’ disponibbli fl-analitika

Rotazzjoni vs Tħassir

AspettRotazzjoniTħassir
Iċ-ċavetta għadha teżistiIvaLe
Sigriet ġdid iġġeneratIvaLe
ACLs ippreservatiIvaLe
Limiti ppreżervatiIvaLe
RiversibbliLe (sigriet antik mitluf)Le (ċavetta mħassra)
Użu tipikuTiġdid regolariĊavetta obsoleta jew kompromessjoni kkonfermata

Awtomatizza r-rotazzjoni

Ir-rotazzjoni awtomatizzata tagħmel sens biss jekk il-kitba fil-vault hija parti mill-istess skript, mingħajr l-ebda intervent manwali bejniethom. Inkella, sempliċiment iċċaqlaq ir-riskju: sigriet iġġenerat minn magna kkupjat bl-idejn huwa aktar probabbli li jispiċċa fil-clipboard jew fl-istorja tat-terminal milli ċavetta maħluqa mill-konsol.

import requests
import json

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

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

# Store in your vault (example with a .env file)
# In production, use Vault, AWS Secrets Manager, etc.
print(f"New key generated. Update your vault.")

Rotazzjoni skedata

Integra r-rotazzjoni fil-pipeline CI/CD tiegħek jew f’job cron:

# Cron example: rotation on the 1st of each month at 3 AM
0 3 1 * * /opt/scripts/rotate-xai-keys.sh

Punti Ewlenin

  • POST /auth/api-keys/{apiKeyId}/rotate jinvalida s-sigriet antik u jiġġenera wieħed ġdid
  • L-invalidazzjoni tas-sigriet antik hija immedjata u permanenti
  • DELETE /auth/api-keys/{apiKeyId} iħassar iċ-ċavetta b’mod irreversibbli
  • Ippreferixxi r-rotazzjoni fuq it-tħassir biex iżżomm l-ACLs u l-limiti eżistenti
  • Awtomatizza r-rotazzjoni b’skript u vault tas-sigrieti
  • Dejjem ivverifika l-propagazzjoni wara rotazzjoni