Rothlú agus scriosadh eochracha
Ar an leathanach seo
Rothlú: Nuashonrú gan briseadh
Is cleachtas slándála ríthábhachtach é rothlú eochracha. Gineann sé eochair rúnda nua chun an ceann sean a chur in ionad gan an eochair féin a scriosadh. Déantar an sean-rún a bhailíochtú láithreach agus go buan.
Rothlú a dhéanamh
Réitíonn rothlú fadhb nach féidir le scriosadh a réiteach: an rún a nuashonrú gan céannacht na heochrach a chailleadh. Fanann a ACLanna, a teorainneacha ráta, agus a hainm slán tar éis an oibríochta, mar sin ní gá duit aon rud a athchumrú—ní athraíonn ach an rún i do stór. Déanann sé seo rothlú rialta praiticiúil; dá gcruthófá eochair nua, bheadh ort gach rud a athchumrú gach uair.
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"
Iompar rothlaithe
- Déantar an sean-eochair rúnda a bhailíochtú láithreach—teipfidh ar aon iarratas a úsáideann é le hearráid 401
- Gintear eochair rúnda nua agus filleadh é san fhreagra
- Fanann ID na heochrach (
apiKeyId), an t-ainm, na ACLanna, agus na teorainneacha ráta gan athrú - Taispeántar an eochair rúnda nua uair amháin – stóráil é láithreach
Próiseas rothlaithe slán
Tá cuid amháin den nós imeachta seo tábhachtach a chur in iúl toisc go gcuireann sé iontas go minic ar úsáideoirí: déantar an sean-rún a bhailíochtú láithreach. Níl aon tréimhse gháire ann ina n-oibríonn an dá rún. Teipfidh ar aon seirbhísí a úsáideann an seanluach fós an dara soicind tar éis an glaonna. Cinneann sé seo ord na sé chéim thíos: ullmhaigh do stór roimh an rothlú a spreagadh, ní ina dhiaidh.
- Ullmhaigh do bhonneagar chun glacadh le heochair nua (athróg timpeallachta, stór)
- Déan an rothlú tríd an API
- Nuashonraigh an rún i do stór láithreach
- Ath-imlonnaigh do sheirbhísí leis an eochair nua
- Fíoraigh go n-éiríonn leis na hiarratais leis an eochair nua
- Fíoraigh an leathadh trí
GET /auth/api-keys/{apiKeyId}/propagation
Cathain le rothlú
Spreagann trí chás rothlú, gach ceann acu le práinn éagsúil. Éilíonn sceitheadh amhrasta rothlú láithreach: fágann ball foirne a bhfuil rochtain eochrach aige, nochtar loga ina bhfuil eochair go poiblí, nó tá eochair i nglántéacs i stór Git. Sa chás seo, is uair an nochta gach uair fanachta, mar sin déan rothlú sula gcríochnaíonn tú anailís ar an teagmhas. Is coscach é rothlú bunaithe ar bheartas: gach 30, 60, nó 90 lá, ag brath ar do riachtanais slándála, cuireann sé teorainn le saolré eochrach a d’fhéadfadh a bheith sceite gan fhios. Ar deireadh, is deis nádúrtha iad athruithe timpeallachta—aistriú bonneagair nó athruithe soláthraí—chun tosú arís le heochracha glana seachas sean-eochracha a thabhairt isteach i gcomhthéacs nár dearadh dóibh riamh.
Eochair a scriosadh
Tá scriosadh buan agus dochúlaithe. Ní hé “An bhfuil an eochair seo curtha i mbaol?” an cheist le cur sula ndéantar scriosadh, ach “An bhfuil gá fós agam leis an raon feidhme rochtana seo?” Má tá an freagra dearfach, tá rothlú uait: díghníomhaíonn sé an rún nochttha agus coimeádann sé an chumraíocht. Níl údar le scriosadh ach amháin d’eochair nach bhfuil úsáideach a thuilleadh—tionscadal stoptha, soláthraí imeachta, nó timpeallacht díchoimisiúnaithe.
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"
Conas a imríonn scriosadh tionchar
- Scriostar an eochair agus a paraiméadair uile go buan
- Teipfidh ar gach iarratas a úsáideann an eochair seo láithreach
- Tá an gníomh dochúlaithe—beidh ort eochair nua le paraiméadair nua a chruthú
- Fanann stair úsáide na heochrach ar fáil san anailísíocht
Rothlú vs. Scriosadh
| Gné | Rothlú | Scriosadh |
|---|---|---|
| An bhfuil an eochair fós ann | Tá | Níl |
| An ngintear rún nua | Gintear | Ní ghintear |
| An gcoimeádtar ACLanna | Coimeádtar | Ní choimeádtar |
| An gcoimeádtar teorainneacha | Coimeádtar | Ní choimeádtar |
| An bhfuil sé inchúlaithe | Níl (cailleadh an sean-rún) | Níl (scriosadh na heochrach) |
| Úsáid tipiciúil | Nuashonrú rialta | Eochair atá in easnamh nó cur i mbaol deimhnithe |
Rothlú a uathoibriú
Ní bhíonn ciall le rothlú uathoibrithe ach amháin má tá scríobh chuig an stór mar chuid den script chéanna, gan aon idirghabháil láimhe eatarthu. Murach sin, ní dhéanann tú ach an riosca a aistriú: is mó an seans go gcríochnóidh rún a ghin meaisín agus a cóipeáladh de láimh i ngreimchlár nó i stair teirminéil ná eochair a cruthaíodh ón gconsól.
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
KEY_ID = "key-123"
# Rothlaigh
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")
# Stóráil i do stór (sampla le comhad .env)
# I dtáirgeadh, úsáid Vault, AWS Secrets Manager, etc.
print(f"New key generated. Update your vault.")
Rothlú sceidealta
Comhtháthaigh rothlú i do phíblíne CI/CD nó i bpost cron:
# Sampla Cron: rothlú ar an 1ú lá gach mí ag 3 AM
0 3 1 * * /opt/scripts/rotate-xai-keys.sh
Príomhphointí
- Déanann
POST /auth/api-keys/{apiKeyId}/rotatean sean-rún a bhailíochtú agus ceann nua a ghiniúint - Tá bailíochtú an tsean-rúin láithreach agus buan
- Scriosann
DELETE /auth/api-keys/{apiKeyId}an eochair go dochúlaithe - Is fearr rothlú ná scriosadh chun ACLanna agus teorainneacha atá ann cheana a choinneáil
- Uathoibrigh rothlú le script agus le stór rúnda
- Fíoraigh an leathadh i gcónaí tar éis rothlaithe