Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Turvapõhimõtted

Õppetund 14 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Groki API kasutamise turvamine
  2. Saladuste haldamine
  3. Regulaarne pööramine
  4. Minimaalsete õiguste printsiip
  5. Auditeerimine ja jälgimine
  6. Täielik turvakontrollnimekiri
  7. Peamised punktid
  8. Testi oma teadmisi

Groki API kasutamise turvamine

Haldus-API võti ei ole nagu teised võtmed: see ei kuluta tokeneid, vaid loob ja tühistab need, mis seda teevad. See, kes seda valdab, saab avada juurdepääsu, tõsta piiranguid ja kanda kulud teie meeskonna arvele. Seetõttu ei ole allpool toodud tavad vabatahtlik hügieen: need on erinevus intsidentide vahel, mis lahenevad tunniga, ja arve vahel, mis avastatakse alles kuu lõpus.

Seda õppetundi struktureerivad neli valdkonda, mis tugevdavad üksteist: kus saladused asuvad, kui sageli neid muudetakse, mida täpselt need lubavad ja kuidas märkad, kui midagi on valesti. Ükski neist ei piisa üksi – isegi ideaalselt hoitud võti, millel on üldine luba (wildcard), on ohtlik võti.

Saladuste haldamine

Põhireegel: Mitte kunagi lihttekstina

Võtit ei tohi kunagi kirjutada lihttekstina kohta, kust seda kopeeritakse, indekseeritakse või salvestatakse ilma teie otsese loata. Koodihoidlad on esikohal, isegi privaatsete puhul: privaatne hoidla muutub kogemata avalikuks, vahetab omanikku või jääb kolmanda osapoole tööriista vahemällu – ja Giti ajalugu ei unusta midagi, nii et üks kord sisestatud saladus jääb taastatavaks isegi pärast faili kustutamist.

Ülejäänud kolm klassikalist leket on salakavalamad, kuna need ei paista olevat salvestamine. Rakenduse logid salvestavad silumise käigus hea meelega täieliku päise ja saadavad seejärel agregeerijasse, mida kogu meeskond näeb. URL-id päringuparameetrites läbivad proksisid ja maanduvad iga vahendaja juurdepääsulogidesse. Ja võti, mis on kleepitud Slaki sõnumisse või piletisse, jääb sinna määramata ajaks, nähtav inimestele, kes polnud meeskonnas selle jagamise päeval. Kõigil neljal juhul ei varastatud võtit: süsteemid kopeerisid seda oma tööd tehes.

Soovitatavad võlvikud

Selle reegli teine pool on see, et võtmed vajavad legitiimset asukohta. Saladuste haldur täidab kolme funktsiooni, mida fail kunagi ei suuda: see krüpteerib puhkeolekus, jälgib, kes mida luges, ja võimaldab väärtust vahetada ilma rakendust uuesti kasutusele võtmata. Valik sõltub peamiselt teie olemasolevast taristust – oma pilveteenuse pakkuja tööriista kasutamine säästab ühe integratsiooni võrra.

  • HashiCorp Vault: Täielik lahendus automaatse pööramise, juurdepääsupoliitikate ja auditeerimisajalooga
  • AWS Secrets Manager: Kohalik integratsioon AWS-i ökosüsteemiga, automaatne pööramine
  • Google Secret Manager: GCP vasted, integratsioon Cloud Runi ja GKE-ga
  • Azure Key Vault: Microsoft Azure’i lahendus
  • Doppler: Pilvest sõltumatu lahendus, lihtne liides
  • 1Password / Bitwarden: Väikestele meeskondadele, sisaldab CLI-d

Soovitatud konfiguratsioon

# Halb: kodeeritud võti skriptis
MANAGEMENT_API_KEY="xai-mgmt-abc123..."  # ÄRA TEE SEDA

# Hea: too võlvikust
MANAGEMENT_API_KEY=$(vault kv get -field=key secret/xai/management)

# Hea: keskkonnamuutuja, mille süstib CI/CD
# Võti on konfigureeritud torustiku saladustes (GitHub Actions, GitLab CI jne)

Regulaarne pööramine

Pööramispoliitika

Määratle oma kontekstiga kohandatud pööramispoliitika:

