Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Validēšana pārvaldības atslēgai

Nodarbība 13 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Pārbaudi savu atslēgu integritāti
  2. Validēšanas galapunkts
  3. Integrēšana tavos skriptos
  4. Secinājumu atslēgu revīzija
  5. Atslēgu drošības kontrolsaraksts
  6. Pienākumu atdalīšanas princips
  7. Galvenās atziņas

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:

VeidsLietojumsKam ir piekļuve
Pārvaldības atslēgaAdministrēšana, rēķini, analītikaInfrastruktūras administratori
Produkcijas atslēgaAPI izsaukumi produkcijāProdukcijas lietotne
Testēšanas atslēgaPirmsprodukcijas testēšanaIzstrādes komanda
Izstrādes atslēgaLokālā izstrādeAtsevišķ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/validation pā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)