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

Aizsargā savu API atslēgu: nekad neatklāj to klienta pusē

Nodarbība 6 no 12 Atjaunota 2026. gada 28. jūlijs Augstākais
Šajā lapā
  1. API atslēga ir parole
  2. Biežākie noplūdes ceļi
  3. Starpnieka arhitektūra: risinājums
  4. Droša atslēgu glabāšana
  5. Rīcība, ja atslēga ir apdraudēta
  6. Galvenās atziņas

API atslēga ir parole

Tava xAI API atslēga darbojas kā parole ar pilnu piekļuvi tavam kontam. Ikviens, kam tā ir, var veikt API izsaukumus uz tava rēķina, piekļūt taviem modeļiem un potenciāli apdraudēt tavus datus. Kā tā atšķiras no parastas paroles? Nozagta atslēga tiek izmantota klusi: tu neredzēsi neko, līdz pienāks rēķins vai līdz tava finanšu komanda izraisīs trauksmi. Noteikums ir vienkāršs un absolūts: nekad neatklāj API atslēgu klienta pusē.

Biežākie noplūdes ceļi

Visbiežākais gadījums ir tieša atslēgas iekļaušana frontend JavaScript kodā:

// BĪSTAMI - NEKAD nedari tā
const response = await fetch("https://api.x.ai/v1/chat/completions", {
  headers: { "Authorization": "Bearer xai-abc123..." }
});

Kad šis kods ir izvietots (deployed), tas ir redzams ikvienam, kurš izmanto pārlūka izstrādes rīkus. Pietiek atvērt cilni “Network”, lai nolasītu atslēgu skaidrā tekstā pieprasījuma galvenēs.

Viltīgāks noplūdes ceļš, jo tas rada maldīgu drošības sajūtu: frontend vides mainīgie. Mainīgie ar prefiksu NEXT_PUBLIC_, VITE_ vai REACT_APP_ tiek iekļauti JavaScript kodā būvēšanas (build) laikā un tādējādi kļūst publiski. Izstrādātājs domā, ka ir “paslēpis atslēgu no koda”; patiesībā tā ir vienkārši kompilēta tajā:

# BĪSTAMI - šis mainīgais nonāks saišķī (bundle)
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...

Git repozitoriji ir trešais klasiskais noplūdes ceļš. Pat dzēsts commits paliek Git vēsturē: ja esi kļūdas dēļ iekļāvis atslēgu, vēstures pārrakstīšana nepalīdzēs, jo kloni un atzarojumi (forks) to var būt saglabājuši. Uzskati to par apdraudētu un atsauc atslēgu. Visbeidzot, atslēgas noplūst arī caur netiešiem ceļiem, kurus grūtāk iedomāties, bet kas ir ļoti izplatīti: lietotņu žurnāli (logs), kas fiksē pilnas galvenes, lietotājam rādīti kļūdu ziņojumi vai uzraudzības rīki, kas uztver izejošos pieprasījumus.

Starpnieka arhitektūra: risinājums

Vienīgais drošais piegājiens ir virzīt visus izsaukumus caur savu backend serveri:

Klients (pārlūks/mobilā ierīce)
    ↓ pieprasījums bez API atslēgas
Tavs backend (serveris)
    ↓ pievieno API atslēgu (vides mainīgais)
xAI API
    ↓ atbilde
Tavs backend
    ↓ pārsūta atbildi (nepieciešamības gadījumā filtrētu)
Klients

Lūk, minimālistisks starpnieks Python valodā:

# Python backend (Flask)
import os
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"]  # Tikai servera puses mainīgais

@app.route("/api/chat", methods=["POST"])
def proxy_chat():
    user_message = request.json.get("message")

    response = requests.post(
        "https://api.x.ai/v1/chat/completions",
        headers={"Authorization": f"Bearer {XAI_KEY}"},
        json={
            "model": "grok-4.3",
            "messages": [{"role": "user", "content": user_message}]
        }
    )

    return jsonify(response.json())

Papildus atslēgas aizsardzībai – kas nekad netiek pārsūtīta klientam – starpnieks nodrošina kontroles punktu, ko tiešie izsaukumi padara neiespējamu. Tu vari filtrēt pieprasījumus: ierobežot ātrumu (rate limiting), lai novērstu klienta iztukšotu tavu kvotu, veikt ievades validāciju un satura moderāciju. Tu kontrolē, kuri modeļi ir pieejami, novēršot situāciju, kad nolaupīts klients izsauc dārgu modeli un rada negaidītus izdevumus. Tu vari žurnālēt izsaukumus revīzijai – kas ir centrāla prasība atbilstības vadītājam. Un tu vari kešot noteiktas atbildes, lai samazinātu izmaksas atkārtotiem pieprasījumiem.

Droša atslēgu glabāšana

Servera pusē pamatprasa ir vides mainīgais, kas tiek ielādēts no .env faila, kurš nekad netiek iekļauts Git:

# .env fails (NEKAD neiekļauj Git)
XAI_API_KEY=xai-your-secret-key

Sistemātiski pievieno šos failus savam .gitignore:

# .gitignore
.env
.env.local
.env.production

Ražošanas vidēm .env fails, kas novietots serverī, joprojām ir trausls manuāls process: dod priekšroku specializētam noslēpumu pārvaldniekam (secrets manager). Pierādītas opcijas ietver AWS Secrets Manager vai SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault, kā arī Doppler un Infisical vieglākām struktūrām. Ko šie rīki nodrošina vairāk nekā vienkāršs teksta fails: automātisku atslēgu rotāciju, piekļuves revīziju – kurš un kad lasīja konkrētu noslēpumu – un šifrēšanu miera stāvoklī (encryption at rest). Tie ir elementi, kurus vari prezentēt tāpat kā tie ir drošības revīzijas laikā, savukārt teksta fails uz mašīnas nepierāda neko.

Rīcība, ja atslēga ir apdraudēta

Ja ir aizdomas, ka atslēga ir atklāta, darbību secība ir tikpat svarīga kā pašas darbības. Atsauc atslēgu xAI konsolē (console.x.ai) pirms jeb kā cita: katra minūte, kamēr apdraudētā atslēga ir aktīva, ir minūte iespējamai ļaunprātīgai izmantošanai, un pakalpojuma nepārtrauktība tiek risināta pēc tam, nevis pirms. Tad ģenerē jaunu atslēgu un atjaunini savu backend, lai atjaunotu pakalpojumu.

Incidents vēl nav slēgts. Veic lietojuma revīziju, meklējot aizdomīgus API izsaukumus rēķinu vēsturē – straujš pieaugums neparastā laika logā vai lietojums, kas piedēvēts modelim, kuru neizmanto. Identificē noplūdes avotu, pretējā gadījumā jaunā atslēga sekos tam pašam ceļam kā vecā. Pabeidz, skenējot savu kodu ar tādiem rīkiem kā gitleaks vai truffleHog, kas arī pārlūko Git vēsturi un bieži atklāj citus sen aizmirstus noslēpumus.

Galvenās atziņas

  • API atslēga ir parole ar pilnu piekļuvi tavam kontam
  • Vienmēr virzi API izsaukumus caur savu backend
  • Mainīgie NEXT_PUBLIC_, VITE_, REACT_APP_ ir publiski
  • Ražošanā izmanto noslēpumu pārvaldnieku (secrets manager)
  • Ja atslēga ir apdraudēta, nekavējoties to atsauc un veic lietojuma revīziju