@itphx/synth-backend 0.9.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 +29 -3
- package/dist/app.js +110 -900
- package/dist/auth/guards.d.ts +20 -0
- package/dist/auth/guards.js +65 -0
- package/dist/auth/middleware.d.ts +20 -1
- package/dist/auth/middleware.js +53 -1
- package/dist/auth/oidc.d.ts +15 -0
- package/dist/auth/oidc.js +41 -3
- package/dist/auth/service-scope.d.ts +14 -0
- package/dist/auth/service-scope.js +40 -0
- package/dist/events/hub.d.ts +9 -0
- package/dist/events/hub.js +29 -0
- package/dist/lib/cors.d.ts +23 -0
- package/dist/lib/cors.js +24 -0
- package/dist/lib/i18n.js +64 -0
- package/dist/main.js +10 -1
- 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 +35 -5
- package/dist/routes/gateway-patterns.d.ts +1 -1
- package/dist/routes/gateway-patterns.js +1 -1
- package/dist/routes/llm.js +7 -4
- package/dist/routes/mcp-registry.d.ts +3 -3
- package/dist/routes/mcp-registry.js +40 -17
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.js +1 -1
- package/dist/routes/projects.d.ts +7 -4
- package/dist/routes/projects.js +17 -7
- package/dist/routes/providers.js +1 -0
- package/dist/routes/sessions.d.ts +7 -1
- package/dist/routes/sessions.js +119 -8
- package/dist/routes/users.js +17 -4
- package/package.json +4 -4
- package/dist/agents/definitions/admin.json +0 -24
- package/dist/agents/definitions/analyst.json +0 -20
- package/dist/agents/definitions/assistant.json +0 -25
- package/dist/agents/definitions/auditor.json +0 -19
- package/dist/agents/definitions/developer.json +0 -23
- package/dist/agents/definitions/devops.json +0 -23
- package/dist/agents/definitions/explore.json +0 -15
- package/dist/agents/definitions/general.json +0 -15
- package/dist/agents/definitions/pm.json +0 -20
- package/dist/agents/definitions/qa.json +0 -22
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Guard «ADMIN **или** scope»:
|
|
3
|
+
* - запрос с service-key → требуется хотя бы один из `scopes`
|
|
4
|
+
* (`403 SCOPE_REQUIRED` иначе);
|
|
5
|
+
* - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
|
|
6
|
+
* роль ADMIN (`403 FORBIDDEN` иначе) — прежнее поведение этих роутов.
|
|
7
|
+
*
|
|
8
|
+
* Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
|
|
9
|
+
* контексте). Используется на мутациях реестра MCP (`/servers*`), записи
|
|
10
|
+
* скиллов и чтении пользователей.
|
|
11
|
+
*/
|
|
12
|
+
export declare function requireAdminOrScope(...scopes: string[]): import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
13
|
+
/**
|
|
14
|
+
* Guard «service-key → scope»: для service-key требует хотя бы один из `scopes`;
|
|
15
|
+
* интерактивные креды пропускает без изменений (их гейтит `requireAuth`/логика
|
|
16
|
+
* роута). Нужен там, где интерактивный доступ **не** ограничен ADMIN — например,
|
|
17
|
+
* `POST /api/v2/mcp/registry` (любой пользователь добавляет свой HTTP-сервер,
|
|
18
|
+
* stdio — только ADMIN в теле роута).
|
|
19
|
+
*/
|
|
20
|
+
export declare function requireScopeForServiceKey(...scopes: string[]): import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { createMiddleware } from 'hono/factory';
|
|
2
|
+
import { getServiceCredential } from '@itphx/synth-core';
|
|
3
|
+
import { hasServiceScope } from '@itphx/synth-shared';
|
|
4
|
+
import { t } from '../lib/i18n.js';
|
|
5
|
+
/**
|
|
6
|
+
* ADR-052/O1: комбинированные guard'ы «ADMIN **или** scope» для эндпоинтов,
|
|
7
|
+
* которые должны быть доступны и человеку-ADMIN, и installer-service-key'ю.
|
|
8
|
+
*
|
|
9
|
+
* `requireScope` (core) — no-op для интерактивных кред, поэтому одиночного
|
|
10
|
+
* scope-гейта недостаточно: нужно «если service-key → требуем scope; иначе —
|
|
11
|
+
* прежнее поведение (ADMIN)». Здесь и живёт эта развилка; enforcement scopes —
|
|
12
|
+
* `hasServiceScope` (shared), чтение контекста — `getServiceCredential` (core).
|
|
13
|
+
*/
|
|
14
|
+
/** 403 SCOPE_REQUIRED (i18n backend) — service-key без нужного scope. */
|
|
15
|
+
function scopeDenied(c) {
|
|
16
|
+
return c.json({ error: { code: 'SCOPE_REQUIRED', message: t('errors.forbidden.scopeRequired', undefined, c) } }, 403);
|
|
17
|
+
}
|
|
18
|
+
/** `true`, если в контексте ADMIN (роли synthetic service-пользователя или человека). */
|
|
19
|
+
function isAdmin(c) {
|
|
20
|
+
const user = c.get('user');
|
|
21
|
+
return !!user && Array.isArray(user.roles) && user.roles.includes('ADMIN');
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Guard «ADMIN **или** scope»:
|
|
25
|
+
* - запрос с service-key → требуется хотя бы один из `scopes`
|
|
26
|
+
* (`403 SCOPE_REQUIRED` иначе);
|
|
27
|
+
* - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
|
|
28
|
+
* роль ADMIN (`403 FORBIDDEN` иначе) — прежнее поведение этих роутов.
|
|
29
|
+
*
|
|
30
|
+
* Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
|
|
31
|
+
* контексте). Используется на мутациях реестра MCP (`/servers*`), записи
|
|
32
|
+
* скиллов и чтении пользователей.
|
|
33
|
+
*/
|
|
34
|
+
export function requireAdminOrScope(...scopes) {
|
|
35
|
+
return createMiddleware(async (c, next) => {
|
|
36
|
+
const cred = getServiceCredential(c);
|
|
37
|
+
if (cred) {
|
|
38
|
+
if (!scopes.some((scope) => hasServiceScope(cred.scopes, scope))) {
|
|
39
|
+
return scopeDenied(c);
|
|
40
|
+
}
|
|
41
|
+
await next();
|
|
42
|
+
return;
|
|
43
|
+
}
|
|
44
|
+
if (!isAdmin(c)) {
|
|
45
|
+
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
46
|
+
}
|
|
47
|
+
await next();
|
|
48
|
+
});
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Guard «service-key → scope»: для service-key требует хотя бы один из `scopes`;
|
|
52
|
+
* интерактивные креды пропускает без изменений (их гейтит `requireAuth`/логика
|
|
53
|
+
* роута). Нужен там, где интерактивный доступ **не** ограничен ADMIN — например,
|
|
54
|
+
* `POST /api/v2/mcp/registry` (любой пользователь добавляет свой HTTP-сервер,
|
|
55
|
+
* stdio — только ADMIN в теле роута).
|
|
56
|
+
*/
|
|
57
|
+
export function requireScopeForServiceKey(...scopes) {
|
|
58
|
+
return createMiddleware(async (c, next) => {
|
|
59
|
+
const cred = getServiceCredential(c);
|
|
60
|
+
if (cred && !scopes.some((scope) => hasServiceScope(cred.scopes, scope))) {
|
|
61
|
+
return scopeDenied(c);
|
|
62
|
+
}
|
|
63
|
+
await next();
|
|
64
|
+
});
|
|
65
|
+
}
|
|
@@ -1,6 +1,25 @@
|
|
|
1
1
|
import type { AuthConfig, User } from '@itphx/synth-shared';
|
|
2
|
+
import type { ServiceKeyCredential } from '@itphx/synth-core';
|
|
2
3
|
import { setCookie, deleteCookie } from 'hono/cookie';
|
|
3
|
-
|
|
4
|
+
/**
|
|
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_…`) → синтетический
|
|
11
|
+
* пользователь (RBAC) + контекст (`scopes`/`allowedProjects`/лимит).
|
|
12
|
+
* `null` — секрет неизвестен/отозван/истёк либо резолвер не настроен.
|
|
13
|
+
*/
|
|
14
|
+
export type ServiceKeyResolver = (rawSecret: string) => Promise<{
|
|
15
|
+
user: User;
|
|
16
|
+
credential: ServiceKeyCredential;
|
|
17
|
+
} | null>;
|
|
18
|
+
/** Конфиг backend-auth: `AuthConfig` + service-key (ADR-052). */
|
|
19
|
+
export interface AuthMiddlewareConfig extends AuthConfig {
|
|
20
|
+
resolveServiceKey?: ServiceKeyResolver;
|
|
21
|
+
}
|
|
22
|
+
export declare function createAuthMiddleware(config: AuthMiddlewareConfig): {
|
|
4
23
|
getCurrentUser: (c: {
|
|
5
24
|
req: {
|
|
6
25
|
header(name: string): string | undefined;
|
package/dist/auth/middleware.js
CHANGED
|
@@ -1,8 +1,16 @@
|
|
|
1
|
+
import { isServiceKeySecret } from '@itphx/synth-core';
|
|
1
2
|
import { createMiddleware } from 'hono/factory';
|
|
2
3
|
import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
|
|
3
4
|
import { t } from '../lib/i18n.js';
|
|
4
5
|
import { createLazyOidcClient } from './oidc.js';
|
|
5
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
|
+
}
|
|
6
14
|
// In-memory хранилище сессий (для debug mode)
|
|
7
15
|
const sessions = new Map();
|
|
8
16
|
// Очистка истёкших сессий каждые 5 минут
|
|
@@ -24,8 +32,32 @@ function extractBearerToken(h) {
|
|
|
24
32
|
export function createAuthMiddleware(config) {
|
|
25
33
|
// Ленивый OIDC-клиент (мемоизация, безопасно при отсутствии oidc — null)
|
|
26
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
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* ADR-052: машинная аутентификация по service-key. Распознаётся по префиксу
|
|
44
|
+
* секрета `synth_svc_`; резолвер асинхронный (стор + touch `lastUsedAt`),
|
|
45
|
+
* поэтому ветка живёт в middleware, а не в синхронном `getCurrentUser`.
|
|
46
|
+
*/
|
|
47
|
+
const resolveServiceKey = async (c) => {
|
|
48
|
+
if (!config.resolveServiceKey)
|
|
49
|
+
return null;
|
|
50
|
+
const token = extractBearerToken(c.req.header('Authorization'));
|
|
51
|
+
if (!token || !isServiceKeySecret(token))
|
|
52
|
+
return null;
|
|
53
|
+
return config.resolveServiceKey(token);
|
|
54
|
+
};
|
|
27
55
|
// Определить пользователя из запроса
|
|
28
56
|
const getCurrentUser = async (c) => {
|
|
57
|
+
// 0. ADR-052: service-key — синтетический пользователь ключа.
|
|
58
|
+
const serviceAuth = await resolveServiceKey(c);
|
|
59
|
+
if (serviceAuth)
|
|
60
|
+
return serviceAuth.user;
|
|
29
61
|
// 1. Cookie-сессия
|
|
30
62
|
const sessionId = typeof getCookie === 'function'
|
|
31
63
|
? getCookie(c, SESSION_COOKIE)
|
|
@@ -102,6 +134,14 @@ export function createAuthMiddleware(config) {
|
|
|
102
134
|
};
|
|
103
135
|
// Middleware: прикрепить пользователя к контексту (без ошибки)
|
|
104
136
|
const attachUser = createMiddleware(async (c, next) => {
|
|
137
|
+
// ADR-052: service-key несёт и пользователя, и контекст (scopes/проекция).
|
|
138
|
+
const serviceAuth = await resolveServiceKey(c);
|
|
139
|
+
if (serviceAuth) {
|
|
140
|
+
c.set('user', serviceAuth.user);
|
|
141
|
+
c.set('serviceKey', serviceAuth.credential);
|
|
142
|
+
await next();
|
|
143
|
+
return;
|
|
144
|
+
}
|
|
105
145
|
const user = await getCurrentUser(c);
|
|
106
146
|
if (user)
|
|
107
147
|
c.set('user', user);
|
|
@@ -109,6 +149,18 @@ export function createAuthMiddleware(config) {
|
|
|
109
149
|
});
|
|
110
150
|
// Middleware: требовать аутентификации
|
|
111
151
|
const requireAuth = createMiddleware(async (c, next) => {
|
|
152
|
+
// attachUser уже мог установить пользователя (в т.ч. service-key).
|
|
153
|
+
if (c.get('user')) {
|
|
154
|
+
await next();
|
|
155
|
+
return;
|
|
156
|
+
}
|
|
157
|
+
const serviceAuth = await resolveServiceKey(c);
|
|
158
|
+
if (serviceAuth) {
|
|
159
|
+
c.set('user', serviceAuth.user);
|
|
160
|
+
c.set('serviceKey', serviceAuth.credential);
|
|
161
|
+
await next();
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
112
164
|
const user = await getCurrentUser(c);
|
|
113
165
|
if (!user) {
|
|
114
166
|
return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
|
|
@@ -166,7 +218,7 @@ export function createAuthMiddleware(config) {
|
|
|
166
218
|
setCookie(c, SESSION_COOKIE, sessionId, {
|
|
167
219
|
path: '/',
|
|
168
220
|
httpOnly: true,
|
|
169
|
-
secure:
|
|
221
|
+
secure: cookieSecure,
|
|
170
222
|
sameSite: 'Lax',
|
|
171
223
|
maxAge: config.sessionMaxAgeMinutes * 60,
|
|
172
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:
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
|
|
2
|
+
/**
|
|
3
|
+
* ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
|
|
4
|
+
*
|
|
5
|
+
* Enforcement (`hasServiceScope`/`isProjectAllowed`) остаётся в core —
|
|
6
|
+
* здесь только локализация отказов (`SCOPE_REQUIRED`/`PROJECT_FORBIDDEN`)
|
|
7
|
+
* через backend-i18n. Для интерактивных кред (нет `serviceKey` в контексте)
|
|
8
|
+
* оба гейта пропускают запрос, поэтому managed-поведение без service-key
|
|
9
|
+
* не меняется.
|
|
10
|
+
*/
|
|
11
|
+
/** Scope-гейт: делегирует проверку core-`requireScope`, переводит 403 на i18n. */
|
|
12
|
+
export declare const scopeGuard: ScopeGuardFactory;
|
|
13
|
+
/** Гейт проектной проекции: делегирует core-`checkProjectAccess`, переводит 403. */
|
|
14
|
+
export declare const projectGuard: ProjectGuard;
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { createMiddleware } from 'hono/factory';
|
|
2
|
+
import { requireScope, checkProjectAccess } from '@itphx/synth-core';
|
|
3
|
+
import { t } from '../lib/i18n.js';
|
|
4
|
+
/**
|
|
5
|
+
* ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
|
|
6
|
+
*
|
|
7
|
+
* Enforcement (`hasServiceScope`/`isProjectAllowed`) остаётся в core —
|
|
8
|
+
* здесь только локализация отказов (`SCOPE_REQUIRED`/`PROJECT_FORBIDDEN`)
|
|
9
|
+
* через backend-i18n. Для интерактивных кред (нет `serviceKey` в контексте)
|
|
10
|
+
* оба гейта пропускают запрос, поэтому managed-поведение без service-key
|
|
11
|
+
* не меняется.
|
|
12
|
+
*/
|
|
13
|
+
/** Scope-гейт: делегирует проверку core-`requireScope`, переводит 403 на i18n. */
|
|
14
|
+
export const scopeGuard = (...required) => {
|
|
15
|
+
const guard = requireScope(...required);
|
|
16
|
+
return createMiddleware(async (c, next) => {
|
|
17
|
+
const denied = await guard(c, async () => { });
|
|
18
|
+
if (denied) {
|
|
19
|
+
return c.json({
|
|
20
|
+
error: {
|
|
21
|
+
code: 'SCOPE_REQUIRED',
|
|
22
|
+
message: t('errors.forbidden.scopeRequired', undefined, c),
|
|
23
|
+
},
|
|
24
|
+
}, 403);
|
|
25
|
+
}
|
|
26
|
+
await next();
|
|
27
|
+
});
|
|
28
|
+
};
|
|
29
|
+
/** Гейт проектной проекции: делегирует core-`checkProjectAccess`, переводит 403. */
|
|
30
|
+
export const projectGuard = (c, projectId) => {
|
|
31
|
+
const denied = checkProjectAccess(c, projectId);
|
|
32
|
+
if (!denied)
|
|
33
|
+
return undefined;
|
|
34
|
+
return c.json({
|
|
35
|
+
error: {
|
|
36
|
+
code: 'PROJECT_FORBIDDEN',
|
|
37
|
+
message: t('errors.forbidden.projectForbidden', undefined, c),
|
|
38
|
+
},
|
|
39
|
+
}, 403);
|
|
40
|
+
};
|
package/dist/events/hub.d.ts
CHANGED
|
@@ -4,6 +4,13 @@ import type { SessionManager } from '@itphx/synth-core';
|
|
|
4
4
|
export interface EventClient {
|
|
5
5
|
userId: string;
|
|
6
6
|
username: string;
|
|
7
|
+
/**
|
|
8
|
+
* Watch-all: клиент получает события ВСЕХ сессий через глобальный поток
|
|
9
|
+
* `eventBus.subscribeAll`, а не только сессии владельца `userId`.
|
|
10
|
+
* Используется машинными watcher'ами (service-key, ADR-052 этап IV) и ролями
|
|
11
|
+
* сквозного обзора ADMIN/LEAD (ADR-089) — паритет со standalone-core SSE.
|
|
12
|
+
*/
|
|
13
|
+
allSessions?: boolean;
|
|
7
14
|
send(event: BusEvent): void;
|
|
8
15
|
}
|
|
9
16
|
/**
|
|
@@ -22,6 +29,8 @@ export declare class EventHub {
|
|
|
22
29
|
shutdown(): void;
|
|
23
30
|
subscribeToSession(userId: string, sessionId: string): Promise<void>;
|
|
24
31
|
unsubscribeFromSession(userId: string, sessionId: string): void;
|
|
32
|
+
/** Глобальная подписка all-клиента: события всех сессий без привязки к владельцу. */
|
|
33
|
+
private _subscribeClientToAll;
|
|
25
34
|
private _subscribeClientToSession;
|
|
26
35
|
private _unsubscribeClientFromAll;
|
|
27
36
|
}
|
package/dist/events/hub.js
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
/** Служебный ключ глобальной подписки all-клиента в `clientSubs`. */
|
|
2
|
+
const ALL_SESSIONS_KEY = '*';
|
|
1
3
|
/** Безопасное чтение непустой строки из `unknown`. */
|
|
2
4
|
function readString(value) {
|
|
3
5
|
return typeof value === 'string' && value.length > 0 ? value : undefined;
|
|
@@ -54,6 +56,14 @@ export class EventHub {
|
|
|
54
56
|
arr.push(client);
|
|
55
57
|
this.clients.set(client.userId, arr);
|
|
56
58
|
this.clientSubs.set(client, new Map());
|
|
59
|
+
// Watch-all (service-key watcher / ADMIN/LEAD): глобальная подписка на все
|
|
60
|
+
// события шины. Per-session подписок нет — владельца сессий у машинного
|
|
61
|
+
// аккаунта нет, а обзорные роли видят чужие сессии; дубли не нужны.
|
|
62
|
+
if (client.allSessions) {
|
|
63
|
+
this._subscribeClientToAll(client);
|
|
64
|
+
console.log(`[EventHub] Register client (all sessions): user=${client.username} clients=${arr.length}`);
|
|
65
|
+
return;
|
|
66
|
+
}
|
|
57
67
|
const sessions = await this.sessionManager.listSessions({ userId: client.userId });
|
|
58
68
|
console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
|
|
59
69
|
for (const s of sessions) {
|
|
@@ -110,7 +120,26 @@ export class EventHub {
|
|
|
110
120
|
}
|
|
111
121
|
console.debug(`[EventHub] Unsubscribe session: session=${sessionId}`);
|
|
112
122
|
}
|
|
123
|
+
/** Глобальная подписка all-клиента: события всех сессий без привязки к владельцу. */
|
|
124
|
+
_subscribeClientToAll(client) {
|
|
125
|
+
const subs = this.clientSubs.get(client);
|
|
126
|
+
if (!subs || subs.has(ALL_SESSIONS_KEY))
|
|
127
|
+
return;
|
|
128
|
+
const unsub = this.eventBus.subscribeAll((event) => {
|
|
129
|
+
try {
|
|
130
|
+
client.send(event);
|
|
131
|
+
}
|
|
132
|
+
catch {
|
|
133
|
+
// ignore send errors
|
|
134
|
+
}
|
|
135
|
+
});
|
|
136
|
+
subs.set(ALL_SESSIONS_KEY, unsub);
|
|
137
|
+
}
|
|
113
138
|
_subscribeClientToSession(client, sessionId) {
|
|
139
|
+
// all-клиент покрыт глобальной подпиской — per-session подписки не нужны
|
|
140
|
+
// (иначе дубли доставки).
|
|
141
|
+
if (client.allSessions)
|
|
142
|
+
return;
|
|
114
143
|
const subs = this.clientSubs.get(client);
|
|
115
144
|
if (!subs)
|
|
116
145
|
return;
|
|
@@ -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
|
@@ -12,6 +12,8 @@ const en = {
|
|
|
12
12
|
'errors.notFound.favicon': 'Favicon not found',
|
|
13
13
|
'errors.notFound.route': 'Not found: {method} {path}',
|
|
14
14
|
'errors.notFound.agentOverride': 'Override not found',
|
|
15
|
+
'errors.notFound.identity': 'Linked identity not found',
|
|
16
|
+
'errors.notFound.identityClaim': 'Confirmation code is invalid (unknown, expired, or already used)',
|
|
15
17
|
// Validation errors
|
|
16
18
|
'errors.validation.contentRequired': 'content is required',
|
|
17
19
|
'errors.validation.nameRequired': 'name is required',
|
|
@@ -23,16 +25,46 @@ const en = {
|
|
|
23
25
|
'errors.validation.usernameRequired': 'username is required',
|
|
24
26
|
'errors.validation.groupsRequired': 'groups is required',
|
|
25
27
|
'errors.validation.expectedFilesArray': 'expected { files: string[] }',
|
|
28
|
+
'errors.validation.claimCodeRequired': 'Confirmation code is required',
|
|
29
|
+
'errors.validation.invalidUsername': 'Invalid username',
|
|
30
|
+
// ADR-089: приём внешних событий
|
|
31
|
+
'errors.validation.invalidEvent': 'Invalid event payload',
|
|
32
|
+
'errors.validation.invalidBinding': 'Invalid binding payload',
|
|
33
|
+
'errors.notFound.binding': 'Binding not found',
|
|
34
|
+
'errors.validation.invalidRule': 'Invalid routing rule payload',
|
|
35
|
+
'errors.notFound.rule': 'Routing rule not found',
|
|
36
|
+
'errors.validation.unknownAgent': 'Unknown agent in routing rule',
|
|
37
|
+
'errors.validation.invalidEventKey': 'Invalid event API key',
|
|
38
|
+
'errors.validation.invalidEventKeyUpdate': 'Invalid event API key update',
|
|
39
|
+
'errors.notFound.eventKey': 'Event API key not found',
|
|
40
|
+
// ADR-052 (этап I): service-key
|
|
41
|
+
'errors.validation.invalidServiceKey': 'Invalid service key payload',
|
|
42
|
+
'errors.notFound.serviceKey': 'Service key not found',
|
|
43
|
+
'errors.conflict.serviceKeyLabel': 'Service key label is already used',
|
|
44
|
+
'errors.forbidden.scopeRequired': 'Insufficient permissions: required scope is missing',
|
|
45
|
+
'errors.forbidden.projectForbidden': 'Project is not available for this service key',
|
|
46
|
+
'errors.rateLimited.serviceKey': 'Service key rate limit exceeded',
|
|
47
|
+
// ADR-052 (этап II): исходящие webhooks
|
|
48
|
+
'errors.validation.invalidWebhook': 'Invalid webhook subscription payload',
|
|
49
|
+
'errors.notFound.webhook': 'Webhook subscription not found',
|
|
50
|
+
'errors.conflict.webhookLabel': 'Webhook label is already used',
|
|
51
|
+
'errors.validation.webhookTargetForbidden': 'Webhook target URL is not allowed by security policy',
|
|
52
|
+
'errors.unavailable.webhooksDisabled': 'Webhook delivery is disabled',
|
|
26
53
|
// Conflict errors
|
|
27
54
|
'errors.conflict.usernameExists': 'A user with this username already exists',
|
|
28
55
|
'errors.conflict.emailExists': 'A user with this email already exists',
|
|
29
56
|
'errors.conflict.usernameTaken': 'Username is taken',
|
|
30
57
|
'errors.conflict.emailTaken': 'Email is taken',
|
|
58
|
+
'errors.conflict.eventKeyLabel': 'Event API key label is already used',
|
|
59
|
+
'errors.conflict.identityClaim': 'This identity is already linked to another profile',
|
|
31
60
|
// Other errors
|
|
32
61
|
'errors.providerDisabled': 'Provider is disabled',
|
|
33
62
|
'errors.connectionError': 'Connection error',
|
|
34
63
|
'errors.faviconFetchError': 'Error fetching favicon',
|
|
35
64
|
'errors.generic': 'Error',
|
|
65
|
+
'errors.rateLimited.eventKey': 'Event API key rate limit exceeded',
|
|
66
|
+
'errors.rateLimited.identityClaim': 'Too many identity confirmation attempts, try again later',
|
|
67
|
+
'errors.unavailable.eventsDisabled': 'External event ingestion is disabled',
|
|
36
68
|
// Auth
|
|
37
69
|
'auth.unauthorized': 'Authentication required',
|
|
38
70
|
'auth.forbidden': 'Access denied',
|
|
@@ -64,6 +96,8 @@ const ru = {
|
|
|
64
96
|
'errors.notFound.favicon': 'Favicon не найден',
|
|
65
97
|
'errors.notFound.route': 'Не найдено: {method} {path}',
|
|
66
98
|
'errors.notFound.agentOverride': 'Override не найден',
|
|
99
|
+
'errors.notFound.identity': 'Привязанная идентичность не найдена',
|
|
100
|
+
'errors.notFound.identityClaim': 'Код подтверждения недействителен (неизвестен, истёк или использован)',
|
|
67
101
|
// Validation errors
|
|
68
102
|
'errors.validation.contentRequired': 'content обязателен',
|
|
69
103
|
'errors.validation.nameRequired': 'name обязателен',
|
|
@@ -75,16 +109,46 @@ const ru = {
|
|
|
75
109
|
'errors.validation.usernameRequired': 'username обязателен',
|
|
76
110
|
'errors.validation.groupsRequired': 'groups обязательны',
|
|
77
111
|
'errors.validation.expectedFilesArray': 'expected { files: string[] }',
|
|
112
|
+
'errors.validation.claimCodeRequired': 'Укажите код подтверждения',
|
|
113
|
+
'errors.validation.invalidUsername': 'Некорректное имя пользователя',
|
|
114
|
+
// ADR-089: приём внешних событий
|
|
115
|
+
'errors.validation.invalidEvent': 'Некорректное тело события',
|
|
116
|
+
'errors.validation.invalidBinding': 'Некорректное тело биндинга',
|
|
117
|
+
'errors.notFound.binding': 'Биндинг не найден',
|
|
118
|
+
'errors.validation.invalidRule': 'Некорректное тело правила маршрутизации',
|
|
119
|
+
'errors.notFound.rule': 'Правило маршрутизации не найдено',
|
|
120
|
+
'errors.validation.unknownAgent': 'Неизвестный агент в правиле маршрутизации',
|
|
121
|
+
'errors.validation.invalidEventKey': 'Неверный API-ключ события',
|
|
122
|
+
'errors.validation.invalidEventKeyUpdate': 'Некорректное тело обновления API-ключа события',
|
|
123
|
+
'errors.notFound.eventKey': 'API-ключ события не найден',
|
|
124
|
+
// ADR-052 (этап I): service-key
|
|
125
|
+
'errors.validation.invalidServiceKey': 'Некорректное тело service-key',
|
|
126
|
+
'errors.notFound.serviceKey': 'Service-key не найден',
|
|
127
|
+
'errors.conflict.serviceKeyLabel': 'Метка service-key уже используется',
|
|
128
|
+
'errors.forbidden.scopeRequired': 'Недостаточно прав: отсутствует требуемый scope',
|
|
129
|
+
'errors.forbidden.projectForbidden': 'Проект недоступен для этого service-key',
|
|
130
|
+
'errors.rateLimited.serviceKey': 'Превышен лимит запросов по service-key',
|
|
131
|
+
// ADR-052 (этап II): исходящие webhooks
|
|
132
|
+
'errors.validation.invalidWebhook': 'Некорректное тело webhook-подписки',
|
|
133
|
+
'errors.notFound.webhook': 'Webhook-подписка не найдена',
|
|
134
|
+
'errors.conflict.webhookLabel': 'Метка webhook уже используется',
|
|
135
|
+
'errors.validation.webhookTargetForbidden': 'Целевой URL webhook запрещён политикой безопасности',
|
|
136
|
+
'errors.unavailable.webhooksDisabled': 'Доставка webhooks отключена',
|
|
78
137
|
// Conflict errors
|
|
79
138
|
'errors.conflict.usernameExists': 'Пользователь с таким именем уже существует',
|
|
80
139
|
'errors.conflict.emailExists': 'Пользователь с таким email уже существует',
|
|
81
140
|
'errors.conflict.usernameTaken': 'Имя занято',
|
|
82
141
|
'errors.conflict.emailTaken': 'Email занят',
|
|
142
|
+
'errors.conflict.eventKeyLabel': 'Метка API-ключа события уже используется',
|
|
143
|
+
'errors.conflict.identityClaim': 'Эта идентичность уже привязана к другому профилю',
|
|
83
144
|
// Other errors
|
|
84
145
|
'errors.providerDisabled': 'Провайдер отключён',
|
|
85
146
|
'errors.connectionError': 'Ошибка подключения',
|
|
86
147
|
'errors.faviconFetchError': 'Ошибка получения favicon',
|
|
87
148
|
'errors.generic': 'Ошибка',
|
|
149
|
+
'errors.rateLimited.eventKey': 'Превышен лимит запросов по API-ключу события',
|
|
150
|
+
'errors.rateLimited.identityClaim': 'Слишком много попыток подтверждения идентичности, повторите позже',
|
|
151
|
+
'errors.unavailable.eventsDisabled': 'Приём внешних событий отключён',
|
|
88
152
|
// Auth
|
|
89
153
|
'auth.unauthorized': 'Требуется аутентификация',
|
|
90
154
|
'auth.forbidden': 'Доступ запрещён',
|
package/dist/main.js
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
import { createBackendApp } from './app.js';
|
|
7
7
|
const host = process.env.SYNTH_HOST || '0.0.0.0';
|
|
8
8
|
const handle = await createBackendApp();
|
|
9
|
-
const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager } = handle;
|
|
9
|
+
const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner } = handle;
|
|
10
10
|
let shuttingDown = false;
|
|
11
11
|
async function gracefulShutdown(signal) {
|
|
12
12
|
if (shuttingDown)
|
|
@@ -26,6 +26,15 @@ async function gracefulShutdown(signal) {
|
|
|
26
26
|
console.log('[Shutdown] WebSocket-сервер остановлен');
|
|
27
27
|
queueManager.stopAll();
|
|
28
28
|
console.log('[Shutdown] Очередь остановлена');
|
|
29
|
+
// ADR-089: остановить авто-архивацию ephemeral-сессий.
|
|
30
|
+
stopEphemeralSweeper();
|
|
31
|
+
// ADR-089: остановить retention-очистку журнала событий.
|
|
32
|
+
stopEventJournalPruner();
|
|
33
|
+
// ADR-051 (срез): остановить планировщик расписаний.
|
|
34
|
+
stopScheduler();
|
|
35
|
+
// ADR-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
|
|
36
|
+
stopWebhookService();
|
|
37
|
+
stopWebhookDeliveryPruner();
|
|
29
38
|
const drainTimeout = 10_000;
|
|
30
39
|
const activeSessions = await sessionManager.listActiveSessions();
|
|
31
40
|
if (activeSessions.length > 0) {
|
|
@@ -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;
|