Премини към основното съдържание
Български— Изберете език
Меню

Защитете своя API ключ: Никога не го излагайте на клиентската страна

Урок 6 от 12 Обновен 28 юли 2026 г. Напреднало
На тази страница
  1. API ключът е парола
  2. Често срещани вектори на излагане
  3. Прокси архитектура: Решението
  4. Сигурно съхранение на ключове
  5. Какво да правите, ако ключът Ви е компрометиран
  6. Ключови изводи

API ключът е парола

Вашият API ключ на xAI действа като парола с пълен достъп до акаунта Ви. Всеки, който го притежава, може да прави API заявки за Ваша сметка, да достига до Вашите модели и потенциално да компрометира Вашите данни. Как се различава от стандартната парола? Откраднат ключ може да бъде използван тихо: няма да забележите нищо, докато не пристигне фактурата или докато финансовият Ви екип не подаде сигнал. Правилото е просто и абсолютно: никога не излагайте API ключ на клиентската страна.

Често срещани вектори на излагане

Най-честият случай е директното включване на ключа във frontend JavaScript кода:

// ОПАСНО - НИКОГА не правете това
const response = await fetch("https://api.x.ai/v1/chat/completions", {
  headers: { "Authorization": "Bearer xai-abc123..." }
});

След като кодът бъде деплойнат, той става видим за всеки, който използва инструментите за разработчици в браузъра. Достатъчно е да отворите раздела Network (Мрежа), за да прочетете ключа в чист текст в хедърите на заявката.

По-коварен вектор, защото създава фалшиво усещане за сигурност, са променливите на средата във frontend-а. Променливите с префикс NEXT_PUBLIC_, VITE_ или REACT_APP_ се пакетират в JavaScript кода по време на изграждането (build time) и следователно са публични. Разработчикът смята, че е „пазил ключа извън кода“; в действителност той просто е компилиран в него:

# ОПАСНО - тази променлива ще бъде в пакета
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...

Git хранилищата са третият класически вектор. Дори изтрит комит остава в Git историята: ако сте комитнали ключ по грешка, презаписването на историята не е достатъчно, защото клонинги и форкове може да са го запазили. Считайте го за компрометиран и го анулирайте. Накрая, ключовете изтичат и чрез индиректни пътища, които са по-трудни за представяне, но много често срещани: логове на приложенията, които проследяват пълни хедъри, съобщения за грешки, показвани на потребителя, или инструменти за мониторинг, които прихващат изходящи заявки.

Прокси архитектура: Решението

Единственият сигурен подход е да проксирате всички заявки през Вашия бекенд:

Клиент (браузър/мобилно устройство)
    ↓ заявка без API ключ
Вашият бекенд (сървър)
    ↓ добавя API ключ (променлива на средата)
xAI API
    ↓ отговор
Вашият бекенд
    ↓ препраща отговора (филтриран при необходимост)
Клиент

Ето един минималистичен прокси сървър на Python:

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

app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"]  # Променлива само на сървъра

@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())

Освен защитата на ключа – който никога не се предава на клиента – проксито Ви предоставя контролна точка, която директните заявки правят невъзможна. Можете да филтрирате заявките: ограничаване на честотата (rate limiting), за да предотвратите изчерпването на квотата Ви от клиент, валидиране на входа, модериране на съдържанието. Вие контролирате кои модели са достъпни, предотвратявайки компрометиран клиент да извика скъп модел и да генерира неочаквани разходи. Можете да логвате обажданията за одит – централна нужда за ръководител по съответствието. И можете да кеширате определени отговори, за да намалите разходите при повтарящи се заявки.

Сигурно съхранение на ключове

На страната на сървъра базовото ниво е променливата на средата, заредена от .env файл, който никога не се комитва в Git:

# .env файл (НИКОГА не се комитва в Git)
XAI_API_KEY=xai-your-secret-key

Систематично добавяйте тези файлове във Вашия .gitignore:

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

За производствени среди .env файл, поставен на сървър, остава крехък ръчен процес: предпочитайте специализиран мениджър на тайни. Доказани опции включват AWS Secrets Manager или SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault, или Doppler и Infisical за по-леки структури. Какво предоставят тези инструменти над обикновения текстов файл: автоматична ротация на ключове, одит на достъпа – кой е чел коя тайна и кога – и криптиране в покой. Това са елементи, които можете да представите както си е по време на одит за сигурност, докато текстов файл на машина не доказва нищо.

Какво да правите, ако ключът Ви е компрометиран

Ако подозирате, че ключ е бил изложен, редът на операциите е също толкова важен, колкото и самите операции. Анулирайте ключа в конзолата на xAI (console.x.ai) преди всичко друго: всяка минута, през която компрометираният ключ остава активен, е минута възможна експлоатация, а непрекъснатостта на услугата се решава след това, а не преди. След това генерирайте нов ключ и актуализирайте бекендите си, за да възстановите услугата.

Инцидентът все още не е приключил. Направете одит на използването, като търсите подозрителни API обаждания във Вашата история на фактурирането – рязък скок през необичаен времеви прозорец, използване, приписано на модел, който не използвате. Идентифицирайте източника на изтичането, в противен случай новият ключ ще последва същия път като стария. Завършете със сканиране на кода си с инструменти като gitleaks или truffleHog, които също претърсват Git историята и често разкриват други тайни, забравени отдавна.

Ключови изводи

  • API ключът е парола с пълен достъп до акаунта Ви
  • Винаги проксирайте API заявките през Вашия бекенд
  • Променливите NEXT_PUBLIC_, VITE_, REACT_APP_ са публични
  • Използвайте мениджър на тайни в производствена среда
  • Ако ключ е компрометиран, анулирайте го незабавно и одитирайте използването