Validēšana pārvaldības atslēgai
Šajā lapā
Pārbaudi savu atslēgu integritāti
Pārvaldības atslēgas validēšana ir tava API infrastruktūras pirmā aizsardzības līnija. Pirms jebkuras kritiskas operācijas — izvēršanas, rotācijas, rēķinu izmaiņām — pārliecinies, ka tava atslēga ir derīga un tai ir pareizas atļaujas.
Validēšanas galapunkts
GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Atbilde apstiprina, ka atslēga ir aktīva, un atgriež komandu, atļaujas un saistītos datumus. Nepalaid garām derīguma termiņu: tā ir vienīgā informācija, kas ļauj paredzēt pārtraukumu, nevis ciest no tā, jo beigusies atslēga tevi nebrīdina — tā vienkārši atgriež 401 pie pirmā sekojošā izsaukuma.
Kļūdu gadījumi
- 401 Unauthorized: Atslēga ir nederīga, beigusies vai dzēsta
- 403 Forbidden: Atslēga ir derīga, bet tai trūkst nepieciešamo atļauju pieprasītajai operācijai
Integrēšana tavos skriptos
Pārbaude palaišanas brīdī
Validēšana palaišanas brīdī pārceļ kļūmi uz vietu, kur tā rada vismazākos zaudējumus. Bez šīs pārbaudes nederīga atslēga izpaužas pie pirmā lietderīgā izsaukuma — tas ir, apstrādes vidū, dažreiz pēc tam, kad jau ir izpildīti vairāki soļi. Ar to skripts apstājas trīs sekundēs ar ziņojumu, kas nosauc cēloni.
import requests
import sys
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
def validate_management_key():
"""Pārbauda, vai pārvaldības atslēga ir derīga."""
try:
response = requests.get(
f"{MANAGEMENT_API}/auth/management-keys/validation",
headers={"Authorization": f"Bearer {MGMT_KEY}"},
timeout=10
)
if response.status_code == 200:
print("Pārvaldības atslēga derīga")
return True
elif response.status_code == 401:
print("KĻŪDA: Pārvaldības atslēga nederīga vai beigusies")
return False
else:
print(f"KĻŪDA: Negaidīts statuss {response.status_code}")
return False
except requests.exceptions.RequestException as e:
print(f"SAVIENOJUMA KĻŪDA: {e}")
return False
if not validate_management_key():
sys.exit(1)
Periodiska veselības pārbaude
Periodiska veselības pārbaude aptver to, ko palaišanas pārbaude palaiž garām: ilgstoši darbojošos servisus, kas palaisti pirms nedēļām un kuru atslēga var beigties vai tikt atsaukta ceļā. Stundas pārbaude ir pietiekama — galapunkts ir viegls un nelieto secinājumu tokenus.
#!/bin/bash
# healthcheck-xai.sh — palaist katru stundu caur cron
STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
"https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
if [ "$STATUS" != "200" ]; then
echo "BRĪDINĀJUMS: xAI pārvaldības atslēga nederīga (HTTP $STATUS)"
# Nosūtīt brīdinājumu (PagerDuty, Slack, e-pasts)
fi
Secinājumu atslēgu revīzija
Periodiska revīzija atbild uz trim jautājumiem, kurus neviens brīdinājums tev neuzdos: kurām atslēgām joprojām ir aizstājējzīme, kurām nav ātruma ierobežojumu un kuras nav lietotas mēnešiem. Pirmie divi ir riski, trešais — iespēja veikt tīrīšanu, un visi trīs tiek apstrādāti vienā piegājienā.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def audit_api_keys():
"""Veic visu komandas API atslēgu revīziju."""
response = requests.get(
f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/api-keys",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
keys = response.json().get("apiKeys", [])
print(f"=== API atslēgu revīzija — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
print(f"Kopējais atslēgu skaits: {len(keys)}")
for key in keys:
name = key.get("name", "Nenosaukta")
acls = key.get("acls", [])
expire = key.get("expireTime", "Nekad")
created = key.get("createdAt", "N/A")
# Brīdinājumi
warnings = []
# Atslēga ar piekļuvi, izmantojot aizstājējzīmes
if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
warnings.append("PIEKĻUVE VISAM (aizstājējzīmes)")
# Atslēga bez derīguma termiņa
if expire == "Never" or not expire:
warnings.append("NAV DERĪGUMA TERMIŅA")
# Atslēga bez ātruma ierobežojumiem
if not key.get("qps") and not key.get("qpm"):
warnings.append("NAV ĀTRUMA IEROBEŽOJUMU")
status = " | ".join(warnings) if warnings else "LABI"
print(f" [{name}] ACL: {len(acls)} | Beidzas: {expire} | {status}")
audit_api_keys()
Atslēgu drošības kontrolsaraksts
Pārvaldības atslēgas
Pārvaldības atslēgas kontrolē visu pārējo — to kompromitēšana piešķir piekļuvi visu secinājumu atslēgu izveidei, modificēšanai un dzēšanai. Tāpēc tām ir nepieciešama visstingrākā apstrāde: ekskluzīva glabāšana seifā, nekad kā skaidrs teksts kodā vai versijētā konfigurācijā; piekļuve ierobežota tikai infrastruktūras administratoriem, nevis lietotņu izstrādātājiem; un regulāra validēšana, izmantojot GET /auth/management-keys/validation, ideālā gadījumā automatizēta kā veselības pārbaude — beigusies pārvaldības atslēga, kas atklāta brīdī, kad tā steidzami nepieciešama, ir vissliktākais operacionālais scenārijs.
Secinājumu atslēgas (API atslēgas)
Secinājumu atslēgām vadošais princips ir izolācija: katra lietotne saņem savu atslēgu, nekad atslēgu, kas koplietota starp servisiem — pretējā gadījumā kompromitētas atslēgas rotācija pārtrauc visu servisu darbību vienlaicīgi, un analītika vairs neļauj attiecināt patēriņu. Katrai atslēgai ir restriktīvi ACL, kas kalibrēti tās faktiskajam lietojumam (nav aizstājējzīmju produkcijā), ātruma ierobežojumi, kas pielāgoti paredzētajai satiksmei, un derīguma termiņš, ja lietojums ir pagaidu — POC, kam paredzēts ilgt divas nedēļas, neprasa mūžīgu atslēgu. Regulāra revīzija, izmantojot iepriekš minēto skriptu, noslēdz ciklu: tā atklāj aizmirstas, pārlieku privilēģētas vai beidzošās atslēgas, pirms tās kļūst par problēmām.
Pienākumu atdalīšanas princips
Uzturi skaidru atdalīšanu starp atslēgām:
| Veids | Lietojums | Kam ir piekļuve |
|---|---|---|
| Pārvaldības atslēga | Administrēšana, rēķini, analītika | Infrastruktūras administratori |
| Produkcijas atslēga | API izsaukumi produkcijā | Produkcijas lietotne |
| Testēšanas atslēga | Pirmsprodukcijas testēšana | Izstrādes komanda |
| Izstrādes atslēga | Lokālā izstrāde | Atsevišķs izstrādātājs |
Katrai atslēgai ir definēts darbības apjoms. Ja izstrādātājs pamet komandu, tiek dzēsta tikai viņa izstrādes atslēga — pārējās paliek neskartas.
Galvenās atziņas
GET /auth/management-keys/validationpārbauda tavas pārvaldības atslēgas derīgumu- Integrē validēšanu savu skriptu palaišanā un uzraudzībā
- Regulāri veic visu atslēgu revīziju, lai noteiktu pārlieku plašu piekļuvi
- Atdali atslēgas pēc vides un atbildības
- Nekavējoties brīdini par nederīgu atslēgu (beigusies vai dzēsta)