@itphx/synth-backend 0.10.0 → 0.10.1
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 +106 -0
- package/dist/app/deps.js +617 -0
- package/dist/app/listen.d.ts +29 -0
- package/dist/app/listen.js +298 -0
- package/dist/app/mount-routes.d.ts +18 -0
- package/dist/app/mount-routes.js +466 -0
- package/dist/app/sse-events.d.ts +15 -0
- package/dist/app/sse-events.js +83 -0
- package/dist/app.d.ts +15 -11
- package/dist/app.js +71 -1337
- package/dist/auth/guards.js +1 -1
- package/dist/auth/middleware.d.ts +7 -2
- package/dist/auth/middleware.js +18 -4
- package/dist/auth/oidc.d.ts +15 -0
- package/dist/auth/oidc.js +41 -3
- package/dist/auth/service-scope.d.ts +1 -1
- package/dist/auth/service-scope.js +1 -1
- package/dist/events/hub.d.ts +2 -2
- package/dist/lib/cors.d.ts +23 -0
- package/dist/lib/cors.js +24 -0
- package/dist/lib/i18n.js +10 -6
- package/dist/main.js +4 -4
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +4 -2
- package/dist/routes/audit.d.ts +1 -1
- package/dist/routes/audit.js +2 -2
- package/dist/routes/auth.js +28 -4
- package/dist/routes/gateway-patterns.d.ts +1 -1
- package/dist/routes/gateway-patterns.js +1 -1
- package/dist/routes/llm.js +5 -4
- package/dist/routes/mcp-registry.d.ts +3 -3
- package/dist/routes/mcp-registry.js +8 -8
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.js +1 -1
- package/dist/routes/projects.d.ts +4 -4
- package/dist/routes/projects.js +7 -7
- package/dist/routes/providers.js +1 -0
- package/dist/routes/sessions.d.ts +1 -1
- package/dist/routes/sessions.js +89 -13
- package/dist/routes/users.js +1 -1
- package/package.json +3 -3
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 для интерактивных кред, поэтому одиночного
|
|
@@ -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
|
}
|
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);
|
|
@@ -204,7 +218,7 @@ export function createAuthMiddleware(config) {
|
|
|
204
218
|
setCookie(c, SESSION_COOKIE, sessionId, {
|
|
205
219
|
path: '/',
|
|
206
220
|
httpOnly: true,
|
|
207
|
-
secure:
|
|
221
|
+
secure: cookieSecure,
|
|
208
222
|
sameSite: 'Lax',
|
|
209
223
|
maxAge: config.sessionMaxAgeMinutes * 60,
|
|
210
224
|
});
|
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,12 @@ export declare class OidcClient {
|
|
|
55
64
|
* Роли: из id_token, если пусто — из access_token (client roles учитываются).
|
|
56
65
|
*/
|
|
57
66
|
verifyTokens(idToken: string, accessToken: string): Promise<OidcUser>;
|
|
67
|
+
/** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
|
|
68
|
+
private _idTokenAudience;
|
|
69
|
+
/** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
|
|
70
|
+
private _accessTokenAudience;
|
|
71
|
+
/** Допустимые `aud` для bearer-токена неизвестного типа — объединение. */
|
|
72
|
+
private _anyTokenAudience;
|
|
58
73
|
}
|
|
59
74
|
/** User-подобный объект, извлечённый из OIDC-токена. */
|
|
60
75
|
export interface OidcUser {
|
package/dist/auth/oidc.js
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import { jwtVerify, createRemoteJWKSet } from 'jose';
|
|
2
|
+
/** Audience access_token по умолчанию (Keycloak): клиент либо `account`. */
|
|
3
|
+
const DEFAULT_ACCESS_TOKEN_AUDIENCE = 'account';
|
|
2
4
|
/** Известные роли Synth (в realm роли записаны в нижнем регистре). */
|
|
3
5
|
const KNOWN_ROLES = ['ADMIN', 'USER', 'LEAD', 'AUDITOR'];
|
|
4
6
|
/**
|
|
@@ -100,12 +102,19 @@ export class OidcClient {
|
|
|
100
102
|
}
|
|
101
103
|
/**
|
|
102
104
|
* Проверка JWT (id_token или access_token) через JWKS провайдера.
|
|
105
|
+
* Проверяются подпись, `iss` (issuer) и `aud`.
|
|
103
106
|
* Возвращает User-подобный объект: id, username, email, roles.
|
|
104
107
|
*/
|
|
105
108
|
async verifyToken(token) {
|
|
106
109
|
const discovery = await this.getDiscovery();
|
|
107
110
|
const jwks = createRemoteJWKSet(new URL(discovery.jwks_uri));
|
|
108
|
-
|
|
111
|
+
// Тип bearer-токена заранее неизвестен (id_token или access_token), поэтому
|
|
112
|
+
// принимаем audience обоих классов: clientId (id_token) и clientId/`account`
|
|
113
|
+
// (access_token Keycloak). Issuer проверяется всегда.
|
|
114
|
+
const { payload } = await jwtVerify(token, jwks, {
|
|
115
|
+
issuer: this.config.issuer,
|
|
116
|
+
audience: this._anyTokenAudience(),
|
|
117
|
+
});
|
|
109
118
|
return extractUser(payload, this.config.clientId);
|
|
110
119
|
}
|
|
111
120
|
/**
|
|
@@ -115,10 +124,39 @@ export class OidcClient {
|
|
|
115
124
|
async verifyTokens(idToken, accessToken) {
|
|
116
125
|
const discovery = await this.getDiscovery();
|
|
117
126
|
const jwks = createRemoteJWKSet(new URL(discovery.jwks_uri));
|
|
118
|
-
const { payload: idPayload } = await jwtVerify(idToken, jwks
|
|
119
|
-
|
|
127
|
+
const { payload: idPayload } = await jwtVerify(idToken, jwks, {
|
|
128
|
+
issuer: this.config.issuer,
|
|
129
|
+
// id_token.aud = clientId (+ доп. из конфига).
|
|
130
|
+
audience: this._idTokenAudience(),
|
|
131
|
+
});
|
|
132
|
+
const { payload: accessPayload } = await jwtVerify(accessToken, jwks, {
|
|
133
|
+
issuer: this.config.issuer,
|
|
134
|
+
// Keycloak кладёт в access_token.aud `account`, а клиента — в `azp`;
|
|
135
|
+
// принимаем clientId ИЛИ `account` (+ доп. из конфига), чтобы не ломать
|
|
136
|
+
// валидные токены. `azp` намеренно не форсим (иначе токены realm-клиентов,
|
|
137
|
+
// напр. `synth-cli`, отвергались бы) — issuer и подпись проверяются всегда.
|
|
138
|
+
audience: this._accessTokenAudience(),
|
|
139
|
+
});
|
|
120
140
|
return extractUserFromTokens(idPayload, accessPayload, this.config.clientId);
|
|
121
141
|
}
|
|
142
|
+
/** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
|
|
143
|
+
_idTokenAudience() {
|
|
144
|
+
return [...new Set([this.config.clientId, ...(this.config.audience ?? [])])].filter(Boolean);
|
|
145
|
+
}
|
|
146
|
+
/** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
|
|
147
|
+
_accessTokenAudience() {
|
|
148
|
+
return [
|
|
149
|
+
...new Set([
|
|
150
|
+
this.config.clientId,
|
|
151
|
+
DEFAULT_ACCESS_TOKEN_AUDIENCE,
|
|
152
|
+
...(this.config.audience ?? []),
|
|
153
|
+
]),
|
|
154
|
+
].filter(Boolean);
|
|
155
|
+
}
|
|
156
|
+
/** Допустимые `aud` для bearer-токена неизвестного типа — объединение. */
|
|
157
|
+
_anyTokenAudience() {
|
|
158
|
+
return [...new Set([...this._idTokenAudience(), ...this._accessTokenAudience()])];
|
|
159
|
+
}
|
|
122
160
|
}
|
|
123
161
|
/**
|
|
124
162
|
* Извлечь известные роли из payload токена Keycloak:
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { ProjectGuard, 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`)
|
|
@@ -2,7 +2,7 @@ import { createMiddleware } from 'hono/factory';
|
|
|
2
2
|
import { requireScope, checkProjectAccess } 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`)
|
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;
|
|
@@ -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
|
+
}
|
package/dist/lib/i18n.js
CHANGED
|
@@ -26,7 +26,8 @@ const en = {
|
|
|
26
26
|
'errors.validation.groupsRequired': 'groups is required',
|
|
27
27
|
'errors.validation.expectedFilesArray': 'expected { files: string[] }',
|
|
28
28
|
'errors.validation.claimCodeRequired': 'Confirmation code is required',
|
|
29
|
-
|
|
29
|
+
'errors.validation.invalidUsername': 'Invalid username',
|
|
30
|
+
// ADR-089: приём внешних событий
|
|
30
31
|
'errors.validation.invalidEvent': 'Invalid event payload',
|
|
31
32
|
'errors.validation.invalidBinding': 'Invalid binding payload',
|
|
32
33
|
'errors.notFound.binding': 'Binding not found',
|
|
@@ -36,14 +37,14 @@ const en = {
|
|
|
36
37
|
'errors.validation.invalidEventKey': 'Invalid event API key',
|
|
37
38
|
'errors.validation.invalidEventKeyUpdate': 'Invalid event API key update',
|
|
38
39
|
'errors.notFound.eventKey': 'Event API key not found',
|
|
39
|
-
//
|
|
40
|
+
// ADR-052 (этап I): service-key
|
|
40
41
|
'errors.validation.invalidServiceKey': 'Invalid service key payload',
|
|
41
42
|
'errors.notFound.serviceKey': 'Service key not found',
|
|
42
43
|
'errors.conflict.serviceKeyLabel': 'Service key label is already used',
|
|
43
44
|
'errors.forbidden.scopeRequired': 'Insufficient permissions: required scope is missing',
|
|
44
45
|
'errors.forbidden.projectForbidden': 'Project is not available for this service key',
|
|
45
46
|
'errors.rateLimited.serviceKey': 'Service key rate limit exceeded',
|
|
46
|
-
//
|
|
47
|
+
// ADR-052 (этап II): исходящие webhooks
|
|
47
48
|
'errors.validation.invalidWebhook': 'Invalid webhook subscription payload',
|
|
48
49
|
'errors.notFound.webhook': 'Webhook subscription not found',
|
|
49
50
|
'errors.conflict.webhookLabel': 'Webhook label is already used',
|
|
@@ -62,6 +63,7 @@ const en = {
|
|
|
62
63
|
'errors.faviconFetchError': 'Error fetching favicon',
|
|
63
64
|
'errors.generic': 'Error',
|
|
64
65
|
'errors.rateLimited.eventKey': 'Event API key rate limit exceeded',
|
|
66
|
+
'errors.rateLimited.identityClaim': 'Too many identity confirmation attempts, try again later',
|
|
65
67
|
'errors.unavailable.eventsDisabled': 'External event ingestion is disabled',
|
|
66
68
|
// Auth
|
|
67
69
|
'auth.unauthorized': 'Authentication required',
|
|
@@ -108,7 +110,8 @@ const ru = {
|
|
|
108
110
|
'errors.validation.groupsRequired': 'groups обязательны',
|
|
109
111
|
'errors.validation.expectedFilesArray': 'expected { files: string[] }',
|
|
110
112
|
'errors.validation.claimCodeRequired': 'Укажите код подтверждения',
|
|
111
|
-
|
|
113
|
+
'errors.validation.invalidUsername': 'Некорректное имя пользователя',
|
|
114
|
+
// ADR-089: приём внешних событий
|
|
112
115
|
'errors.validation.invalidEvent': 'Некорректное тело события',
|
|
113
116
|
'errors.validation.invalidBinding': 'Некорректное тело биндинга',
|
|
114
117
|
'errors.notFound.binding': 'Биндинг не найден',
|
|
@@ -118,14 +121,14 @@ const ru = {
|
|
|
118
121
|
'errors.validation.invalidEventKey': 'Неверный API-ключ события',
|
|
119
122
|
'errors.validation.invalidEventKeyUpdate': 'Некорректное тело обновления API-ключа события',
|
|
120
123
|
'errors.notFound.eventKey': 'API-ключ события не найден',
|
|
121
|
-
//
|
|
124
|
+
// ADR-052 (этап I): service-key
|
|
122
125
|
'errors.validation.invalidServiceKey': 'Некорректное тело service-key',
|
|
123
126
|
'errors.notFound.serviceKey': 'Service-key не найден',
|
|
124
127
|
'errors.conflict.serviceKeyLabel': 'Метка service-key уже используется',
|
|
125
128
|
'errors.forbidden.scopeRequired': 'Недостаточно прав: отсутствует требуемый scope',
|
|
126
129
|
'errors.forbidden.projectForbidden': 'Проект недоступен для этого service-key',
|
|
127
130
|
'errors.rateLimited.serviceKey': 'Превышен лимит запросов по service-key',
|
|
128
|
-
//
|
|
131
|
+
// ADR-052 (этап II): исходящие webhooks
|
|
129
132
|
'errors.validation.invalidWebhook': 'Некорректное тело webhook-подписки',
|
|
130
133
|
'errors.notFound.webhook': 'Webhook-подписка не найдена',
|
|
131
134
|
'errors.conflict.webhookLabel': 'Метка webhook уже используется',
|
|
@@ -144,6 +147,7 @@ const ru = {
|
|
|
144
147
|
'errors.faviconFetchError': 'Ошибка получения favicon',
|
|
145
148
|
'errors.generic': 'Ошибка',
|
|
146
149
|
'errors.rateLimited.eventKey': 'Превышен лимит запросов по API-ключу события',
|
|
150
|
+
'errors.rateLimited.identityClaim': 'Слишком много попыток подтверждения идентичности, повторите позже',
|
|
147
151
|
'errors.unavailable.eventsDisabled': 'Приём внешних событий отключён',
|
|
148
152
|
// Auth
|
|
149
153
|
'auth.unauthorized': 'Требуется аутентификация',
|
package/dist/main.js
CHANGED
|
@@ -26,13 +26,13 @@ async function gracefulShutdown(signal) {
|
|
|
26
26
|
console.log('[Shutdown] WebSocket-сервер остановлен');
|
|
27
27
|
queueManager.stopAll();
|
|
28
28
|
console.log('[Shutdown] Очередь остановлена');
|
|
29
|
-
//
|
|
29
|
+
// ADR-089: остановить авто-архивацию ephemeral-сессий.
|
|
30
30
|
stopEphemeralSweeper();
|
|
31
|
-
//
|
|
31
|
+
// ADR-089: остановить retention-очистку журнала событий.
|
|
32
32
|
stopEventJournalPruner();
|
|
33
|
-
//
|
|
33
|
+
// ADR-051 (срез): остановить планировщик расписаний.
|
|
34
34
|
stopScheduler();
|
|
35
|
-
//
|
|
35
|
+
// ADR-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
|
|
36
36
|
stopWebhookService();
|
|
37
37
|
stopWebhookDeliveryPruner();
|
|
38
38
|
const drainTimeout = 10_000;
|
|
@@ -1,8 +1,11 @@
|
|
|
1
|
+
import type { Context } from 'hono';
|
|
1
2
|
/**
|
|
2
3
|
* In-memory rate limiter.
|
|
3
4
|
* Ключ — Authorization header (уникален для каждого пользователя/ключа).
|
|
5
|
+
* `message` — опциональный резолвер локализованного текста (i18n); по умолчанию —
|
|
6
|
+
* общий русский текст (обратная совместимость).
|
|
4
7
|
*/
|
|
5
|
-
export declare function createRateLimiter(maxRequests?: number, windowMs?: number): import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
|
|
8
|
+
export declare function createRateLimiter(maxRequests?: number, windowMs?: number, message?: (c: Context) => string): import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
|
|
6
9
|
error: {
|
|
7
10
|
code: string;
|
|
8
11
|
message: string;
|
|
@@ -2,8 +2,10 @@ import { createMiddleware } from 'hono/factory';
|
|
|
2
2
|
/**
|
|
3
3
|
* In-memory rate limiter.
|
|
4
4
|
* Ключ — Authorization header (уникален для каждого пользователя/ключа).
|
|
5
|
+
* `message` — опциональный резолвер локализованного текста (i18n); по умолчанию —
|
|
6
|
+
* общий русский текст (обратная совместимость).
|
|
5
7
|
*/
|
|
6
|
-
export function createRateLimiter(maxRequests = 20, windowMs = 60_000) {
|
|
8
|
+
export function createRateLimiter(maxRequests = 20, windowMs = 60_000, message) {
|
|
7
9
|
const hits = new Map();
|
|
8
10
|
setInterval(() => {
|
|
9
11
|
const now = Date.now();
|
|
@@ -24,7 +26,7 @@ export function createRateLimiter(maxRequests = 20, windowMs = 60_000) {
|
|
|
24
26
|
}
|
|
25
27
|
entry.count += 1;
|
|
26
28
|
if (entry.count > maxRequests) {
|
|
27
|
-
return c.json({ error: { code: 'RATE_LIMITED', message: 'Превышен лимит запросов' } }, 429);
|
|
29
|
+
return c.json({ error: { code: 'RATE_LIMITED', message: message ? message(c) : 'Превышен лимит запросов' } }, 429);
|
|
28
30
|
}
|
|
29
31
|
await next();
|
|
30
32
|
});
|
package/dist/routes/audit.d.ts
CHANGED
|
@@ -10,7 +10,7 @@ export interface AuditRoutesDeps {
|
|
|
10
10
|
logger: AuditLogger;
|
|
11
11
|
}
|
|
12
12
|
/**
|
|
13
|
-
* GET /api/v2/audit — просмотр аудита LLM Gateway (
|
|
13
|
+
* GET /api/v2/audit — просмотр аудита LLM Gateway (ADR-036).
|
|
14
14
|
* RBAC: только ADMIN/AUDITOR.
|
|
15
15
|
* Фильтры: userId, sessionId, since/until (ISO), limit (дефолт 100, макс 500).
|
|
16
16
|
*/
|
package/dist/routes/audit.js
CHANGED
|
@@ -9,7 +9,7 @@ function toInt(value, fallback) {
|
|
|
9
9
|
return Number.isFinite(n) ? n : fallback;
|
|
10
10
|
}
|
|
11
11
|
/**
|
|
12
|
-
* GET /api/v2/audit — просмотр аудита LLM Gateway (
|
|
12
|
+
* GET /api/v2/audit — просмотр аудита LLM Gateway (ADR-036).
|
|
13
13
|
* RBAC: только ADMIN/AUDITOR.
|
|
14
14
|
* Фильтры: userId, sessionId, since/until (ISO), limit (дефолт 100, макс 500).
|
|
15
15
|
*/
|
|
@@ -28,7 +28,7 @@ export function createAuditRoutes(kit, deps) {
|
|
|
28
28
|
return c.json({ entries, total });
|
|
29
29
|
});
|
|
30
30
|
/**
|
|
31
|
-
* POST /api/v2/audit/revealed — логирование раскрытия плейсхолдера (
|
|
31
|
+
* POST /api/v2/audit/revealed — логирование раскрытия плейсхолдера (ADR-036).
|
|
32
32
|
* RBAC: любой авторизованный (клик по бейджу SecretPlaceholder делает
|
|
33
33
|
* пользователь сессии), userId фиксируется из токена.
|
|
34
34
|
* Тело: { sessionId, placeholder } (placeholder вида ⟦SYNTH_SECRET_N⟧).
|
package/dist/routes/auth.js
CHANGED
|
@@ -5,7 +5,7 @@ import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
|
|
|
5
5
|
import { t } from '../lib/i18n.js';
|
|
6
6
|
import { getDefaultLang, setDefaultLang } from '../lib/i18n-config.js';
|
|
7
7
|
import { readFile, writeFile, unlink } from 'node:fs/promises';
|
|
8
|
-
import { join } from 'node:path';
|
|
8
|
+
import { join, resolve, sep } from 'node:path';
|
|
9
9
|
const OIDC_STATE_COOKIE = 'oidc_state';
|
|
10
10
|
// Встроенные умолчания оформления (совпадают с тем, что использует UI
|
|
11
11
|
// по умолчанию: packages/ui/src/lib/defaults.ts + uiScale.ts).
|
|
@@ -18,6 +18,24 @@ const BUILT_IN_DEFAULTS = {
|
|
|
18
18
|
export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore) {
|
|
19
19
|
const app = new Hono();
|
|
20
20
|
const avatarsDir = dataDir ? join(dataDir, 'auth', 'avatars') : null;
|
|
21
|
+
// Корень каталога аватаров (абсолютный) — для containment-проверки.
|
|
22
|
+
const avatarsRoot = avatarsDir ? resolve(avatarsDir) : null;
|
|
23
|
+
/**
|
|
24
|
+
* Безопасный абсолютный путь к файлу аватара по `username`.
|
|
25
|
+
* Отклоняет пустое имя, разделители пути (`/`, `\`) и `.`/`..` (traversal),
|
|
26
|
+
* а также результат вне каталога аватаров (defense-in-depth). `null` — отказ.
|
|
27
|
+
*/
|
|
28
|
+
const resolveAvatarPath = (username) => {
|
|
29
|
+
if (!avatarsRoot)
|
|
30
|
+
return null;
|
|
31
|
+
const name = username.trim();
|
|
32
|
+
if (!name || name === '.' || name === '..')
|
|
33
|
+
return null;
|
|
34
|
+
if (/[/\\\0]/.test(name))
|
|
35
|
+
return null;
|
|
36
|
+
const full = resolve(avatarsRoot, `${name}.png`);
|
|
37
|
+
return full.startsWith(avatarsRoot + sep) ? full : null;
|
|
38
|
+
};
|
|
21
39
|
// Сохранённые умолчания перекрывают встроенные; uiScaleMobile/uiScaleDesktop: null — умолчание не задано.
|
|
22
40
|
const resolveDefaults = async () => {
|
|
23
41
|
const stored = defaultsStore ? await defaultsStore.loadDefaults() : {};
|
|
@@ -387,7 +405,10 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
|
|
|
387
405
|
return c.json({ error: { code: 'UNAUTHORIZED' } }, 401);
|
|
388
406
|
if (!avatarsDir)
|
|
389
407
|
return c.body(null, 404);
|
|
390
|
-
const avatarPath =
|
|
408
|
+
const avatarPath = resolveAvatarPath(user.username);
|
|
409
|
+
if (!avatarPath) {
|
|
410
|
+
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUsername', undefined, c) } }, 400);
|
|
411
|
+
}
|
|
391
412
|
try {
|
|
392
413
|
const data = await readFile(avatarPath);
|
|
393
414
|
return new Response(data, {
|
|
@@ -405,11 +426,15 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
|
|
|
405
426
|
return c.json({ error: { code: 'UNAUTHORIZED' } }, 401);
|
|
406
427
|
if (!avatarsDir)
|
|
407
428
|
return c.json({ error: { code: 'INTERNAL_ERROR' } }, 500);
|
|
429
|
+
const avatarPath = resolveAvatarPath(user.username);
|
|
430
|
+
if (!avatarPath) {
|
|
431
|
+
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUsername', undefined, c) } }, 400);
|
|
432
|
+
}
|
|
408
433
|
try {
|
|
409
434
|
const buffer = await c.req.arrayBuffer();
|
|
410
435
|
if (buffer.byteLength === 0) {
|
|
411
436
|
// Удаление аватара
|
|
412
|
-
await unlink(
|
|
437
|
+
await unlink(avatarPath).catch(() => { });
|
|
413
438
|
if (profiles) {
|
|
414
439
|
const profile = await profiles.getOrCreateProfile({ username: user.username, roles: user.roles });
|
|
415
440
|
const prefs = { ...(profile.preferences || {}), avatar: '' };
|
|
@@ -418,7 +443,6 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
|
|
|
418
443
|
}
|
|
419
444
|
return c.json({ status: 'ok' });
|
|
420
445
|
}
|
|
421
|
-
const avatarPath = join(avatarsDir, `${user.username}.png`);
|
|
422
446
|
await writeFile(avatarPath, Buffer.from(buffer));
|
|
423
447
|
if (profiles) {
|
|
424
448
|
const profile = await profiles.getOrCreateProfile({ username: user.username, roles: user.roles });
|
|
@@ -2,7 +2,7 @@ import { Hono } from 'hono';
|
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { SecretPatternStore } from '@itphx/synth-core';
|
|
4
4
|
/**
|
|
5
|
-
* LLM Gateway (
|
|
5
|
+
* LLM Gateway (ADR-036) — управление regex-паттернами детекции секретов.
|
|
6
6
|
* Схема «системный + override»: пользовательский список полностью заменяет дефолтный,
|
|
7
7
|
* DELETE сбрасывает к встроенным паттернам. Только ADMIN.
|
|
8
8
|
*/
|
|
@@ -16,7 +16,7 @@ function isValidPattern(p) {
|
|
|
16
16
|
}
|
|
17
17
|
}
|
|
18
18
|
/**
|
|
19
|
-
* LLM Gateway (
|
|
19
|
+
* LLM Gateway (ADR-036) — управление regex-паттернами детекции секретов.
|
|
20
20
|
* Схема «системный + override»: пользовательский список полностью заменяет дефолтный,
|
|
21
21
|
* DELETE сбрасывает к встроенным паттернам. Только ADMIN.
|
|
22
22
|
*/
|
package/dist/routes/llm.js
CHANGED
|
@@ -5,7 +5,7 @@ import { ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, Provid
|
|
|
5
5
|
/**
|
|
6
6
|
* LLM Proxy endpoint (гибридный режим, Часть 5).
|
|
7
7
|
* OpenAI-совместимый POST /api/v2/llm/chat/completions, через который локальный
|
|
8
|
-
* core гоняет LLM-запросы централизованно — с применением LLM Gateway (
|
|
8
|
+
* core гоняет LLM-запросы централизованно — с применением LLM Gateway (ADR-036):
|
|
9
9
|
* обфускация/блокировка секретов, rate limit, аудит, полный payload-лог.
|
|
10
10
|
*/
|
|
11
11
|
/**
|
|
@@ -30,7 +30,7 @@ const chatCompletionsSchema = z.object({
|
|
|
30
30
|
max_tokens: z.number().int().positive().optional(),
|
|
31
31
|
top_p: z.number().optional(),
|
|
32
32
|
stream: z.boolean().optional(),
|
|
33
|
-
//
|
|
33
|
+
// ADR-070: remote-зеркала (RemoteProvider) просят usage в стриме. Внутренний
|
|
34
34
|
// OpenAIProvider всегда шлёт stream_options.include_usage, но поле принимаем
|
|
35
35
|
// явно, чтобы Zod его не срезал (контракт запроса).
|
|
36
36
|
stream_options: z.object({ include_usage: z.boolean().optional() }).optional(),
|
|
@@ -100,7 +100,7 @@ function toLlmMessages(raw) {
|
|
|
100
100
|
}
|
|
101
101
|
export function createLlmRoutes(kit, deps) {
|
|
102
102
|
const app = new Hono();
|
|
103
|
-
//
|
|
103
|
+
// ADR-052: `llm:chat` — scope service-key; обычные креды scope не ограничивают.
|
|
104
104
|
const middlewares = [scopeGuard('llm:chat'), ...(deps.rateLimiter ? [deps.rateLimiter] : [])];
|
|
105
105
|
// POST /api/v2/llm/chat/completions — OpenAI-совместимый LLM Proxy
|
|
106
106
|
app.post('/chat/completions', kit.requireAuth, ...middlewares, async (c) => {
|
|
@@ -166,6 +166,7 @@ export function createLlmRoutes(kit, deps) {
|
|
|
166
166
|
model: modelConfig.name,
|
|
167
167
|
timeout: providerConfig.timeout ?? 120,
|
|
168
168
|
maxTokens: body.max_tokens,
|
|
169
|
+
numCtx: providerConfig.numCtx,
|
|
169
170
|
}, body.temperature, body.top_p);
|
|
170
171
|
}
|
|
171
172
|
catch (e) {
|
|
@@ -176,7 +177,7 @@ export function createLlmRoutes(kit, deps) {
|
|
|
176
177
|
},
|
|
177
178
|
}, 502);
|
|
178
179
|
}
|
|
179
|
-
// 3.
|
|
180
|
+
// 3. ADR-036: оборачиваем провайдер в GatewayProvider.
|
|
180
181
|
// У локального core нет карты обфускации, поэтому для прокси держим
|
|
181
182
|
// transient-карту на время запроса: getMap/saveMap читают/пишут её, а после
|
|
182
183
|
// ответа деобфусцируем контент по той же карте (иначе клиент увидел бы
|
|
@@ -3,12 +3,12 @@ import type { AuthKit } from '../auth/middleware.js';
|
|
|
3
3
|
import type { SessionManager, McpManager, McpRegistryStore } from '@itphx/synth-core';
|
|
4
4
|
import type { McpNetworkPolicy } from '@itphx/synth-shared';
|
|
5
5
|
export interface McpRoutesOptions {
|
|
6
|
-
/**
|
|
6
|
+
/** ADR-071 §2.5: единый реестр MCP-серверов (источник истины для `/servers` и `/registry`). */
|
|
7
7
|
registry: McpRegistryStore;
|
|
8
|
-
/**
|
|
8
|
+
/** ADR-071 §2.3.1: политика сетевого доступа HTTP-серверов. */
|
|
9
9
|
networkPolicy?: McpNetworkPolicy;
|
|
10
10
|
/**
|
|
11
|
-
*
|
|
11
|
+
* ADR-071 §2.3.1: динамический источник политики (runtime-настройка из админки).
|
|
12
12
|
* Приоритетнее статической `networkPolicy`; читается на каждый запрос.
|
|
13
13
|
*/
|
|
14
14
|
getNetworkPolicy?: () => McpNetworkPolicy | undefined;
|