@itphx/synth-backend 0.10.0 → 0.11.3
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/bootstrap.d.ts +11 -0
- package/dist/app/bootstrap.js +19 -0
- package/dist/app/deps.d.ts +124 -0
- package/dist/app/deps.js +751 -0
- package/dist/app/listen.d.ts +34 -0
- package/dist/app/listen.js +309 -0
- package/dist/app/mount-routes.d.ts +31 -0
- package/dist/app/mount-routes.js +696 -0
- package/dist/app/sse-events.d.ts +15 -0
- package/dist/app/sse-events.js +83 -0
- package/dist/app.d.ts +30 -17
- package/dist/app.js +164 -1337
- package/dist/auth/guards.d.ts +2 -1
- package/dist/auth/guards.js +10 -2
- package/dist/auth/middleware.d.ts +9 -14
- package/dist/auth/middleware.js +38 -6
- package/dist/auth/oidc.d.ts +22 -0
- package/dist/auth/oidc.js +68 -9
- package/dist/auth/service-scope.d.ts +8 -4
- package/dist/auth/service-scope.js +9 -5
- package/dist/events/hub.d.ts +2 -2
- package/dist/events/hub.js +3 -38
- package/dist/lib/app-config.d.ts +2 -0
- package/dist/lib/app-config.js +3 -2
- package/dist/lib/cors.d.ts +23 -0
- package/dist/lib/cors.js +24 -0
- package/dist/lib/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +58 -6
- package/dist/main.js +23 -7
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +4 -2
- package/dist/routes/agents.d.ts +2 -2
- package/dist/routes/audit.d.ts +1 -1
- package/dist/routes/audit.js +2 -2
- package/dist/routes/auth.d.ts +2 -2
- package/dist/routes/auth.js +28 -4
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +3 -3
- package/dist/routes/gateway-patterns.js +1 -1
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +9 -5
- package/dist/routes/mcp-registry.d.ts +6 -6
- package/dist/routes/mcp-registry.js +10 -10
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.js +1 -1
- package/dist/routes/messages.d.ts +5 -4
- package/dist/routes/messages.js +30 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/projects.d.ts +7 -7
- package/dist/routes/projects.js +7 -7
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +34 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +14 -4
- package/dist/routes/sessions.js +234 -34
- package/dist/routes/users.js +1 -1
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +3 -3
package/dist/auth/guards.d.ts
CHANGED
|
@@ -3,7 +3,8 @@
|
|
|
3
3
|
* - запрос с service-key → требуется хотя бы один из `scopes`
|
|
4
4
|
* (`403 SCOPE_REQUIRED` иначе);
|
|
5
5
|
* - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
|
|
6
|
-
* роль ADMIN
|
|
6
|
+
* роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
|
|
7
|
+
* роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
|
|
7
8
|
*
|
|
8
9
|
* Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
|
|
9
10
|
* контексте). Используется на мутациях реестра MCP (`/servers*`), записи
|
package/dist/auth/guards.js
CHANGED
|
@@ -3,7 +3,7 @@ import { getServiceCredential } from '@itphx/synth-core';
|
|
|
3
3
|
import { hasServiceScope } from '@itphx/synth-shared';
|
|
4
4
|
import { t } from '../lib/i18n.js';
|
|
5
5
|
/**
|
|
6
|
-
*
|
|
6
|
+
* ADR-052/O1: комбинированные guard'ы «ADMIN **или** scope» для эндпоинтов,
|
|
7
7
|
* которые должны быть доступны и человеку-ADMIN, и installer-service-key'ю.
|
|
8
8
|
*
|
|
9
9
|
* `requireScope` (core) — no-op для интерактивных кред, поэтому одиночного
|
|
@@ -15,6 +15,10 @@ import { t } from '../lib/i18n.js';
|
|
|
15
15
|
function scopeDenied(c) {
|
|
16
16
|
return c.json({ error: { code: 'SCOPE_REQUIRED', message: t('errors.forbidden.scopeRequired', undefined, c) } }, 403);
|
|
17
17
|
}
|
|
18
|
+
/** `true`, если пользователь аутентифицирован (в контексте есть `user`). */
|
|
19
|
+
function isAuthenticated(c) {
|
|
20
|
+
return !!c.get('user');
|
|
21
|
+
}
|
|
18
22
|
/** `true`, если в контексте ADMIN (роли synthetic service-пользователя или человека). */
|
|
19
23
|
function isAdmin(c) {
|
|
20
24
|
const user = c.get('user');
|
|
@@ -25,7 +29,8 @@ function isAdmin(c) {
|
|
|
25
29
|
* - запрос с service-key → требуется хотя бы один из `scopes`
|
|
26
30
|
* (`403 SCOPE_REQUIRED` иначе);
|
|
27
31
|
* - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
|
|
28
|
-
* роль ADMIN
|
|
32
|
+
* роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
|
|
33
|
+
* роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
|
|
29
34
|
*
|
|
30
35
|
* Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
|
|
31
36
|
* контексте). Используется на мутациях реестра MCP (`/servers*`), записи
|
|
@@ -41,6 +46,9 @@ export function requireAdminOrScope(...scopes) {
|
|
|
41
46
|
await next();
|
|
42
47
|
return;
|
|
43
48
|
}
|
|
49
|
+
if (!isAuthenticated(c)) {
|
|
50
|
+
return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
|
|
51
|
+
}
|
|
44
52
|
if (!isAdmin(c)) {
|
|
45
53
|
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
46
54
|
}
|
|
@@ -2,7 +2,12 @@ import type { AuthConfig, User } from '@itphx/synth-shared';
|
|
|
2
2
|
import type { ServiceKeyCredential } from '@itphx/synth-core';
|
|
3
3
|
import { setCookie, deleteCookie } from 'hono/cookie';
|
|
4
4
|
/**
|
|
5
|
-
*
|
|
5
|
+
* Флаг `Secure` cookie сессии: по умолчанию `true`; локальная http-разработка
|
|
6
|
+
* отключает его явным `SYNTH_COOKIE_INSECURE=true` (небезопасно вне localhost).
|
|
7
|
+
*/
|
|
8
|
+
export declare function isSessionCookieSecure(env?: NodeJS.ProcessEnv): boolean;
|
|
9
|
+
/**
|
|
10
|
+
* ADR-052 (этап I): резолвер service-key (`synth_svc_…`) → синтетический
|
|
6
11
|
* пользователь (RBAC) + контекст (`scopes`/`allowedProjects`/лимит).
|
|
7
12
|
* `null` — секрет неизвестен/отозван/истёк либо резолвер не настроен.
|
|
8
13
|
*/
|
|
@@ -10,7 +15,7 @@ export type ServiceKeyResolver = (rawSecret: string) => Promise<{
|
|
|
10
15
|
user: User;
|
|
11
16
|
credential: ServiceKeyCredential;
|
|
12
17
|
} | null>;
|
|
13
|
-
/** Конфиг backend-auth: `AuthConfig` + service-key (
|
|
18
|
+
/** Конфиг backend-auth: `AuthConfig` + service-key (ADR-052). */
|
|
14
19
|
export interface AuthMiddlewareConfig extends AuthConfig {
|
|
15
20
|
resolveServiceKey?: ServiceKeyResolver;
|
|
16
21
|
}
|
|
@@ -27,18 +32,8 @@ export declare function createAuthMiddleware(config: AuthMiddlewareConfig): {
|
|
|
27
32
|
message: string;
|
|
28
33
|
};
|
|
29
34
|
}, 401, "json">)>;
|
|
30
|
-
requireAdmin: import("hono").MiddlewareHandler<any, string, {}, Response
|
|
31
|
-
|
|
32
|
-
code: string;
|
|
33
|
-
message: string;
|
|
34
|
-
};
|
|
35
|
-
}, 403, "json">)>;
|
|
36
|
-
requirePermission: (...roles: string[]) => import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
|
|
37
|
-
error: {
|
|
38
|
-
code: string;
|
|
39
|
-
message: string;
|
|
40
|
-
};
|
|
41
|
-
}, 403, "json">)>;
|
|
35
|
+
requireAdmin: import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
36
|
+
requirePermission: (...roles: string[]) => import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
42
37
|
isAdmin: (c: {
|
|
43
38
|
get(key: "user"): unknown;
|
|
44
39
|
}) => boolean;
|
package/dist/auth/middleware.js
CHANGED
|
@@ -4,6 +4,13 @@ import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
|
|
|
4
4
|
import { t } from '../lib/i18n.js';
|
|
5
5
|
import { createLazyOidcClient } from './oidc.js';
|
|
6
6
|
const SESSION_COOKIE = 'user_session';
|
|
7
|
+
/**
|
|
8
|
+
* Флаг `Secure` cookie сессии: по умолчанию `true`; локальная http-разработка
|
|
9
|
+
* отключает его явным `SYNTH_COOKIE_INSECURE=true` (небезопасно вне localhost).
|
|
10
|
+
*/
|
|
11
|
+
export function isSessionCookieSecure(env = process.env) {
|
|
12
|
+
return env.SYNTH_COOKIE_INSECURE !== 'true';
|
|
13
|
+
}
|
|
7
14
|
// In-memory хранилище сессий (для debug mode)
|
|
8
15
|
const sessions = new Map();
|
|
9
16
|
// Очистка истёкших сессий каждые 5 минут
|
|
@@ -25,8 +32,15 @@ function extractBearerToken(h) {
|
|
|
25
32
|
export function createAuthMiddleware(config) {
|
|
26
33
|
// Ленивый OIDC-клиент (мемоизация, безопасно при отсутствии oidc — null)
|
|
27
34
|
const getOidcClient = createLazyOidcClient(config.oidc);
|
|
35
|
+
// Cookie сессии — `Secure` по умолчанию; отключается только явным opt-out
|
|
36
|
+
// для локальной http-разработки (`SYNTH_COOKIE_INSECURE=true`).
|
|
37
|
+
const cookieSecure = isSessionCookieSecure();
|
|
38
|
+
if (!cookieSecure) {
|
|
39
|
+
console.warn('[auth] SYNTH_COOKIE_INSECURE=true — cookie сессии устанавливается без флага Secure '
|
|
40
|
+
+ '(допустимо только для локальной http-разработки)');
|
|
41
|
+
}
|
|
28
42
|
/**
|
|
29
|
-
*
|
|
43
|
+
* ADR-052: машинная аутентификация по service-key. Распознаётся по префиксу
|
|
30
44
|
* секрета `synth_svc_`; резолвер асинхронный (стор + touch `lastUsedAt`),
|
|
31
45
|
* поэтому ветка живёт в middleware, а не в синхронном `getCurrentUser`.
|
|
32
46
|
*/
|
|
@@ -40,7 +54,7 @@ export function createAuthMiddleware(config) {
|
|
|
40
54
|
};
|
|
41
55
|
// Определить пользователя из запроса
|
|
42
56
|
const getCurrentUser = async (c) => {
|
|
43
|
-
// 0.
|
|
57
|
+
// 0. ADR-052: service-key — синтетический пользователь ключа.
|
|
44
58
|
const serviceAuth = await resolveServiceKey(c);
|
|
45
59
|
if (serviceAuth)
|
|
46
60
|
return serviceAuth.user;
|
|
@@ -120,7 +134,7 @@ export function createAuthMiddleware(config) {
|
|
|
120
134
|
};
|
|
121
135
|
// Middleware: прикрепить пользователя к контексту (без ошибки)
|
|
122
136
|
const attachUser = createMiddleware(async (c, next) => {
|
|
123
|
-
//
|
|
137
|
+
// ADR-052: service-key несёт и пользователя, и контекст (scopes/проекция).
|
|
124
138
|
const serviceAuth = await resolveServiceKey(c);
|
|
125
139
|
if (serviceAuth) {
|
|
126
140
|
c.set('user', serviceAuth.user);
|
|
@@ -154,10 +168,25 @@ export function createAuthMiddleware(config) {
|
|
|
154
168
|
c.set('user', user);
|
|
155
169
|
await next();
|
|
156
170
|
});
|
|
171
|
+
/**
|
|
172
|
+
* Семантика HTTP для ролевых guard'ов (`requireAdmin`/`requirePermission`):
|
|
173
|
+
* нет аутентификации → `401 UNAUTHORIZED`; аутентифицирован, но роли не хватает
|
|
174
|
+
* → `403 FORBIDDEN`. Возвращает готовый 401-ответ, если пользователя в контексте
|
|
175
|
+
* нет (иначе `null`). Раньше оба случая склеивались в 403, и анонимный запрос к
|
|
176
|
+
* ADMIN-роуту получал 403 вместо 401.
|
|
177
|
+
*/
|
|
178
|
+
const ensureAuthenticated = (c) => {
|
|
179
|
+
if (c.get('user'))
|
|
180
|
+
return null;
|
|
181
|
+
return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
|
|
182
|
+
};
|
|
157
183
|
// Middleware: требовать роль ADMIN
|
|
158
184
|
const requireAdmin = createMiddleware(async (c, next) => {
|
|
185
|
+
const unauthenticated = ensureAuthenticated(c);
|
|
186
|
+
if (unauthenticated)
|
|
187
|
+
return unauthenticated;
|
|
159
188
|
const user = c.get('user');
|
|
160
|
-
if (!user
|
|
189
|
+
if (!user.roles.includes('ADMIN')) {
|
|
161
190
|
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
162
191
|
}
|
|
163
192
|
await next();
|
|
@@ -179,8 +208,11 @@ export function createAuthMiddleware(config) {
|
|
|
179
208
|
const isAdmin = (c) => hasRole(c, 'ADMIN');
|
|
180
209
|
// Middleware: требовать одну из указанных ролей (например, ADMIN/AUDITOR)
|
|
181
210
|
const requirePermission = (...roles) => createMiddleware(async (c, next) => {
|
|
211
|
+
const unauthenticated = ensureAuthenticated(c);
|
|
212
|
+
if (unauthenticated)
|
|
213
|
+
return unauthenticated;
|
|
182
214
|
const user = c.get('user');
|
|
183
|
-
if (!
|
|
215
|
+
if (!roles.some((r) => user.roles.includes(r))) {
|
|
184
216
|
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
185
217
|
}
|
|
186
218
|
await next();
|
|
@@ -204,7 +236,7 @@ export function createAuthMiddleware(config) {
|
|
|
204
236
|
setCookie(c, SESSION_COOKIE, sessionId, {
|
|
205
237
|
path: '/',
|
|
206
238
|
httpOnly: true,
|
|
207
|
-
secure:
|
|
239
|
+
secure: cookieSecure,
|
|
208
240
|
sameSite: 'Lax',
|
|
209
241
|
maxAge: config.sessionMaxAgeMinutes * 60,
|
|
210
242
|
});
|
package/dist/auth/oidc.d.ts
CHANGED
|
@@ -8,6 +8,14 @@ export interface OidcConfig {
|
|
|
8
8
|
clientId: string;
|
|
9
9
|
clientSecret: string;
|
|
10
10
|
redirectUri: string;
|
|
11
|
+
/**
|
|
12
|
+
* Дополнительные допустимые `aud` (в дополнение к дефолтам: для id_token —
|
|
13
|
+
* `clientId`, для access_token — `clientId`/`account`). В Keycloak
|
|
14
|
+
* `id_token.aud` = clientId, а `access_token.aud` обычно `account` (строкой
|
|
15
|
+
* или массивом); доп. значения — только для нестандартных конфигураций.
|
|
16
|
+
* Issuer проверяется всегда.
|
|
17
|
+
*/
|
|
18
|
+
audience?: string[];
|
|
11
19
|
}
|
|
12
20
|
/** Подмножество документа discovery OpenID Connect. */
|
|
13
21
|
export interface OidcDiscovery {
|
|
@@ -47,6 +55,7 @@ export declare class OidcClient {
|
|
|
47
55
|
exchangePassword(username: string, password: string): Promise<OidcTokenResult>;
|
|
48
56
|
/**
|
|
49
57
|
* Проверка JWT (id_token или access_token) через JWKS провайдера.
|
|
58
|
+
* Проверяются подпись, `iss` (issuer) и `aud`.
|
|
50
59
|
* Возвращает User-подобный объект: id, username, email, roles.
|
|
51
60
|
*/
|
|
52
61
|
verifyToken(token: string): Promise<OidcUser>;
|
|
@@ -55,6 +64,19 @@ export declare class OidcClient {
|
|
|
55
64
|
* Роли: из id_token, если пусто — из access_token (client roles учитываются).
|
|
56
65
|
*/
|
|
57
66
|
verifyTokens(idToken: string, accessToken: string): Promise<OidcUser>;
|
|
67
|
+
/**
|
|
68
|
+
* ADR-099: JWKS-набор с **явным** транспортом доверия TLS/CA (`egressFetch`),
|
|
69
|
+
* а не через глобальный dispatcher процесса — точка не зависит от глобального
|
|
70
|
+
* состояния (`applyGlobalTlsTrust` остаётся основным каналом для прочих fetch).
|
|
71
|
+
* jose 6 отдаёт кастомный транспорт через символ `customFetch`.
|
|
72
|
+
*/
|
|
73
|
+
private _remoteJwks;
|
|
74
|
+
/** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
|
|
75
|
+
private _idTokenAudience;
|
|
76
|
+
/** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
|
|
77
|
+
private _accessTokenAudience;
|
|
78
|
+
/** Допустимые `aud` для bearer-токена неизвестного типа — объединение. */
|
|
79
|
+
private _anyTokenAudience;
|
|
58
80
|
}
|
|
59
81
|
/** User-подобный объект, извлечённый из OIDC-токена. */
|
|
60
82
|
export interface OidcUser {
|
package/dist/auth/oidc.js
CHANGED
|
@@ -1,4 +1,8 @@
|
|
|
1
|
-
import { jwtVerify, createRemoteJWKSet } from 'jose';
|
|
1
|
+
import { jwtVerify, createRemoteJWKSet, customFetch } from 'jose';
|
|
2
|
+
// ADR-099: дискавери/токен-эндпоинты/JWKS OIDC — через единый транспорт доверия TLS/CA.
|
|
3
|
+
import { egressFetch } from '@itphx/synth-core';
|
|
4
|
+
/** Audience access_token по умолчанию (Keycloak): клиент либо `account`. */
|
|
5
|
+
const DEFAULT_ACCESS_TOKEN_AUDIENCE = 'account';
|
|
2
6
|
/** Известные роли Synth (в realm роли записаны в нижнем регистре). */
|
|
3
7
|
const KNOWN_ROLES = ['ADMIN', 'USER', 'LEAD', 'AUDITOR'];
|
|
4
8
|
/**
|
|
@@ -18,7 +22,8 @@ export class OidcClient {
|
|
|
18
22
|
if (this._discovery)
|
|
19
23
|
return this._discovery;
|
|
20
24
|
const url = `${this.config.issuer}/.well-known/openid-configuration`;
|
|
21
|
-
|
|
25
|
+
// ADR-099: дискавери — через единый транспорт доверия TLS/CA.
|
|
26
|
+
const res = await egressFetch(url);
|
|
22
27
|
if (!res.ok) {
|
|
23
28
|
throw new Error(`OIDC discovery failed: ${res.status} ${url}`);
|
|
24
29
|
}
|
|
@@ -55,7 +60,8 @@ export class OidcClient {
|
|
|
55
60
|
client_id: this.config.clientId,
|
|
56
61
|
client_secret: this.config.clientSecret,
|
|
57
62
|
});
|
|
58
|
-
|
|
63
|
+
// ADR-099: обмен кода на токены — через единый транспорт доверия TLS/CA.
|
|
64
|
+
const res = await egressFetch(discovery.token_endpoint, {
|
|
59
65
|
method: 'POST',
|
|
60
66
|
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
|
|
61
67
|
body: body.toString(),
|
|
@@ -83,7 +89,8 @@ export class OidcClient {
|
|
|
83
89
|
password,
|
|
84
90
|
scope: 'openid',
|
|
85
91
|
});
|
|
86
|
-
|
|
92
|
+
// ADR-099: ROPC-вход — через единый транспорт доверия TLS/CA.
|
|
93
|
+
const res = await egressFetch(discovery.token_endpoint, {
|
|
87
94
|
method: 'POST',
|
|
88
95
|
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
|
|
89
96
|
body: body.toString(),
|
|
@@ -100,12 +107,19 @@ export class OidcClient {
|
|
|
100
107
|
}
|
|
101
108
|
/**
|
|
102
109
|
* Проверка JWT (id_token или access_token) через JWKS провайдера.
|
|
110
|
+
* Проверяются подпись, `iss` (issuer) и `aud`.
|
|
103
111
|
* Возвращает User-подобный объект: id, username, email, roles.
|
|
104
112
|
*/
|
|
105
113
|
async verifyToken(token) {
|
|
106
114
|
const discovery = await this.getDiscovery();
|
|
107
|
-
const jwks =
|
|
108
|
-
|
|
115
|
+
const jwks = this._remoteJwks(discovery.jwks_uri);
|
|
116
|
+
// Тип bearer-токена заранее неизвестен (id_token или access_token), поэтому
|
|
117
|
+
// принимаем audience обоих классов: clientId (id_token) и clientId/`account`
|
|
118
|
+
// (access_token Keycloak). Issuer проверяется всегда.
|
|
119
|
+
const { payload } = await jwtVerify(token, jwks, {
|
|
120
|
+
issuer: this.config.issuer,
|
|
121
|
+
audience: this._anyTokenAudience(),
|
|
122
|
+
});
|
|
109
123
|
return extractUser(payload, this.config.clientId);
|
|
110
124
|
}
|
|
111
125
|
/**
|
|
@@ -114,11 +128,56 @@ export class OidcClient {
|
|
|
114
128
|
*/
|
|
115
129
|
async verifyTokens(idToken, accessToken) {
|
|
116
130
|
const discovery = await this.getDiscovery();
|
|
117
|
-
const jwks =
|
|
118
|
-
const { payload: idPayload } = await jwtVerify(idToken, jwks
|
|
119
|
-
|
|
131
|
+
const jwks = this._remoteJwks(discovery.jwks_uri);
|
|
132
|
+
const { payload: idPayload } = await jwtVerify(idToken, jwks, {
|
|
133
|
+
issuer: this.config.issuer,
|
|
134
|
+
// id_token.aud = clientId (+ доп. из конфига).
|
|
135
|
+
audience: this._idTokenAudience(),
|
|
136
|
+
});
|
|
137
|
+
const { payload: accessPayload } = await jwtVerify(accessToken, jwks, {
|
|
138
|
+
issuer: this.config.issuer,
|
|
139
|
+
// Keycloak кладёт в access_token.aud `account`, а клиента — в `azp`;
|
|
140
|
+
// принимаем clientId ИЛИ `account` (+ доп. из конфига), чтобы не ломать
|
|
141
|
+
// валидные токены. `azp` намеренно не форсим (иначе токены realm-клиентов,
|
|
142
|
+
// напр. `synth-cli`, отвергались бы) — issuer и подпись проверяются всегда.
|
|
143
|
+
audience: this._accessTokenAudience(),
|
|
144
|
+
});
|
|
120
145
|
return extractUserFromTokens(idPayload, accessPayload, this.config.clientId);
|
|
121
146
|
}
|
|
147
|
+
/**
|
|
148
|
+
* ADR-099: JWKS-набор с **явным** транспортом доверия TLS/CA (`egressFetch`),
|
|
149
|
+
* а не через глобальный dispatcher процесса — точка не зависит от глобального
|
|
150
|
+
* состояния (`applyGlobalTlsTrust` остаётся основным каналом для прочих fetch).
|
|
151
|
+
* jose 6 отдаёт кастомный транспорт через символ `customFetch`.
|
|
152
|
+
*/
|
|
153
|
+
_remoteJwks(jwksUri) {
|
|
154
|
+
return createRemoteJWKSet(new URL(jwksUri), {
|
|
155
|
+
[customFetch]: (url, options) => egressFetch(url, {
|
|
156
|
+
headers: options.headers,
|
|
157
|
+
method: options.method,
|
|
158
|
+
redirect: options.redirect,
|
|
159
|
+
signal: options.signal,
|
|
160
|
+
}),
|
|
161
|
+
});
|
|
162
|
+
}
|
|
163
|
+
/** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
|
|
164
|
+
_idTokenAudience() {
|
|
165
|
+
return [...new Set([this.config.clientId, ...(this.config.audience ?? [])])].filter(Boolean);
|
|
166
|
+
}
|
|
167
|
+
/** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
|
|
168
|
+
_accessTokenAudience() {
|
|
169
|
+
return [
|
|
170
|
+
...new Set([
|
|
171
|
+
this.config.clientId,
|
|
172
|
+
DEFAULT_ACCESS_TOKEN_AUDIENCE,
|
|
173
|
+
...(this.config.audience ?? []),
|
|
174
|
+
]),
|
|
175
|
+
].filter(Boolean);
|
|
176
|
+
}
|
|
177
|
+
/** Допустимые `aud` для bearer-токена неизвестного типа — объединение. */
|
|
178
|
+
_anyTokenAudience() {
|
|
179
|
+
return [...new Set([...this._idTokenAudience(), ...this._accessTokenAudience()])];
|
|
180
|
+
}
|
|
122
181
|
}
|
|
123
182
|
/**
|
|
124
183
|
* Извлечь известные роли из payload токена Keycloak:
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { ServiceProjectProjectionGuard, ScopeGuardFactory } from '@itphx/synth-core';
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
3
|
+
* ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
|
|
4
4
|
*
|
|
5
5
|
* Enforcement (`hasServiceScope`/`isProjectAllowed`) остаётся в core —
|
|
6
6
|
* здесь только локализация отказов (`SCOPE_REQUIRED`/`PROJECT_FORBIDDEN`)
|
|
@@ -10,5 +10,9 @@ import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
|
|
|
10
10
|
*/
|
|
11
11
|
/** Scope-гейт: делегирует проверку core-`requireScope`, переводит 403 на i18n. */
|
|
12
12
|
export declare const scopeGuard: ScopeGuardFactory;
|
|
13
|
-
/**
|
|
14
|
-
|
|
13
|
+
/**
|
|
14
|
+
* Гейт **проектной проекции service-key**: делегирует core-
|
|
15
|
+
* `checkServiceProjectProjection`, переводит 403. Это не проверка прав
|
|
16
|
+
* пользователя (RBAC): для интерактивных кред — no-op.
|
|
17
|
+
*/
|
|
18
|
+
export declare const serviceProjectProjection: ServiceProjectProjectionGuard;
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { createMiddleware } from 'hono/factory';
|
|
2
|
-
import { requireScope,
|
|
2
|
+
import { requireScope, checkServiceProjectProjection } from '@itphx/synth-core';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
4
|
/**
|
|
5
|
-
*
|
|
5
|
+
* ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
|
|
6
6
|
*
|
|
7
7
|
* Enforcement (`hasServiceScope`/`isProjectAllowed`) остаётся в core —
|
|
8
8
|
* здесь только локализация отказов (`SCOPE_REQUIRED`/`PROJECT_FORBIDDEN`)
|
|
@@ -26,9 +26,13 @@ export const scopeGuard = (...required) => {
|
|
|
26
26
|
await next();
|
|
27
27
|
});
|
|
28
28
|
};
|
|
29
|
-
/**
|
|
30
|
-
|
|
31
|
-
|
|
29
|
+
/**
|
|
30
|
+
* Гейт **проектной проекции service-key**: делегирует core-
|
|
31
|
+
* `checkServiceProjectProjection`, переводит 403. Это не проверка прав
|
|
32
|
+
* пользователя (RBAC): для интерактивных кред — no-op.
|
|
33
|
+
*/
|
|
34
|
+
export const serviceProjectProjection = (c, projectId) => {
|
|
35
|
+
const denied = checkServiceProjectProjection(c, projectId);
|
|
32
36
|
if (!denied)
|
|
33
37
|
return undefined;
|
|
34
38
|
return c.json({
|
package/dist/events/hub.d.ts
CHANGED
|
@@ -7,8 +7,8 @@ export interface EventClient {
|
|
|
7
7
|
/**
|
|
8
8
|
* Watch-all: клиент получает события ВСЕХ сессий через глобальный поток
|
|
9
9
|
* `eventBus.subscribeAll`, а не только сессии владельца `userId`.
|
|
10
|
-
* Используется машинными watcher'ами (service-key,
|
|
11
|
-
* сквозного обзора ADMIN/LEAD (
|
|
10
|
+
* Используется машинными watcher'ами (service-key, ADR-052 этап IV) и ролями
|
|
11
|
+
* сквозного обзора ADMIN/LEAD (ADR-089) — паритет со standalone-core SSE.
|
|
12
12
|
*/
|
|
13
13
|
allSessions?: boolean;
|
|
14
14
|
send(event: BusEvent): void;
|
package/dist/events/hub.js
CHANGED
|
@@ -1,42 +1,6 @@
|
|
|
1
|
+
import { extractChildSessionId } from '@itphx/synth-core';
|
|
1
2
|
/** Служебный ключ глобальной подписки all-клиента в `clientSubs`. */
|
|
2
3
|
const ALL_SESSIONS_KEY = '*';
|
|
3
|
-
/** Безопасное чтение непустой строки из `unknown`. */
|
|
4
|
-
function readString(value) {
|
|
5
|
-
return typeof value === 'string' && value.length > 0 ? value : undefined;
|
|
6
|
-
}
|
|
7
|
-
/**
|
|
8
|
-
* Извлечь id новой дочерней сессии из события, опубликованного в родительскую
|
|
9
|
-
* сессию. Дочерние сессии саб-агентов создаются тулом `task` напрямую через
|
|
10
|
-
* `SessionManager`, минуя роуты, поэтому клиент изначально на них не подписан.
|
|
11
|
-
* Тул `task` публикует `session.created` (payload — serializeSession ребёнка) в
|
|
12
|
-
* родителя ДО старта LLM-стрима ребёнка, так что автоподписка успевает.
|
|
13
|
-
* `child.session.updated` несёт `session` (id внутри), `child.message.added` и
|
|
14
|
-
* resume-события — `child_session_id`. Ключи каждого события читаются ровно в
|
|
15
|
-
* одном месте (типизированные payload-интерфейсы выше).
|
|
16
|
-
*/
|
|
17
|
-
function extractChildSessionId(event) {
|
|
18
|
-
const data = event.data;
|
|
19
|
-
if (!data)
|
|
20
|
-
return undefined;
|
|
21
|
-
switch (event.type) {
|
|
22
|
-
case 'session.created': {
|
|
23
|
-
const payload = data;
|
|
24
|
-
return readString(payload.id);
|
|
25
|
-
}
|
|
26
|
-
case 'child.session.updated': {
|
|
27
|
-
const payload = data;
|
|
28
|
-
return readString(payload.session?.id) ?? readString(payload.child_session_id);
|
|
29
|
-
}
|
|
30
|
-
case 'child.message.added':
|
|
31
|
-
case 'subagent.resume.started':
|
|
32
|
-
case 'subagent.resume.finished': {
|
|
33
|
-
const payload = data;
|
|
34
|
-
return readString(payload.child_session_id);
|
|
35
|
-
}
|
|
36
|
-
default:
|
|
37
|
-
return undefined;
|
|
38
|
-
}
|
|
39
|
-
}
|
|
40
4
|
/**
|
|
41
5
|
* EventHub — центральный диспетчер подписок на события сессий.
|
|
42
6
|
* Управляет active-клиентами пользователя (WS и SSE),
|
|
@@ -64,7 +28,8 @@ export class EventHub {
|
|
|
64
28
|
console.log(`[EventHub] Register client (all sessions): user=${client.username} clients=${arr.length}`);
|
|
65
29
|
return;
|
|
66
30
|
}
|
|
67
|
-
|
|
31
|
+
// Нужны только id сессий владельца — лёгкая выборка (без истории сообщений).
|
|
32
|
+
const sessions = await this.sessionManager.listSessions({ userId: client.userId }, { light: true });
|
|
68
33
|
console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
|
|
69
34
|
for (const s of sessions) {
|
|
70
35
|
this._subscribeClientToSession(client, s.id);
|
package/dist/lib/app-config.d.ts
CHANGED
package/dist/lib/app-config.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot } from '@itphx/synth-shared';
|
|
1
|
+
import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes } from '@itphx/synth-shared';
|
|
2
2
|
const envStr = (key, fallback = '') => process.env[key] || fallback;
|
|
3
3
|
const envBool = (key, fallback = false) => process.env[key] ? process.env[key] === 'true' : fallback;
|
|
4
4
|
const envInt = (key, fallback) => {
|
|
@@ -59,6 +59,7 @@ export async function loadBackendConfig(options) {
|
|
|
59
59
|
const auth = buildAuthConfig(synth.auth);
|
|
60
60
|
const dataDir = resolveDataDir(synth);
|
|
61
61
|
const workspacesRoot = resolveWorkspacesRoot(synth);
|
|
62
|
+
const maxUploadBytes = resolveMaxUploadBytes(synth);
|
|
62
63
|
const port = resolvePort(synth, 'SYNTH_PORT', synth.server.port);
|
|
63
|
-
return { synth, dataDir, workspacesRoot, port, auth };
|
|
64
|
+
return { synth, dataDir, workspacesRoot, maxUploadBytes, port, auth };
|
|
64
65
|
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CORS origin-политика backend (fail-closed).
|
|
3
|
+
*
|
|
4
|
+
* Приоритет:
|
|
5
|
+
* 1. явный `SYNTH_CORS_ORIGIN` (env) — используется всегда (как раньше);
|
|
6
|
+
* 2. явный dev-режим `SYNTH_CORS_ALLOW_ALL=true` — отражаем запрошенный origin;
|
|
7
|
+
* 3. точное совпадение с белым списком `server.allowedOrigins` — эхо;
|
|
8
|
+
* 4. иначе — `undefined`: заголовки CORS не выставляются.
|
|
9
|
+
*
|
|
10
|
+
* Пустой белый список больше НЕ означает «разрешить всё»: без явного флага
|
|
11
|
+
* произвольный origin не отражается (иначе `credentials: true` + эхо = CSRF-риск).
|
|
12
|
+
* Для локальной разработки открытый CORS включается явно (env-флаг).
|
|
13
|
+
*/
|
|
14
|
+
export interface CorsOriginOptions {
|
|
15
|
+
/** Белый список `server.allowedOrigins` из конфига. */
|
|
16
|
+
allowedOrigins: string[];
|
|
17
|
+
/** Явный origin из env `SYNTH_CORS_ORIGIN` (приоритетнее белого списка). */
|
|
18
|
+
envOrigin?: string;
|
|
19
|
+
/** Явный dev-режим `SYNTH_CORS_ALLOW_ALL=true` — отражать любой origin. */
|
|
20
|
+
allowAll?: boolean;
|
|
21
|
+
}
|
|
22
|
+
/** Разрешить ли `origin` для CORS; `undefined` — заголовки не выставляются. */
|
|
23
|
+
export declare function resolveCorsOrigin(origin: string | undefined, { allowedOrigins, envOrigin, allowAll }: CorsOriginOptions): string | undefined;
|
package/dist/lib/cors.js
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CORS origin-политика backend (fail-closed).
|
|
3
|
+
*
|
|
4
|
+
* Приоритет:
|
|
5
|
+
* 1. явный `SYNTH_CORS_ORIGIN` (env) — используется всегда (как раньше);
|
|
6
|
+
* 2. явный dev-режим `SYNTH_CORS_ALLOW_ALL=true` — отражаем запрошенный origin;
|
|
7
|
+
* 3. точное совпадение с белым списком `server.allowedOrigins` — эхо;
|
|
8
|
+
* 4. иначе — `undefined`: заголовки CORS не выставляются.
|
|
9
|
+
*
|
|
10
|
+
* Пустой белый список больше НЕ означает «разрешить всё»: без явного флага
|
|
11
|
+
* произвольный origin не отражается (иначе `credentials: true` + эхо = CSRF-риск).
|
|
12
|
+
* Для локальной разработки открытый CORS включается явно (env-флаг).
|
|
13
|
+
*/
|
|
14
|
+
/** Разрешить ли `origin` для CORS; `undefined` — заголовки не выставляются. */
|
|
15
|
+
export function resolveCorsOrigin(origin, { allowedOrigins, envOrigin, allowAll = false }) {
|
|
16
|
+
if (envOrigin)
|
|
17
|
+
return envOrigin;
|
|
18
|
+
if (allowAll)
|
|
19
|
+
return origin || undefined;
|
|
20
|
+
// Same-origin/нативные клиенты (нет Origin) в CORS-заголовках не нуждаются.
|
|
21
|
+
if (!origin)
|
|
22
|
+
return undefined;
|
|
23
|
+
return allowedOrigins.includes(origin) ? origin : undefined;
|
|
24
|
+
}
|
|
@@ -1,25 +1,2 @@
|
|
|
1
|
-
export
|
|
2
|
-
|
|
3
|
-
themeMode?: 'system' | 'light' | 'dark';
|
|
4
|
-
theme?: string;
|
|
5
|
-
uiScaleMobile?: number;
|
|
6
|
-
uiScaleDesktop?: number;
|
|
7
|
-
}
|
|
8
|
-
export declare const UI_SCALE_MIN = 0.5;
|
|
9
|
-
export declare const UI_SCALE_MAX = 1.2;
|
|
10
|
-
/**
|
|
11
|
-
* Умолчания оформления (locale/themeMode/theme/uiScaleMobile/uiScaleDesktop) для всех пользователей.
|
|
12
|
-
*
|
|
13
|
-
* Хранятся одним JSON-файлом `{dataDir}/defaults.json`. Запись атомарная:
|
|
14
|
-
* временный файл `.tmp.{uuid}` → `rename()`. Значения переживают рестарт.
|
|
15
|
-
*/
|
|
16
|
-
export declare class DefaultsStore {
|
|
17
|
-
private _opts;
|
|
18
|
-
private _lock;
|
|
19
|
-
constructor(_opts: {
|
|
20
|
-
dataDir: string;
|
|
21
|
-
});
|
|
22
|
-
private _filePath;
|
|
23
|
-
loadDefaults(): Promise<AppearanceDefaults>;
|
|
24
|
-
saveDefaults(patch: AppearanceDefaults): Promise<AppearanceDefaults>;
|
|
25
|
-
}
|
|
1
|
+
export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
|
|
2
|
+
export type { AppearanceDefaults } from '@itphx/synth-core';
|