Rotazzjoni u tħassir ta' ċwievet
F'din il-paġna
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.
- Ipprepara l-infrastruttura tiegħek biex taċċetta ċavetta ġdida (varjabbli tal-ambjent, vault)
- Eżegwixxi r-rotazzjoni permezz tal-API
- Aġġorna s-sigriet fil-vault tiegħek immedjatament
- Erġa’ ddispjega s-servizzi tiegħek biċ-ċavetta l-ġdida
- Ivverifika li t-talbiet jirnexxu biċ-ċavetta l-ġdida
- 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
| Aspett | Rotazzjoni | Tħassir |
|---|---|---|
| Iċ-ċavetta għadha teżisti | Iva | Le |
| Sigriet ġdid iġġenerat | Iva | Le |
| ACLs ippreservati | Iva | Le |
| Limiti ppreżervati | Iva | Le |
| Riversibbli | Le (sigriet antik mitluf) | Le (ċavetta mħassra) |
| Użu tipiku | Tiġ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}/rotatejinvalida 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