Changes between Version 1 and Version 2 of NETIntel-СЦ5-EnvToken

Timestamp:

01/21/26 00:44:51 (3 weeks ago)

Author:

231118

Comment:

--

NETIntel-СЦ5-EnvToken

@@ -2 +2 @@
 
 == Опис
-Администратор генерира временски валиден token за избран environment. Клиентот го користи token-от во X-Env-Token.
+Најавен администратор (tenant admin) генерира временски валиден token за избран environment во рамки на својот tenant.
+Клиентските агенти го користат token-от во HTTP header `X-Env-Token` при испраќање податоци кон серверот.
 
 == Актери
-* Администратор
+* Администратор (корисник најавен преку Google OAuth)
 
 == Предуслови
-* Валиден admin session.
-* Постојно environment.
+* Валидна корисничка сесија (JWT `session` cookie добиен преку Google OAuth).
+* Корисникот има улога `admin` во својот tenant.
+* Постојно environment поврзано со истиот tenant.
 
 == Главен тек
-1. POST /api/admin/tokens со env.
-2. Сервер создава token и го зачувува во env_tokens со expires_at.
-3. Token се користи од клиентот за /receive.
+1. Администраторот е најавен во системот (Google OAuth).
+2. Клиентскиот интерфејс праќа барање `POST /api/admin/tokens` со параметар `env`.
+3. Серверот го чита `tenant_id` од корисничката сесија (JWT).
+4. Серверот проверува дали environment постои и припаѓа на истиот tenant.
+5. Серверот генерира временски валиден token.
+6. Token-от се зачувува во табелата `env_tokens` заедно со `env_name`, `tenant_id` и `expires_at`.
+7. Генерираниот token се враќа како одговор.
+8. Клиентските агенти го користат token-от во header `X-Env-Token` при повик кон `/receive`.
 
 == Табели
-* admin_sessions
+* users
+* tenants
+* memberships
 * environments
 * env_tokens