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

ACL и принципът на най-малките привилегии

Урок 8 от 12 Обновен 28 юли 2026 г. Напреднало
На тази страница
  1. Прилагане на принципа на най-малките привилегии към API
  2. Системата за ACL на xAI
  3. Ограничения на скоростта: Допълнителен слой за сигурност
  4. Стратегия с отделен ключ за всяка среда
  5. Проверка и одит на разрешенията
  6. Ключови изводи

Прилагане на принципа на най-малките привилегии към API

Принципът на най-малките привилегии е една от най-старите концепции в киберсигурността: всеки компонент на системата трябва да има достъп само до ресурсите, строго необходими за неговата работа. Идеята е интуитивна, когато я пренесете във физическия свят – не давате главния ключ на сградата на човека, който полива растенията във фоайето. Приложено към API ключовете на xAI, това означава, че всеки ключ трябва да бъде ограничен само до крайните точки (endpoints) и моделите, от които приложението, което го носи, действително се нуждае. Ако този ключ някога изтече, нападателят наследява неговите разрешения: ключ, ограничен до чат с един единствен модел, причинява безкрайно по-малко щети от ключ, който отваря целия каталог.

xAI прилага този принцип чрез гранулирана система за списъци за контрол на достъпа (ACL), която ще разгледаме подробно по-долу.

Системата за ACL на xAI

ACL следват формата api-key:{type}:{value}. Два типа ви засягат ежедневно: api-key:endpoint:{endpoint} ограничава достъпните крайни точки, а api-key:model:{model_id} ограничава използваемите модели. Съществува и заместващ символ (wildcard) api-key:endpoint:*, който предоставя достъп до всички крайни точки – удобно за разработка, но забранено в продукционна среда, точно защото отрича ползата от принципа на най-малките привилегии.

Крайните точки, които можете да упълномощите индивидуално, са: chat (завършване на чат, далеч най-честият случай), embed (генериране на вграждания), image (генериране и редактиране на изображения), models (консултиране на списък с модели), tokenize (токенизиране на текст), documents (управление на документи) и sample (семплиране).

Нека видим как изглежда това в реален пример. Представете си чатбот за поддръжка на клиенти, който използва само модела grok-4.3 в режим на чат. Неговият идеален ключ изглежда така:

{
  "name": "support-chatbot-prod",
  "acls": [
    "api-key:endpoint:chat",
    "api-key:model:grok-4.3"
  ],
  "qps": 5,
  "qpm": 100,
  "tpm": 500000,
  "expireTime": "2026-12-31T23:59:59Z"
}

Прочетете тази конфигурация като договор: ключът може да достъпва само крайната точка за чат – никакви изображения, никакви вграждания, следователно няма възможност за злоупотреба за тези цели. Той може да използва само grok-4.3, което предотвратява случайни (или злонамерени) обаждания към по-скъпи модели. Той е ограничен до 5 заявки в секунда и 100 в минута и ще изтече на известна дата. Ако разработчик по проекта някога се опита да добави генериране на изображения, без да каже на никого, API ще откаже: техническото ограничение налага архитектурното решение.

Ограничения на скоростта: Допълнителен слой за сигурност

ACL отговарят на въпроса „какво“, докато ограниченията на скоростта отговарят на „колко“. QPS (Заявки в секунда) ограничава броя на заявките за секунда: това е вашата защита срещу случайни скокове – безкраен цикъл, въведен от рефакторинг в петък вечер, или DDoS атака, отскачаща от вашето приложение. QPM (Заявки в минута) изглажда трафика за по-дълъг период и улавя злоупотреби, които биха останали под радара на QPS. TPM (Токени в минута) накрая ограничава обема на консумираните токени: той предпазва от много дълги индивидуални заявки – потребител, който поставя документ от 200 страници във вашия чатбот – които биха изчерпали бюджета ви за минути, без никога да надвишават разрешения брой заявки.

Стратегия с отделен ключ за всяка среда

На практика не конфигурирате един единствен ключ, а семейство от ключове, като всяка среда има своята логика. В средата за разработка обръщате логиката на продукционната среда: широк достъп, строги ограничения.

{
  "name": "dev-team-alpha",
  "acls": ["api-key:endpoint:*", "api-key:model:*"],
  "qps": 2,
  "qpm": 30,
  "tpm": 100000,
  "expireTime": "2026-06-30T23:59:59Z"
}

Разработчиците могат да изследват всичко, но ниските ограничения избягват изненади във фактурирането, ако тест се обърка. В staging средата, напротив, възпроизвеждате точно ACL на продукционната среда (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): това е единственият начин да откриете проблем с разрешенията предварително – ако кодът в staging се опита да направи обаждане, което продукционната среда ще откаже, по-добре е да го откриете сега, отколкото в първия час след пускането на живо. Продукционният ключ обаче комбинира строгите разрешения на staging с ограничения, оразмерени за реален трафик (например QPS 20, QPM 600, TPM 2000000) и планирана дата на изтичане – "expireTime": "2027-03-31T23:59:59Z" за ключ с име prod-chatbot-v2.

Проверка и одит на разрешенията

За да видите какво действително може да прави един активен ключ, направете заявка към API със самия ключ:

curl https://api.x.ai/v1/api-key \
  -H "Authorization: Bearer $XAI_API_KEY"

Отговорът изброява ефективните ACL, статусите api_key_blocked и api_key_disabled, маскирана версия на ключа (redacted_api_key) и team_id. Направете си навик редовно да сравнявате тези ACL с действителните нужди на приложението: разрешенията имат тенденция да се натрупват с времето и никога не намаляват спонтанно. От страна на моделите, крайната точка GET /auth/teams/{teamId}/models връща списък с моделите, налични за вашия екип, заедно с техните цени – ценна информация за дефиниране на подходящи ACL за модели и изключване на скъпи модели, които не използвате.

За да затвърдите всичко това, извършете пълен одит на вашите ключове. Избройте активните ключове за всеки екип, след което направете заявка за всеки от тях: дали неговите ACL са минимални, без заместващи символи в продукционна среда? Дали неговите ограничения на скоростта са разумни? Зададена ли е дата на изтичане? Дали името му идентифицира приложението и средата – „prod-chatbot-v2“ разказва история, докато „key-test-2“ не казва нищо? Изтрийте осиротелите ключове и документирайте резултата: този документ ще послужи като отправна точка за следващия одит и ще видите с един поглед какво се е отклонило междувременно.

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

  • Всеки ключ трябва да има ограничителни ACL: само необходимите крайни точки и модели
  • Никога не използвайте заместващ символ * в продукционна среда
  • Комбинирайте ACL с ограничения на скоростта (QPS, QPM, TPM), адаптирани към реалната употреба
  • Създавайте отделни ключове за всяка среда (dev, staging, prod) и за всяко приложение – staging със същите ACL като prod
  • Редовно одитирайте разрешенията на вашите активни ключове чрез GET /v1/api-key