@itphx/synth-backend 0.13.4 → 0.13.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/app/deps.d.ts +22 -1
- package/dist/app/deps.js +743 -63
- package/dist/app/listen.js +30 -35
- package/dist/app/mount-routes.js +405 -46
- package/dist/app/public-routes.d.ts +2 -0
- package/dist/app/public-routes.js +11 -0
- package/dist/app/sse-events.js +2 -0
- package/dist/app.d.ts +8 -1
- package/dist/app.js +45 -11
- package/dist/auth/api-key.d.ts +19 -0
- package/dist/auth/api-key.js +56 -0
- package/dist/auth/middleware.js +11 -15
- package/dist/auth/oidc.d.ts +46 -4
- package/dist/auth/oidc.js +55 -8
- package/dist/events/hub.d.ts +36 -2
- package/dist/events/hub.js +66 -4
- package/dist/events/visible-session-ids.d.ts +35 -0
- package/dist/events/visible-session-ids.js +29 -0
- package/dist/init.d.ts +1 -0
- package/dist/init.js +96 -0
- package/dist/lib/app-config.js +42 -1
- package/dist/lib/bind-host.d.ts +10 -0
- package/dist/lib/bind-host.js +32 -0
- package/dist/lib/i18n.js +24 -0
- package/dist/lib/principal-identity.d.ts +35 -0
- package/dist/lib/principal-identity.js +43 -0
- package/dist/lib/project-principal.d.ts +27 -0
- package/dist/lib/project-principal.js +27 -0
- package/dist/lib/recalc-can-summarize.js +8 -5
- package/dist/main.js +9 -2
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +15 -2
- package/dist/routes/agents.d.ts +3 -3
- package/dist/routes/agents.js +6 -2
- package/dist/routes/auth.js +38 -20
- package/dist/routes/llm.js +65 -7
- package/dist/routes/mcp-remote.d.ts +23 -0
- package/dist/routes/mcp-remote.js +152 -0
- package/dist/routes/mcp.d.ts +11 -6
- package/dist/routes/mcp.js +35 -6
- package/dist/routes/project-access.d.ts +61 -0
- package/dist/routes/project-access.js +62 -0
- package/dist/routes/projects.d.ts +42 -5
- package/dist/routes/projects.js +128 -17
- package/dist/routes/providers.d.ts +4 -1
- package/dist/routes/providers.js +19 -99
- package/dist/routes/queue.d.ts +7 -1
- package/dist/routes/queue.js +7 -1
- package/dist/routes/schedules.d.ts +46 -0
- package/dist/routes/schedules.js +10 -0
- package/dist/routes/sessions.d.ts +67 -6
- package/dist/routes/sessions.js +348 -208
- package/dist/routes/users.d.ts +14 -1
- package/dist/routes/users.js +91 -1
- package/package.json +5 -5
- package/dist/routes/audit.d.ts +0 -17
- package/dist/routes/audit.js +0 -64
- package/dist/routes/context.d.ts +0 -4
- package/dist/routes/context.js +0 -93
- package/dist/routes/debug.d.ts +0 -3
- package/dist/routes/debug.js +0 -30
- package/dist/routes/gateway-patterns.d.ts +0 -9
- package/dist/routes/gateway-patterns.js +0 -57
- package/dist/routes/logs.d.ts +0 -24
- package/dist/routes/logs.js +0 -100
- package/dist/routes/mcp-registry.d.ts +0 -28
- package/dist/routes/mcp-registry.js +0 -483
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
// F6 (аудит §6.1): allowlist публичных эндпоинтов `/api/v2/*`.
|
|
2
|
+
//
|
|
3
|
+
// Реализация перенесена в core (`packages/core/src/server/app/public-routes.ts`):
|
|
4
|
+
// общая логика HTTP живёт в core (ADR-017/ADR-018), а allowlist должен быть
|
|
5
|
+
// **один** для обеих сборок (standalone и managed) — иначе публичность
|
|
6
|
+
// `/api/v2/meta`/`/api/v2/health` разъехалась бы между ними.
|
|
7
|
+
//
|
|
8
|
+
// Здесь оставлен тонкий реэкспорт, чтобы существующие импорты
|
|
9
|
+
// (`./app/public-routes.js` в `src/app.ts` и `src/app/route-access-census.test.ts`)
|
|
10
|
+
// не менялись. См. `@itphx/synth-core`.
|
|
11
|
+
export { PUBLIC_API_V2_PATHS, isPublicApiV2Path } from '@itphx/synth-core';
|
package/dist/app/sse-events.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { getServiceCredential } from '@itphx/synth-core';
|
|
2
2
|
import { MESSAGE_MODEL_QUERY_PARAM, MESSAGE_MODEL_UNSUPPORTED_REASON, isSupportedMessageModelParam, parseSinceParam, } from '@itphx/synth-core';
|
|
3
|
+
import { groupsOf } from '../lib/project-principal.js';
|
|
3
4
|
/**
|
|
4
5
|
* Зарегистрировать SSE-хаб (`GET /api/v2/events`): подписка на события сессий
|
|
5
6
|
* пользователя (watch-all — для service-key и ADMIN/LEAD, ADR-052 этап IV).
|
|
@@ -62,6 +63,7 @@ export function registerEventsSse(app, deps) {
|
|
|
62
63
|
userId: user.id,
|
|
63
64
|
username: user.username,
|
|
64
65
|
allSessions,
|
|
66
|
+
...(groupsOf(user) ? { groups: groupsOf(user) } : {}),
|
|
65
67
|
send(event) {
|
|
66
68
|
if (replaying) {
|
|
67
69
|
pending.push(event);
|
package/dist/app.d.ts
CHANGED
|
@@ -13,7 +13,7 @@ export interface CreateBackendAppOptions {
|
|
|
13
13
|
dataDir?: string;
|
|
14
14
|
/** Debug auth: переопределяет SYNTH_AUTH_DEBUG (тестовые ключи admin-key-123 и т.п.). */
|
|
15
15
|
authDebug?: boolean;
|
|
16
|
-
/** Единый API-ключ (
|
|
16
|
+
/** Единый API-ключ (роли из `auth.apiKeyRoles`, дефолт USER): переопределяет SYNTH_API_KEY. */
|
|
17
17
|
apiKey?: string;
|
|
18
18
|
/** Порт: переопределяет SYNTH_PORT. 0 — эфемерный (для тестов). */
|
|
19
19
|
port?: number;
|
|
@@ -57,6 +57,11 @@ export interface BackendAppHandle {
|
|
|
57
57
|
scheduler: SchedulerService;
|
|
58
58
|
/** ADR-051 (срез): остановка планировщика (на graceful shutdown). */
|
|
59
59
|
stopScheduler: () => void;
|
|
60
|
+
/**
|
|
61
|
+
* PROP-141 (Часть B): остановка движка таймеров/будильников (на graceful
|
|
62
|
+
* shutdown — рядом с `stopScheduler`).
|
|
63
|
+
*/
|
|
64
|
+
stopTimerService: () => void;
|
|
60
65
|
/** ADR-089: остановка sweeper'а авто-архивации ephemeral-сессий. */
|
|
61
66
|
stopEphemeralSweeper: () => void;
|
|
62
67
|
/** ADR-089: остановка периодической retention-очистки журнала событий. */
|
|
@@ -81,6 +86,8 @@ export interface BackendAppHandle {
|
|
|
81
86
|
stopAttachmentPruner: () => void;
|
|
82
87
|
/** ADR-115 × ADR-077: остановка уборки временных каталогов медиа-раннера. */
|
|
83
88
|
stopMediaTempPruner: () => void;
|
|
89
|
+
/** PROP-132 (Ф3в): остановка сервиса терминалов (закрытие живых PTY). */
|
|
90
|
+
stopTerminalService: () => void;
|
|
84
91
|
/** ADR-052 (этап II): реестр подписок webhooks (для тестов/диагностики). */
|
|
85
92
|
webhookStore: WebhookRepository;
|
|
86
93
|
/** ADR-052 (этап II): движок исходящих webhooks. */
|
package/dist/app.js
CHANGED
|
@@ -17,8 +17,7 @@ import { Hono } from 'hono';
|
|
|
17
17
|
import { cors } from 'hono/cors';
|
|
18
18
|
import { logger } from 'hono/logger';
|
|
19
19
|
import { createMiddleware } from 'hono/factory';
|
|
20
|
-
import { applyBootstrapServiceKeys,
|
|
21
|
-
import { resolveExecutionConfig } from '@itphx/synth-shared';
|
|
20
|
+
import { applyBootstrapServiceKeys, createHealthRoutes, createHttpMetricsMiddleware, createMetricsRoutes, KeyRateLimiter, getServiceCredential, MetricsRegistry, registerProcessMetrics, resolveMetricsEnabled, resolveMetricsToken, resolvePluginServerPolicy, setSynthReady, } from '@itphx/synth-core';
|
|
22
21
|
import { createStorageDegradedGuard, createStorageStatusRoutes } from '@itphx/synth-core/server/storage-degraded.js';
|
|
23
22
|
import { loadBackendConfig } from './lib/app-config.js';
|
|
24
23
|
import { resolveCorsOrigin } from './lib/cors.js';
|
|
@@ -28,6 +27,7 @@ import { createAuthRoutes } from './routes/auth.js';
|
|
|
28
27
|
import { t } from './lib/i18n.js';
|
|
29
28
|
import { createBackendDeps, createBackendStorage } from './app/deps.js';
|
|
30
29
|
import { mountBackendRoutes } from './app/mount-routes.js';
|
|
30
|
+
import { isPublicApiV2Path } from './app/public-routes.js';
|
|
31
31
|
import { createBackendListen } from './app/listen.js';
|
|
32
32
|
/**
|
|
33
33
|
* Backend-приложение Synth (managed): `createBackendApp` без прослушивания порта.
|
|
@@ -56,14 +56,14 @@ export async function createBackendApp(opts = {}) {
|
|
|
56
56
|
try {
|
|
57
57
|
// Конфигурация
|
|
58
58
|
const backendConfig = await loadBackendConfig({ configPath: opts.configPath });
|
|
59
|
-
// ADR-077: топология исполнения — параметр запуска (инвариант 24).
|
|
60
|
-
//
|
|
61
|
-
//
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
59
|
+
// ADR-077/ADR-135: топология исполнения — параметр запуска (инвариант 24).
|
|
60
|
+
// Разрешение секции `execution` и fail-closed проверка режима — **в одном
|
|
61
|
+
// месте** (`app/deps.ts`: `resolveExecutionConfig` + runtime-каталог
|
|
62
|
+
// профилей + `checkExecutionMode`). Здесь только конфиг: дублирующего
|
|
63
|
+
// разрешения не остаётся, а ошибка режима по-прежнему прерывает старт
|
|
64
|
+
// (fail-closed: неверный `mode`/`failMode` — ошибка; `remote` без
|
|
65
|
+
// адресов/пакета исполнителя/читаемого токена — старт прерывается, а не
|
|
66
|
+
// «молча уходит в inline»).
|
|
67
67
|
const app = new Hono();
|
|
68
68
|
app.use(logger());
|
|
69
69
|
// ADR-096 (W2.4): единый контекст хранения — собирается до `auth`, реестр
|
|
@@ -94,12 +94,17 @@ export async function createBackendApp(opts = {}) {
|
|
|
94
94
|
// ADR-094: `/ready` — readiness (200 и при деградации, 503 — только не готов).
|
|
95
95
|
const degradedInfo = storage.degraded ?? null;
|
|
96
96
|
let initialized = false;
|
|
97
|
+
// F4 (аудит S1): эффективное состояние LLM-шлюза (`deps.gatewayConfig.enabled`,
|
|
98
|
+
// с учётом runtime-тумблера из UI) — для предупреждения в `/health`/`/ready`.
|
|
99
|
+
// deps создаются ниже: геттер ленивый (до сборки — поля нет).
|
|
100
|
+
let depsRef = null;
|
|
97
101
|
app.route('/', createHealthRoutes({
|
|
98
102
|
getStorageDegraded: () => degradedInfo ?? null,
|
|
99
103
|
getReadiness: () => ({
|
|
100
104
|
ready: initialized,
|
|
101
105
|
storage: degradedInfo ? 'degraded' : 'ok',
|
|
102
106
|
}),
|
|
107
|
+
getLlmGatewayState: () => depsRef ? (depsRef.gatewayConfig?.enabled ? 'enabled' : 'disabled') : null,
|
|
103
108
|
}));
|
|
104
109
|
// ADR-094: `/metrics` — до auth (скрейп по сети pod'а, опциональный bearer).
|
|
105
110
|
// Токен читается на каждый запрос — правка из UI применяется без рестарта.
|
|
@@ -172,7 +177,10 @@ export async function createBackendApp(opts = {}) {
|
|
|
172
177
|
// Зависимости (stores/managers/оркестратор/событийное ядро/шедулер/webhooks).
|
|
173
178
|
// Тот же контекст хранения, что собран до `auth`. ADR-094: реестр передаётся
|
|
174
179
|
// только при `metrics.enabled` — иначе доменные коллекторы не подключаются.
|
|
175
|
-
const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined
|
|
180
|
+
const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined);
|
|
181
|
+
// F4 (аудит S1): health-геттер состояния LLM-шлюза читает эффективный конфиг
|
|
182
|
+
// (`deps.gatewayConfig` — config + runtime-тумблер), который готов только здесь.
|
|
183
|
+
depsRef = deps;
|
|
176
184
|
// Auth routes (после profilesStore)
|
|
177
185
|
app.route('/auth', createAuthRoutes(auth, backendConfig.auth, deps.profilesStore, deps.dataDir, deps.defaultsStore,
|
|
178
186
|
// ADR-090 Ф7: сигнал о серверной политике плагинов для публичного
|
|
@@ -182,6 +190,28 @@ export async function createBackendApp(opts = {}) {
|
|
|
182
190
|
enabled: deps.pluginRuntime.config.enabled,
|
|
183
191
|
mode: deps.pluginRuntime.config.hybrid.mode,
|
|
184
192
|
}));
|
|
193
|
+
// F6 (аудит §6.1) — единый fail-closed гейт на границе `/api/v2/*`.
|
|
194
|
+
//
|
|
195
|
+
// Роутеры создаются фабриками с `{ requireAuth }`, но сама граница
|
|
196
|
+
// приложения проверку не гарантировала: новый роутер, смонтированный без
|
|
197
|
+
// guard'а, становился анонимным (перепись маршрутов покрывала 3 роутера
|
|
198
|
+
// из 59). Здесь — последняя проверка для всего дерева API, кроме
|
|
199
|
+
// allowlist публичных путей (`app/public-routes.ts`; строго метод+путь,
|
|
200
|
+
// без wildcard по префиксу).
|
|
201
|
+
//
|
|
202
|
+
// Порядок важен: после `attachUser` (service-key и cookie-пользователь уже
|
|
203
|
+
// в контексте — `requireAuth` берёт его оттуда без повторной проверки) и
|
|
204
|
+
// `/auth`-роутов, до plugin-bound guard'а (он различает только
|
|
205
|
+
// service-key, аноним до него не доходит), guard'а деградации и
|
|
206
|
+
// монтирования роутов. Проверок внутри обработчиков не добавляем —
|
|
207
|
+
// там остаются только RBAC/область доступа (инвариант 16).
|
|
208
|
+
app.use('/api/v2/*', createMiddleware(async (c, next) => {
|
|
209
|
+
if (isPublicApiV2Path(c.req.method, c.req.path)) {
|
|
210
|
+
await next();
|
|
211
|
+
return;
|
|
212
|
+
}
|
|
213
|
+
return auth.requireAuth(c, next);
|
|
214
|
+
}));
|
|
185
215
|
// ADR-090 Ф7 (Уровень 2): plugin-bound service-key (`plugin_id`)
|
|
186
216
|
// принимается только с заголовком `X-Synth-Plugin-Id` и тем же
|
|
187
217
|
// значением, со scope `plugins:invoke` и — при
|
|
@@ -294,6 +324,8 @@ export async function createBackendApp(opts = {}) {
|
|
|
294
324
|
scheduleStore: deps.scheduleStore,
|
|
295
325
|
scheduler: deps.schedulerService,
|
|
296
326
|
stopScheduler: () => deps.schedulerService.stop(),
|
|
327
|
+
// PROP-141 (Часть B): остановка движка таймеров/будильников.
|
|
328
|
+
stopTimerService: () => deps.stopTimerService(),
|
|
297
329
|
stopEphemeralSweeper: deps.stopEphemeralSweeper,
|
|
298
330
|
stopEventJournalPruner: deps.stopEventJournalPruner,
|
|
299
331
|
stopAnalyticsRollupPruner: deps.stopAnalyticsRollupPruner,
|
|
@@ -310,6 +342,8 @@ export async function createBackendApp(opts = {}) {
|
|
|
310
342
|
stopAttachmentPruner: () => deps.stopAttachmentPruner(),
|
|
311
343
|
// ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
|
|
312
344
|
stopMediaTempPruner: () => deps.stopMediaTempPruner(),
|
|
345
|
+
// PROP-132 (Ф3в): остановка сервиса терминалов (закрытие живых PTY).
|
|
346
|
+
stopTerminalService: () => deps.stopTerminalService(),
|
|
313
347
|
// ADR-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
|
|
314
348
|
webhookStore: deps.webhookStore,
|
|
315
349
|
webhookService: deps.webhookService,
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { GlobalRole } from '@itphx/synth-shared';
|
|
2
|
+
/** Допустимые роли для `auth.apiKeyRoles` (порядок — для текста ошибки). */
|
|
3
|
+
export declare const ALLOWED_API_KEY_ROLES: readonly GlobalRole[];
|
|
4
|
+
/** Роль по умолчанию для API-ключа: базовый пользователь, не ADMIN. */
|
|
5
|
+
export declare const DEFAULT_API_KEY_ROLE: GlobalRole;
|
|
6
|
+
/**
|
|
7
|
+
* Сравнить представленный ключ с ожидаемым за постоянное время.
|
|
8
|
+
*
|
|
9
|
+
* Дайджесты sha256 всегда одной длины (32 байта), поэтому `timingSafeEqual`
|
|
10
|
+
* не бросает на разной длине входных строк и не раскрывает её. Пустая строка
|
|
11
|
+
* с любой стороны → `false` (незаданный ключ не аутентифицирует никого).
|
|
12
|
+
*/
|
|
13
|
+
export declare function apiKeyEquals(presented: string | null | undefined, expected: string | null | undefined): boolean;
|
|
14
|
+
/**
|
|
15
|
+
* Роли пользователя API-ключа из конфигурации: явный список либо `['USER']`.
|
|
16
|
+
* Неизвестная роль — ошибка конфигурации (fail-closed): молча выдать меньше
|
|
17
|
+
* прав нельзя (это скрытая поломка доступа), выдать больше — тем более.
|
|
18
|
+
*/
|
|
19
|
+
export declare function resolveApiKeyRoles(configured: readonly string[] | undefined): GlobalRole[];
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Единый API-ключ backend (`auth.apiKey` / `SYNTH_API_KEY`).
|
|
3
|
+
*
|
|
4
|
+
* Два независимых правила (аудит F5):
|
|
5
|
+
* 1. Сравнение ключа — **постоянное по времени**: равные по длине sha256-дайджесты
|
|
6
|
+
* (`timingSafeEqual`), поэтому ни содержимое, ни длина представленного ключа
|
|
7
|
+
* не утекают через тайминг. Пустой конфиг/пустой заголовок → не совпадает.
|
|
8
|
+
* 2. Роли пользователя ключа — **только явная настройка** (`auth.apiKeyRoles`):
|
|
9
|
+
* дефолт `USER`; права ADMIN не выдаются по факту наличия ключа.
|
|
10
|
+
*/
|
|
11
|
+
import { createHash, timingSafeEqual } from 'node:crypto';
|
|
12
|
+
import { GlobalRole } from '@itphx/synth-shared';
|
|
13
|
+
/** Допустимые роли для `auth.apiKeyRoles` (порядок — для текста ошибки). */
|
|
14
|
+
export const ALLOWED_API_KEY_ROLES = [
|
|
15
|
+
GlobalRole.ADMIN,
|
|
16
|
+
GlobalRole.USER,
|
|
17
|
+
GlobalRole.LEAD,
|
|
18
|
+
GlobalRole.AUDITOR,
|
|
19
|
+
];
|
|
20
|
+
/** Роль по умолчанию для API-ключа: базовый пользователь, не ADMIN. */
|
|
21
|
+
export const DEFAULT_API_KEY_ROLE = GlobalRole.USER;
|
|
22
|
+
function digest(value) {
|
|
23
|
+
return createHash('sha256').update(value, 'utf8').digest();
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Сравнить представленный ключ с ожидаемым за постоянное время.
|
|
27
|
+
*
|
|
28
|
+
* Дайджесты sha256 всегда одной длины (32 байта), поэтому `timingSafeEqual`
|
|
29
|
+
* не бросает на разной длине входных строк и не раскрывает её. Пустая строка
|
|
30
|
+
* с любой стороны → `false` (незаданный ключ не аутентифицирует никого).
|
|
31
|
+
*/
|
|
32
|
+
export function apiKeyEquals(presented, expected) {
|
|
33
|
+
if (!presented || !expected)
|
|
34
|
+
return false;
|
|
35
|
+
return timingSafeEqual(digest(presented), digest(expected));
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Роли пользователя API-ключа из конфигурации: явный список либо `['USER']`.
|
|
39
|
+
* Неизвестная роль — ошибка конфигурации (fail-closed): молча выдать меньше
|
|
40
|
+
* прав нельзя (это скрытая поломка доступа), выдать больше — тем более.
|
|
41
|
+
*/
|
|
42
|
+
export function resolveApiKeyRoles(configured) {
|
|
43
|
+
if (!configured || configured.length === 0)
|
|
44
|
+
return [DEFAULT_API_KEY_ROLE];
|
|
45
|
+
const roles = [];
|
|
46
|
+
for (const value of configured) {
|
|
47
|
+
if (!ALLOWED_API_KEY_ROLES.includes(value)) {
|
|
48
|
+
throw new Error(`[config] auth.apiKeyRoles: неизвестная роль "${value}"; ` +
|
|
49
|
+
`допустимо: ${ALLOWED_API_KEY_ROLES.join(', ')}`);
|
|
50
|
+
}
|
|
51
|
+
const role = value;
|
|
52
|
+
if (!roles.includes(role))
|
|
53
|
+
roles.push(role);
|
|
54
|
+
}
|
|
55
|
+
return roles.length > 0 ? roles : [DEFAULT_API_KEY_ROLE];
|
|
56
|
+
}
|
package/dist/auth/middleware.js
CHANGED
|
@@ -2,7 +2,8 @@ import { isServiceKeySecret } from '@itphx/synth-core';
|
|
|
2
2
|
import { createMiddleware } from 'hono/factory';
|
|
3
3
|
import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
|
|
4
4
|
import { t } from '../lib/i18n.js';
|
|
5
|
-
import { createLazyOidcClient } from './oidc.js';
|
|
5
|
+
import { createLazyOidcClient, oidcUserToUser } from './oidc.js';
|
|
6
|
+
import { apiKeyEquals, resolveApiKeyRoles } from './api-key.js';
|
|
6
7
|
const SESSION_COOKIE = 'user_session';
|
|
7
8
|
/**
|
|
8
9
|
* Флаг `Secure` cookie сессии: по умолчанию `true`; локальная http-разработка
|
|
@@ -95,17 +96,9 @@ export function createAuthMiddleware(config) {
|
|
|
95
96
|
if (client) {
|
|
96
97
|
try {
|
|
97
98
|
const oidcUser = await client.verifyToken(token);
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
email: oidcUser.email,
|
|
102
|
-
roles: oidcUser.roles,
|
|
103
|
-
preferredLanguage: 'ru',
|
|
104
|
-
createdAt: new Date().toISOString(),
|
|
105
|
-
teamRole: oidcUser.roles[0] || 'USER',
|
|
106
|
-
notes: '',
|
|
107
|
-
interviewCompleted: false,
|
|
108
|
-
};
|
|
99
|
+
// ADR-140: группы пользователя — снимок claim'а IdP (allowlist);
|
|
100
|
+
// `oidcUserToUser` переносит их в `User` только при непустом списке.
|
|
101
|
+
return oidcUserToUser(oidcUser);
|
|
109
102
|
}
|
|
110
103
|
catch {
|
|
111
104
|
// Некорректный/истёкший JWT — пользователь не аутентифицирован
|
|
@@ -117,14 +110,17 @@ export function createAuthMiddleware(config) {
|
|
|
117
110
|
// 4. API Key mode (продакшен без OIDC)
|
|
118
111
|
if (!config.debugMode && !config.oidc?.enabled && config.apiKey) {
|
|
119
112
|
const apiKey = extractBearerToken(c.req.header('Authorization'));
|
|
120
|
-
|
|
113
|
+
// Постоянное по времени сравнение (аудит F5): неверный/пустой ключ → не
|
|
114
|
+
// аутентифицирован; роли — из явной настройки, по умолчанию USER.
|
|
115
|
+
if (apiKeyEquals(apiKey, config.apiKey)) {
|
|
116
|
+
const roles = resolveApiKeyRoles(config.apiKeyRoles);
|
|
121
117
|
return {
|
|
122
118
|
id: 'api',
|
|
123
119
|
username: 'api',
|
|
124
|
-
roles
|
|
120
|
+
roles,
|
|
125
121
|
preferredLanguage: 'ru',
|
|
126
122
|
createdAt: '',
|
|
127
|
-
teamRole: '
|
|
123
|
+
teamRole: roles[0] ?? 'USER',
|
|
128
124
|
notes: '',
|
|
129
125
|
interviewCompleted: false,
|
|
130
126
|
};
|
package/dist/auth/oidc.d.ts
CHANGED
|
@@ -16,6 +16,16 @@ export interface OidcConfig {
|
|
|
16
16
|
* Issuer проверяется всегда.
|
|
17
17
|
*/
|
|
18
18
|
audience?: string[];
|
|
19
|
+
/**
|
|
20
|
+
* ADR-140: источник групп пользователя — claim IdP и allowlist имён.
|
|
21
|
+
* Пустой allowlist — групп нет (fail-closed): «принять все» невозможно.
|
|
22
|
+
*/
|
|
23
|
+
groups?: {
|
|
24
|
+
/** Имя claim'а с группами (Keycloak — `groups`). */
|
|
25
|
+
claim?: string;
|
|
26
|
+
/** Allowlist имён групп; пусто — ни одна группа не принимается. */
|
|
27
|
+
allow?: string[];
|
|
28
|
+
};
|
|
19
29
|
}
|
|
20
30
|
/** Подмножество документа discovery OpenID Connect. */
|
|
21
31
|
export interface OidcDiscovery {
|
|
@@ -62,6 +72,7 @@ export declare class OidcClient {
|
|
|
62
72
|
/**
|
|
63
73
|
* Проверка пары id_token + access_token через JWKS провайдера.
|
|
64
74
|
* Роли: из id_token, если пусто — из access_token (client roles учитываются).
|
|
75
|
+
* Группы: тот же fallback (id_token → access_token).
|
|
65
76
|
*/
|
|
66
77
|
verifyTokens(idToken: string, accessToken: string): Promise<OidcUser>;
|
|
67
78
|
/**
|
|
@@ -84,21 +95,52 @@ export interface OidcUser {
|
|
|
84
95
|
username: string;
|
|
85
96
|
email?: string;
|
|
86
97
|
roles: string[];
|
|
98
|
+
/**
|
|
99
|
+
* ADR-140: группы пользователя — снимок claim'а IdP на момент логина,
|
|
100
|
+
* отфильтрованный allowlist'ом. Пусто/нет — групп нет (fail-closed).
|
|
101
|
+
*/
|
|
102
|
+
groups?: string[];
|
|
87
103
|
}
|
|
104
|
+
/**
|
|
105
|
+
* ADR-140: извлечь группы пользователя из payload токена.
|
|
106
|
+
*
|
|
107
|
+
* Claim — **верхнего уровня** (Keycloak кладёт плоский массив `groups`);
|
|
108
|
+
* вложенные пути не разбираются. Нормализация: trim, только `string`-элементы,
|
|
109
|
+
* дедуп, порядок claim'а сохраняется.
|
|
110
|
+
*
|
|
111
|
+
* Фильтр — по `allow` (allowlist) **точным** совпадением: имена групп Keycloak
|
|
112
|
+
* регистрозависимы, в верхний регистр не приводим. Пустой allowlist → `[]`
|
|
113
|
+
* (fail-closed: «принять все» невозможно). Claim отсутствует или это не
|
|
114
|
+
* массив → `[]` (без throw — кривой токен не ломает аутентификацию).
|
|
115
|
+
*/
|
|
116
|
+
export declare function extractGroups(payload: Record<string, unknown>, cfg?: {
|
|
117
|
+
claim?: string;
|
|
118
|
+
allow?: string[];
|
|
119
|
+
} | null): string[];
|
|
88
120
|
/**
|
|
89
121
|
* Извлечь пользователя из payload id_token Keycloak:
|
|
90
122
|
* - username = preferred_username (fallback email, sub)
|
|
91
123
|
* - roles = realm_access.roles + resource_access.<clientId>.roles → ВЕРХНИЙ РЕГИСТР + фильтр известных (ADMIN/USER/LEAD/AUDITOR)
|
|
124
|
+
* - groups = claim'а групп (ADR-140) — по allowlist'у; пусто → `[]`
|
|
92
125
|
* - если ролей нет — дефолт ['USER']
|
|
93
126
|
*/
|
|
94
|
-
export declare function extractUser(payload: Record<string, unknown>, clientId?: string
|
|
127
|
+
export declare function extractUser(payload: Record<string, unknown>, clientId?: string, groups?: {
|
|
128
|
+
claim?: string;
|
|
129
|
+
allow?: string[];
|
|
130
|
+
} | null): OidcUser;
|
|
95
131
|
/**
|
|
96
|
-
* Объединить роли из id_token и access_token:
|
|
97
|
-
* Поля id/username/email берутся из id_token.
|
|
132
|
+
* Объединить роли и группы из id_token и access_token: из id_token, если пусто —
|
|
133
|
+
* из access_token. Поля id/username/email берутся из id_token.
|
|
98
134
|
*/
|
|
99
|
-
export declare function extractUserFromTokens(idPayload: Record<string, unknown>, accessPayload: Record<string, unknown>, clientId?: string
|
|
135
|
+
export declare function extractUserFromTokens(idPayload: Record<string, unknown>, accessPayload: Record<string, unknown>, clientId?: string, groups?: {
|
|
136
|
+
claim?: string;
|
|
137
|
+
allow?: string[];
|
|
138
|
+
} | null): OidcUser;
|
|
100
139
|
/**
|
|
101
140
|
* Собрать полноценный User из OIDC-пользователя (объект User требует служебные поля).
|
|
141
|
+
*
|
|
142
|
+
* ADR-140: группы переносятся **только если список непуст** — иначе поле не
|
|
143
|
+
* добавляется вовсе (у пользователя без групп `groups` отсутствует).
|
|
102
144
|
*/
|
|
103
145
|
export declare function oidcUserToUser(o: OidcUser): User;
|
|
104
146
|
/**
|
package/dist/auth/oidc.js
CHANGED
|
@@ -3,6 +3,8 @@ import { jwtVerify, createRemoteJWKSet, customFetch } from 'jose';
|
|
|
3
3
|
import { egressFetch } from '@itphx/synth-core';
|
|
4
4
|
/** Audience access_token по умолчанию (Keycloak): клиент либо `account`. */
|
|
5
5
|
const DEFAULT_ACCESS_TOKEN_AUDIENCE = 'account';
|
|
6
|
+
/** Имя claim'а с группами по умолчанию (Keycloak кладёт плоский массив `groups`). */
|
|
7
|
+
const DEFAULT_GROUPS_CLAIM = 'groups';
|
|
6
8
|
/** Известные роли Synth (в realm роли записаны в нижнем регистре). */
|
|
7
9
|
const KNOWN_ROLES = ['ADMIN', 'USER', 'LEAD', 'AUDITOR'];
|
|
8
10
|
/**
|
|
@@ -120,11 +122,12 @@ export class OidcClient {
|
|
|
120
122
|
issuer: this.config.issuer,
|
|
121
123
|
audience: this._anyTokenAudience(),
|
|
122
124
|
});
|
|
123
|
-
return extractUser(payload, this.config.clientId);
|
|
125
|
+
return extractUser(payload, this.config.clientId, this.config.groups);
|
|
124
126
|
}
|
|
125
127
|
/**
|
|
126
128
|
* Проверка пары id_token + access_token через JWKS провайдера.
|
|
127
129
|
* Роли: из id_token, если пусто — из access_token (client roles учитываются).
|
|
130
|
+
* Группы: тот же fallback (id_token → access_token).
|
|
128
131
|
*/
|
|
129
132
|
async verifyTokens(idToken, accessToken) {
|
|
130
133
|
const discovery = await this.getDiscovery();
|
|
@@ -142,7 +145,7 @@ export class OidcClient {
|
|
|
142
145
|
// напр. `synth-cli`, отвергались бы) — issuer и подпись проверяются всегда.
|
|
143
146
|
audience: this._accessTokenAudience(),
|
|
144
147
|
});
|
|
145
|
-
return extractUserFromTokens(idPayload, accessPayload, this.config.clientId);
|
|
148
|
+
return extractUserFromTokens(idPayload, accessPayload, this.config.clientId, this.config.groups);
|
|
146
149
|
}
|
|
147
150
|
/**
|
|
148
151
|
* ADR-099: JWKS-набор с **явным** транспортом доверия TLS/CA (`egressFetch`),
|
|
@@ -201,13 +204,49 @@ function extractKnownRoles(payload, clientId) {
|
|
|
201
204
|
.filter((r) => KNOWN_ROLES.includes(r));
|
|
202
205
|
return [...new Set(roles)];
|
|
203
206
|
}
|
|
207
|
+
/**
|
|
208
|
+
* ADR-140: извлечь группы пользователя из payload токена.
|
|
209
|
+
*
|
|
210
|
+
* Claim — **верхнего уровня** (Keycloak кладёт плоский массив `groups`);
|
|
211
|
+
* вложенные пути не разбираются. Нормализация: trim, только `string`-элементы,
|
|
212
|
+
* дедуп, порядок claim'а сохраняется.
|
|
213
|
+
*
|
|
214
|
+
* Фильтр — по `allow` (allowlist) **точным** совпадением: имена групп Keycloak
|
|
215
|
+
* регистрозависимы, в верхний регистр не приводим. Пустой allowlist → `[]`
|
|
216
|
+
* (fail-closed: «принять все» невозможно). Claim отсутствует или это не
|
|
217
|
+
* массив → `[]` (без throw — кривой токен не ломает аутентификацию).
|
|
218
|
+
*/
|
|
219
|
+
export function extractGroups(payload, cfg) {
|
|
220
|
+
const allow = (cfg?.allow ?? [])
|
|
221
|
+
.map((name) => name.trim())
|
|
222
|
+
.filter((name) => name.length > 0);
|
|
223
|
+
if (allow.length === 0)
|
|
224
|
+
return [];
|
|
225
|
+
const allowSet = new Set(allow);
|
|
226
|
+
const claim = cfg?.claim?.trim() || DEFAULT_GROUPS_CLAIM;
|
|
227
|
+
const raw = payload[claim];
|
|
228
|
+
if (!Array.isArray(raw))
|
|
229
|
+
return [];
|
|
230
|
+
const groups = [];
|
|
231
|
+
for (const item of raw) {
|
|
232
|
+
if (typeof item !== 'string')
|
|
233
|
+
continue;
|
|
234
|
+
const name = item.trim();
|
|
235
|
+
if (!name || !allowSet.has(name))
|
|
236
|
+
continue;
|
|
237
|
+
if (!groups.includes(name))
|
|
238
|
+
groups.push(name);
|
|
239
|
+
}
|
|
240
|
+
return groups;
|
|
241
|
+
}
|
|
204
242
|
/**
|
|
205
243
|
* Извлечь пользователя из payload id_token Keycloak:
|
|
206
244
|
* - username = preferred_username (fallback email, sub)
|
|
207
245
|
* - roles = realm_access.roles + resource_access.<clientId>.roles → ВЕРХНИЙ РЕГИСТР + фильтр известных (ADMIN/USER/LEAD/AUDITOR)
|
|
246
|
+
* - groups = claim'а групп (ADR-140) — по allowlist'у; пусто → `[]`
|
|
208
247
|
* - если ролей нет — дефолт ['USER']
|
|
209
248
|
*/
|
|
210
|
-
export function extractUser(payload, clientId) {
|
|
249
|
+
export function extractUser(payload, clientId, groups) {
|
|
211
250
|
const sub = typeof payload.sub === 'string' ? payload.sub : '';
|
|
212
251
|
const email = typeof payload.email === 'string' ? payload.email : undefined;
|
|
213
252
|
const preferredUsername = typeof payload.preferred_username === 'string'
|
|
@@ -220,21 +259,28 @@ export function extractUser(payload, clientId) {
|
|
|
220
259
|
username: username || 'oidc-user',
|
|
221
260
|
email,
|
|
222
261
|
roles: roles.length > 0 ? roles : ['USER'],
|
|
262
|
+
groups: extractGroups(payload, groups),
|
|
223
263
|
};
|
|
224
264
|
}
|
|
225
265
|
/**
|
|
226
|
-
* Объединить роли из id_token и access_token:
|
|
227
|
-
* Поля id/username/email берутся из id_token.
|
|
266
|
+
* Объединить роли и группы из id_token и access_token: из id_token, если пусто —
|
|
267
|
+
* из access_token. Поля id/username/email берутся из id_token.
|
|
228
268
|
*/
|
|
229
|
-
export function extractUserFromTokens(idPayload, accessPayload, clientId) {
|
|
269
|
+
export function extractUserFromTokens(idPayload, accessPayload, clientId, groups) {
|
|
230
270
|
const idRoles = extractKnownRoles(idPayload, clientId);
|
|
231
271
|
const accessRoles = extractKnownRoles(accessPayload, clientId);
|
|
232
272
|
const roles = idRoles.length > 0 ? idRoles : accessRoles;
|
|
233
|
-
const
|
|
234
|
-
|
|
273
|
+
const idGroups = extractGroups(idPayload, groups);
|
|
274
|
+
const accessGroups = extractGroups(accessPayload, groups);
|
|
275
|
+
const resolvedGroups = idGroups.length > 0 ? idGroups : accessGroups;
|
|
276
|
+
const user = extractUser(idPayload, clientId, groups);
|
|
277
|
+
return { ...user, roles: roles.length > 0 ? roles : ['USER'], groups: resolvedGroups };
|
|
235
278
|
}
|
|
236
279
|
/**
|
|
237
280
|
* Собрать полноценный User из OIDC-пользователя (объект User требует служебные поля).
|
|
281
|
+
*
|
|
282
|
+
* ADR-140: группы переносятся **только если список непуст** — иначе поле не
|
|
283
|
+
* добавляется вовсе (у пользователя без групп `groups` отсутствует).
|
|
238
284
|
*/
|
|
239
285
|
export function oidcUserToUser(o) {
|
|
240
286
|
return {
|
|
@@ -242,6 +288,7 @@ export function oidcUserToUser(o) {
|
|
|
242
288
|
username: o.username,
|
|
243
289
|
email: o.email,
|
|
244
290
|
roles: o.roles,
|
|
291
|
+
...(o.groups && o.groups.length > 0 ? { groups: [...o.groups] } : {}),
|
|
245
292
|
preferredLanguage: 'ru',
|
|
246
293
|
createdAt: new Date().toISOString(),
|
|
247
294
|
teamRole: o.roles[0] || 'USER',
|
package/dist/events/hub.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { EventBus } from '@itphx/synth-core';
|
|
1
|
+
import type { EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
2
2
|
import type { BusEvent } from '@itphx/synth-shared';
|
|
3
3
|
import type { SessionManager } from '@itphx/synth-core';
|
|
4
4
|
export interface EventClient {
|
|
@@ -11,6 +11,10 @@ export interface EventClient {
|
|
|
11
11
|
* сквозного обзора ADMIN/LEAD (ADR-089) — паритет со standalone-core SSE.
|
|
12
12
|
*/
|
|
13
13
|
allSessions?: boolean;
|
|
14
|
+
/**
|
|
15
|
+
* PROP-133: группы пользователя (гранты по группам; Ф2). Нет — групп нет.
|
|
16
|
+
*/
|
|
17
|
+
groups?: readonly string[];
|
|
14
18
|
send(event: BusEvent): void;
|
|
15
19
|
}
|
|
16
20
|
/**
|
|
@@ -21,11 +25,41 @@ export interface EventClient {
|
|
|
21
25
|
export declare class EventHub {
|
|
22
26
|
private eventBus;
|
|
23
27
|
private sessionManager;
|
|
28
|
+
/**
|
|
29
|
+
* PROP-133 §6: проекты пользователя — чтобы подписка клиента покрывала
|
|
30
|
+
* сессии **всех видимых** проектов (не только свои). Не задан — подписка
|
|
31
|
+
* остаётся «только свои сессии» (прежнее поведение).
|
|
32
|
+
*/
|
|
33
|
+
private projectStore?;
|
|
24
34
|
private clients;
|
|
25
35
|
private clientSubs;
|
|
26
|
-
constructor(eventBus: EventBus, sessionManager: SessionManager
|
|
36
|
+
constructor(eventBus: EventBus, sessionManager: SessionManager,
|
|
37
|
+
/**
|
|
38
|
+
* PROP-133 §6: проекты пользователя — чтобы подписка клиента покрывала
|
|
39
|
+
* сессии **всех видимых** проектов (не только свои). Не задан — подписка
|
|
40
|
+
* остаётся «только свои сессии» (прежнее поведение).
|
|
41
|
+
*/
|
|
42
|
+
projectStore?: ProjectRepository | undefined);
|
|
27
43
|
registerClient(client: EventClient): Promise<void>;
|
|
28
44
|
unregisterClient(client: EventClient): void;
|
|
45
|
+
/**
|
|
46
|
+
* PROP-133 Ф2 / ADR-140 Ф2: пересчитать подписки клиента — доступ к
|
|
47
|
+
* проектам мог измениться (появился/снят участник, изменился режим
|
|
48
|
+
* «всем пользователям»).
|
|
49
|
+
*
|
|
50
|
+
* Список подписок = список **видимых** сессий (`listVisibleSessions` — тот
|
|
51
|
+
* же шов, что у списка сессий), поэтому пересчёт совпадает с видимостью
|
|
52
|
+
* проектов и не расходится с ней.
|
|
53
|
+
*
|
|
54
|
+
* Watch-all клиент (`allSessions`) не пересчитывается: его подписка
|
|
55
|
+
* глобальная и от проектов не зависит.
|
|
56
|
+
*/
|
|
57
|
+
resyncClient(client: EventClient): Promise<void>;
|
|
58
|
+
/**
|
|
59
|
+
* PROP-133 Ф2 / ADR-140 Ф2: пересчитать подписки **всем** подключённым
|
|
60
|
+
* клиентам (редкое admin-действие — смена состояния доступа к проекту).
|
|
61
|
+
*/
|
|
62
|
+
resyncAllClients(): Promise<void>;
|
|
29
63
|
shutdown(): void;
|
|
30
64
|
subscribeToSession(userId: string, sessionId: string): Promise<void>;
|
|
31
65
|
unsubscribeFromSession(userId: string, sessionId: string): void;
|