API kalitlar va rollar

Barcha API yo’llari konsol bilan bir xil manzilda /api bilan boshlanadi. Dastur X-API-Key sarlavhasidagi API kalit bilan autentifikatsiya qiladi:

curl https://soc.example.com/api/findings?limit=20 \
  -H "X-API-Key: legit_…"

Kalit bitta tenantga tegishli va faqat shu tenant ma’lumotlarini ko’radi.

Kalit yaratish

Administrator kalitlarni Sozlamalar → API Kalitlari bo’limida yaratadi. Kalit faqat bir marta — yaratilganda ko’rsatiladi; o’shanda nusxa oling. U legit_ bilan boshlanadi va faqat uning SHA-256 hash’i saqlanadi.

Har bir kalitning muddati tugaydi. Kalit yaratilgandan boshlab ko’pi bilan bir yil yashaydi; undan keyingi muddat shu chegaragacha qisqartiriladi.

Kalitlarni ADMIN kaliti yoki sessiyasi bilan API orqali ham boshqarish mumkin:

Metod	Yo’l	Nima qiladi
POST	/api/auth/api-keys	Kalit yaratish: {"role": "ANALYST", "scopes": ["read", "write"], "expires_at": "2027-01-01T00:00:00Z"}
GET	/api/auth/api-keys	Kalitlar ro’yxati: id, rol, scope’lar, yaratilgan, oxirgi ishlatilgan vaqt, muddati. Kalitning o’zi hech qachon.
DELETE	/api/auth/api-keys/{id}	Kalitni darhol bekor qilish

Kalitni yaratish ham, bekor qilish ham audit logga yoziladi.

Kalit tenantga ham, uni yaratgan odamga ham tegishli. O’sha odam to’xtatilsa yoki o’chirilsa, kalit ishlashdan to’xtaydi, roli pasaytirilsa, kalit ham pasayadi. Kalit boshqa kalit yarata olmaydi. GET /api/auth/api-keys har bir kalitni kim yaratganini created_byda ko’rsatadi; 2026-yil 6-noyabrgacha yaratilgan kalitlarda u yo’q va ular muddati tugaguncha ishlaydi, shuning uchun ularni almashtiring.

Rollar

Kalitning bitta roli bor va rol yuqori chegarani belgilaydi:

Rol	Nima qila oladi
VIEWER	Alertlar, hodisalar, tekshiruvlar va hisobotlarni o’qish
ANALYST	VIEWER qila oladigan hammasi, hamda hodisa yuborish, alertlarni saralash, javob choralarini so’rash va boshqa odamning so’rovini tasdiqlash
ADMIN	ANALYST qila oladigan hammasi, hamda foydalanuvchilar, kalitlar va agentlarni boshqarish, to’g’ridan-to’g’ri agentga navbatga qo’yilgan buyruqlarni tasdiqlash

Scope’lar

Kalit o’z roli doirasida faqat scope’lari ruxsat bergan ishni qiladi:

Scope	Nima uchun kerak
read	GET so’rovlari
write	POST, PUT, PATCH va DELETE so’rovlari
admin	ADMIN roli talab qilinadigan har qanday so’rov. ADMIN kalitida u bo’lishi shart.

Rol ruxsat bergan, lekin scope ruxsat bermagan so’rov 403 va API key scope is not sufficient bilan rad etiladi.

Boshqa kirish usullari

Usul	Kim ishlatadi
X-API-Key: legit_…	Skriptlar va boshqa tizimlar
Authorization: Bearer <JWT>	/api/auth/login orqali kirgan sessiyalar
Sessiya cookie	Brauzerdagi konsol. Holatni o’zgartiradigan so’rovlar csrf_token cookie’siga mos X-CSRF-Token sarlavhasini ham yuborishi kerak.

API kalit yoki bearer token bilan yuborilgan so’rovlarga CSRF sarlavhasi kerak emas.

Agentlarning o'z kalitlari bor

Windows agent Sozlamalardagi API kalitdan foydalanmaydi. U enrollment token bilan ro’yxatdan o’tganda o’z kalitini oladi va bu kalit faqat agentning o’z endpointlarini ochadi. Windows endpointni ulash sahifasiga qarang.