RiskitasePööramise sagedusNäited
KõrgeIga 30 päeva tagantTäieliku juurdepääsuga võtmed (üldine luba)
KeskmineIga 90 päeva tagantTootevõtmed piiratud ACL-idega
MadalIga 180 päeva tagantKohaliku arenduse võtmed

Pööramise automatiseerimine

import requests
from datetime import datetime, timedelta

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ROTATION_DAYS = 90  # Pööra iga 90 päeva tagant

def check_and_rotate():
    """Kontrollib võtme vanust ja pöörab vajadusel."""
    response = requests.get(
        f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/api-keys",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    keys = response.json().get("apiKeys", [])
    now = datetime.now()

    for key in keys:
        created = datetime.fromisoformat(key.get("createdAt", "").replace("Z", "+00:00"))
        age_days = (now - created.replace(tzinfo=None)).days

        if age_days >= ROTATION_DAYS:
            key_id = key.get("id")
            name = key.get("name", "Unnamed")
            print(f"Pööramine nõutud [{name}] jaoks (vanus: {age_days} päeva)")

            # Teosta pööramine
            rotate_resp = requests.post(
                f"{MANAGEMENT_API}/auth/api-keys/{key_id}/rotate",
                headers={"Authorization": f"Bearer {MGMT_KEY}"}
            )

            if rotate_resp.status_code == 200:
                new_secret = rotate_resp.json().get("secret")
                print(f"  Uus võti genereeritud. Uuenda oma võlvikut.")
                # Salvesta new_secret oma võlvikusse
            else:
                print(f"  Pööramise viga: {rotate_resp.status_code}")

check_and_rotate()

Minimaalsete õiguste printsiip

Granulaarsed ACL-id

Minimaalsete õiguste printsiip taandub ühele täpsele küsimusele: kui see võti lekib homme, mida saab kolmas osapool sellega teha? Vestluse lõpp-punkti ja ühe mudelini piiratud võti annab lühikese vastuse. Üldise loa (wildcard) võti annab vastuse, mis algab sõnaga “kõike”. Piiramise hind on võtme loomisel null ja just seetõttu pead selle määrama sel hetkel, mitte pärast intsidenti.

{
  "acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
  "qps": 10,
  "qpm": 100
}

Väldi tootmises üldisi lubasid (*). Kui su rakendus kasutab ainult vestlust ühe mudeliga, anna juurdepääs ainult sellele.

Kiirusepiirangud ohutusvõrguna

ACL-id ütlevad, mida võti teha saab; kiirusepiirangud ütlevad, kui palju. Erinevus on oluline, sest isegi seaduslikult piiratud vestlusvõti võib tekitada märkimisväärse arve, kui keegi ei piira selle läbilaskevõimet. Määra igale võtmele qps, qpm ja tpm, kalibreerides need tegeliku kasutuse, mitte kujuteldavate tippude järgi: rakendusel, mis töötleb tipptunnil kümme päringut sekundis, pole põhjust olla autoriseeritud tuhandele. See piirang ei kaitse sind lekke eest, kuid muudab katastroofikulud hallatavaks ja annab sulle aega anomaalia avastamiseks, enne kui see kalliks läheb.

Auditeerimine ja jälgimine

Auditeerimislogid

Pida kõigi haldustoimingute ajakirja:

import logging
from datetime import datetime

# Konfigureeri logimine
logging.basicConfig(
    filename="/var/log/xai-management-audit.log",
    level=logging.INFO,
    format="%(asctime)s | %(levelname)s | %(message)s"
)

def log_operation(operation, key_name, details=""):
    """Logib haldustoimingu auditeerimisajakirja."""
    logging.info(f"{operation} | Võti: {key_name} | {details}")

# Kasutusnäited
log_operation("CREATE", "prod-backend-v2", "ACL-id: chat+embed, QPS: 50")
log_operation("ROTATE", "prod-backend-v2", "Planeeritud pööramine 90p")
log_operation("DELETE", "dev-former-intern", "Meeskonnast lahkumine")

Turvahoiatused

Logi on kasulik ainult uurimiseks; reaalajas kaitseb sind hoiatus. Printsiip selle valimisel, mida jälgida, on lihtne: saada hoiatus sündmuste kohta, millel pole tavapärases töös põhjust toimuda, sest ainult nende puhul püsib valepositiivsete määr piisavalt madalana, et meeskond jätkaks nende lugemist. Viis signaali väärivad seda staatust.

  • Tootmises loodud võti üldiste lubadega
  • Sisselogimiskatse kehtetu võtmega (401-vigade tipp)
  • Tuvastatud ebanormaalne tarbimine (ootamatu tipp)
  • Arve olekus FAILED (teenuse katkemise oht)
  • Võti aegumas (7 päeva enne)

Täielik turvakontrollnimekiri

Siin on kokkuvõtlikult see, mida need neli valdkonda praktikas annavad. See nimekiri on väärtuslik ainult siis, kui seda vaadatakse õigel ajal: esimene osa kasutuselevõtul, teine regulaarsete intervallidega, kolmas päeval, mil avastad võtme lekkimise – päeval, mil kellelgi pole rahu protseduuri improviseerimiseks.

Esmane kasutuselevõtt

  • Võtmed salvestatud võlvikusse, mitte kunagi lihttekstina
  • Piiravad ACL-id (tootmises ilma üldiste lubadeta)
  • Iga võtme jaoks konfigureeritud kiirusepiirangud
  • Automaatne haldusvõtme tervisekontroll
  • Olemasolev võtmete auditeerimise skript

Regulaarsed toimingud

  • Pööra võtmeid vastavalt määratletud poliitikale (30/90/180 päeva)
  • Võtmete ja nende õiguste igakuine auditeerimine
  • Võtmete ülevaatus meeskonnaliikme lahkumisel
  • Arvete kontroll (tuvasta FAILED olekud)
  • Jälgi ebanormaalseid tarbimishüppeid

Intsidendile reageerimine

  • Dokumenteeritud erakorraline pööramisprotseduur
  • Võime kohe piirata ACL-e (kasutades PUT-i)
  • Võime kustutada kompromiteeritud võti (kasutades DELETE’i)
  • Väljaselgitatud hädaabi kontaktid (turvameeskond, xAI tugi)

Peamised punktid

  • Salvesta kõik võtmed saladuste võlvikusse – mitte kunagi koodis lihttekstina
  • Rakenda minimaalsete õiguste printsiipi: piiratud ACL-id, tootmises ilma üldiste lubadeta
  • Automatiseeri võtmete pööramine vastavalt määratletud poliitikale (30 kuni 180 päeva)
  • Seadista regulaarsed auditeerimised ja hoiatused kriitiliste sündmuste jaoks
  • Dokumenteeri oma intsidentide lahendamise protseduur kompromiteeritud võtmete jaoks
  • Kombineeri piiratud ACL-id, kiirusepiirangud ja kulupiirangud mitmekihiliseks kaitseks

Testi oma teadmisi

Võtmete, arveldamise ja kasutuse haldamine API kaudu: ringkäik on lõppenud.

1. Milleks on mõeldud haldus-API?

Vastus: xAI konto programmeeritavaks haldamiseks: API-võtmed (loo, muuda, pööra, kustuta), arveldamine, piirangud ja analüütika – haldamine muutub skripteeritavaks.

2. Kuidas turvad võtme elutsüklit?

Vastus: Üks võti ühe kasutusjuhu kohta, regulaarne pööramine (loo uus, lülita üle, kustuta vana) ja viivitamatu kustutamine kahtluse korral – kõik automatiseeritav API kaudu.

3. Milliseid finantskaitsemeetmeid saad rakendada?

Vastus: Kulupiirangud, ettemakstud krediit ja jälgitav automaatne lisamine – eelarvekontroll konfiguratsiooni, mitte arve üllatuse kaudu.

4. Mida pakub kasutusanalüütika?

Vastus: Tarbimine võtme ja mudeli kaupa, täiustatud aruanded – piisavalt kulude jaotamiseks, anomaaliate tuvastamiseks ja tasemete suuruse määramiseks.

5. Milline eriettevaatusabinõu kehtib haldusvõtme enda jaoks?

Vastus: See on võtmete võti: maksimaalne ulatus, seega maksimaalne kaitse – mitte kunagi kliendipoolses osas, piiratud juurdepääs, regulaarne valideerimine ja pööramine nagu teistelgi.

Hallatud võtmed, piiratud eelarve, mõõdetud kasutus: xAI haldamine on kodeeritud – ja turvatud tasemel, mida see kaitseb.