@conarium-ai/core 0.2.41 → 0.2.43
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/CHANGELOG.md +67 -0
- package/bin/conarium-verify.mjs +3 -2
- package/conformance/README.md +2 -1
- package/docs/RECEIPT-SPEC.md +6 -3
- package/docs/claims/locale-residue.json +7 -0
- package/docs/claims/reviews/0.2.42.md +77 -0
- package/docs/claims/reviews/0.2.43.md +75 -0
- package/package.json +9 -1
- package/scripts/gen-test-vectors.mjs +1 -0
- package/test-vectors/manifest.json +1 -0
- package/docs/audit/2026-08-14-e2e-health.md +0 -69
- package/docs/plans/2026-07-02-redteam-harness.md +0 -416
- package/docs/specs/2026-07-02-redteam-harness-design.md +0 -90
- package/docs/specs/2026-08-14-mssql-bypass-inventory.md +0 -37
- package/docs/specs/2026-08-14-oracle-bypass-inventory.md +0 -28
- package/docs/specs/2026-08-14-oracle-mssql-dialect-design.md +0 -232
- package/docs/superpowers/TODO-gate1-f4.md +0 -23
- package/docs/superpowers/plans/2026-07-29-conarium-receipt-plan.md +0 -200
- package/docs/superpowers/plans/2026-07-29-katman0-kapanis-plan.md +0 -231
- package/docs/superpowers/plans/2026-07-31-per-user-identity.md +0 -667
- package/docs/superpowers/specs/2026-07-29-conarium-receipt-design.md +0 -202
- package/docs/superpowers/specs/2026-07-31-per-user-identity-design.md +0 -144
- package/docs/superpowers/specs/2026-08-01-coverage-proof-design.md +0 -139
- package/docs/superpowers/specs/2026-08-05-receipt-meta-provenance-design.md +0 -116
|
@@ -1,416 +0,0 @@
|
|
|
1
|
-
# Conarium Red-Team Harness v1 — Implementation Plan
|
|
2
|
-
|
|
3
|
-
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax.
|
|
4
|
-
|
|
5
|
-
**Goal:** NEO'nun Conarium'un `Governance` motoruna saldırıp savunmayı ölçen, DEFENDED/BYPASSED raporu üreten red-team harness'i.
|
|
6
|
-
|
|
7
|
-
**Architecture:** `nexus/redteam/` altında izole modüller. Saldırı case'leri (`AttackCase`) doğrudan `Governance` sınıfını çağırır: sorgu-zamanı `guardQuery` (PolicyError=blok), sonuç-zamanı `redact` (PII maske). Runner sınıflar, report üretir.
|
|
8
|
-
|
|
9
|
-
**Tech Stack:** TypeScript (ESM/NodeNext), tsx, vitest.
|
|
10
|
-
|
|
11
|
-
## Global Constraints
|
|
12
|
-
|
|
13
|
-
- ESM/NodeNext: **tüm importlar `.js` uzantısı kullanır** (repo konvansiyonu; örn. `import { Governance } from '../src/governance.js'`).
|
|
14
|
-
- `Governance` API (kanıtlı): `new Governance(policy: GovernancePolicy)`; `guardQuery(sql): GuardedQuery` — bloklarsa `PolicyError` fırlatır; `redact(result: QueryResult): GovernedQueryResult` — `QueryResult = { rows, rowCount, fields, sql? }`.
|
|
15
|
-
- Harness Conarium'u DEĞİŞTİRMEZ; sadece dışarıdan çağırır (salt-okunur saldırı).
|
|
16
|
-
- Test runner: `vitest run` (`npm test`).
|
|
17
|
-
- Dürüstlük: encode-base64 PII-exfil case'i **BYPASSED beklenir** (gerçek delik); harness bunu doğru tespit etmeli.
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
### Task 0: Test altyapısı + redteam/types.ts
|
|
22
|
-
|
|
23
|
-
**Files:**
|
|
24
|
-
- Modify: `package.json` (devDep vitest, script test)
|
|
25
|
-
- Create: `redteam/types.ts`
|
|
26
|
-
|
|
27
|
-
- [ ] **Step 1:** `package.json` → `devDependencies`'e `"vitest": "^2.0.0"`, `scripts`'e `"test": "vitest run"` ekle, sonra `npm install`.
|
|
28
|
-
|
|
29
|
-
- [ ] **Step 2:** `redteam/types.ts` oluştur:
|
|
30
|
-
|
|
31
|
-
```ts
|
|
32
|
-
import type { Governance } from '../src/governance.js';
|
|
33
|
-
|
|
34
|
-
export type AttackCategory = 'write_smuggle' | 'unauthorized_table' | 'multi_statement' | 'pii_exfil';
|
|
35
|
-
export type Severity = 'CRITICAL' | 'HIGH' | 'MEDIUM';
|
|
36
|
-
|
|
37
|
-
export interface AttackCase {
|
|
38
|
-
id: string;
|
|
39
|
-
category: AttackCategory;
|
|
40
|
-
severity: Severity;
|
|
41
|
-
description: string;
|
|
42
|
-
run(gov: Governance): { defended: boolean; detail: string };
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
export interface AttackResult {
|
|
46
|
-
id: string;
|
|
47
|
-
category: AttackCategory;
|
|
48
|
-
severity: Severity;
|
|
49
|
-
description: string;
|
|
50
|
-
defended: boolean;
|
|
51
|
-
detail: string;
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
export interface RedTeamReport {
|
|
55
|
-
ranAt: string;
|
|
56
|
-
total: number;
|
|
57
|
-
defended: number;
|
|
58
|
-
bypassed: number;
|
|
59
|
-
results: AttackResult[];
|
|
60
|
-
}
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
- [ ] **Step 3:** Doğrula: `npx tsx -e "import('./redteam/types.js').then(()=>console.log('types OK'))"` → "types OK"
|
|
64
|
-
- [ ] **Step 4:** Commit: `git add package.json redteam/types.ts && git commit -m "chore(redteam): test altyapısı + tipler"`
|
|
65
|
-
|
|
66
|
-
---
|
|
67
|
-
|
|
68
|
-
### Task 1: attacks/queryTime.ts (sorgu-zamanı saldırılar)
|
|
69
|
-
|
|
70
|
-
**Files:**
|
|
71
|
-
- Create: `redteam/attacks/queryTime.ts`
|
|
72
|
-
- Test: `redteam/attacks/queryTime.test.ts`
|
|
73
|
-
|
|
74
|
-
**Interfaces:**
|
|
75
|
-
- Produces: `queryTimeAttacks: AttackCase[]`
|
|
76
|
-
|
|
77
|
-
- [ ] **Step 1: Testi yaz:**
|
|
78
|
-
|
|
79
|
-
```ts
|
|
80
|
-
import { describe, it, expect } from 'vitest';
|
|
81
|
-
import { Governance } from '../../src/governance.js';
|
|
82
|
-
import { queryTimeAttacks } from './queryTime.js';
|
|
83
|
-
|
|
84
|
-
const gov = new Governance({ allowTables: ['public.customers'], maxRows: 100 });
|
|
85
|
-
|
|
86
|
-
describe('queryTimeAttacks', () => {
|
|
87
|
-
it('tüm write/multi-statement/yetkisiz-tablo saldırıları DEFENDED (bloklanır)', () => {
|
|
88
|
-
for (const atk of queryTimeAttacks) {
|
|
89
|
-
const r = atk.run(gov);
|
|
90
|
-
expect(r.defended, `${atk.id} savunulmalıydı: ${r.detail}`).toBe(true);
|
|
91
|
-
}
|
|
92
|
-
});
|
|
93
|
-
});
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
- [ ] **Step 2:** `npx vitest run redteam/attacks/queryTime.test.ts` → FAIL
|
|
97
|
-
- [ ] **Step 3: Uygula:**
|
|
98
|
-
|
|
99
|
-
```ts
|
|
100
|
-
import type { AttackCase } from '../types.js';
|
|
101
|
-
import type { Governance } from '../../src/governance.js';
|
|
102
|
-
|
|
103
|
-
function shouldBlock(gov: Governance, sql: string): { defended: boolean; detail: string } {
|
|
104
|
-
try {
|
|
105
|
-
gov.guardQuery(sql);
|
|
106
|
-
return { defended: false, detail: `BYPASS — guardQuery izin verdi: ${sql}` };
|
|
107
|
-
} catch (e: any) {
|
|
108
|
-
return { defended: true, detail: `DEFENDED — ${e.message}` };
|
|
109
|
-
}
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
export const queryTimeAttacks: AttackCase[] = [
|
|
113
|
-
{ id: 'wr-delete', category: 'write_smuggle', severity: 'CRITICAL', description: 'Düz DELETE',
|
|
114
|
-
run: g => shouldBlock(g, 'DELETE FROM customers') },
|
|
115
|
-
{ id: 'wr-drop', category: 'write_smuggle', severity: 'CRITICAL', description: 'DROP TABLE',
|
|
116
|
-
run: g => shouldBlock(g, 'DROP TABLE customers') },
|
|
117
|
-
{ id: 'wr-stacked', category: 'multi_statement', severity: 'CRITICAL', description: 'Stacked query ile gizli write',
|
|
118
|
-
run: g => shouldBlock(g, 'SELECT 1; DROP TABLE customers') },
|
|
119
|
-
{ id: 'wr-update-comment', category: 'write_smuggle', severity: 'HIGH', description: 'Yorumla gizlenmiş UPDATE',
|
|
120
|
-
run: g => shouldBlock(g, 'UPDATE customers SET name=1 -- SELECT') },
|
|
121
|
-
{ id: 'tbl-unauth', category: 'unauthorized_table', severity: 'HIGH', description: 'İzin listesi dışı tabloya erişim',
|
|
122
|
-
run: g => shouldBlock(g, 'SELECT * FROM secret.admin_users') },
|
|
123
|
-
];
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
- [ ] **Step 4:** `npx vitest run redteam/attacks/queryTime.test.ts` → PASS
|
|
127
|
-
- [ ] **Step 5:** Commit: `git add redteam/attacks/queryTime.* && git commit -m "feat(redteam): sorgu-zamanı saldırılar"`
|
|
128
|
-
|
|
129
|
-
---
|
|
130
|
-
|
|
131
|
-
### Task 2: attacks/resultTime.ts (PII exfil — encode bypass'ı yakalar)
|
|
132
|
-
|
|
133
|
-
**Files:**
|
|
134
|
-
- Create: `redteam/attacks/resultTime.ts`
|
|
135
|
-
- Test: `redteam/attacks/resultTime.test.ts`
|
|
136
|
-
|
|
137
|
-
**Interfaces:**
|
|
138
|
-
- Produces: `resultTimeAttacks: AttackCase[]`
|
|
139
|
-
|
|
140
|
-
- [ ] **Step 1: Testi yaz:**
|
|
141
|
-
|
|
142
|
-
```ts
|
|
143
|
-
import { describe, it, expect } from 'vitest';
|
|
144
|
-
import { Governance } from '../../src/governance.js';
|
|
145
|
-
import { resultTimeAttacks } from './resultTime.js';
|
|
146
|
-
|
|
147
|
-
const gov = new Governance({ maskColumns: ['*.email'], maxRows: 100 });
|
|
148
|
-
|
|
149
|
-
describe('resultTimeAttacks', () => {
|
|
150
|
-
it('düz-metin PII DEFENDED (maskelenir)', () => {
|
|
151
|
-
const plain = resultTimeAttacks.find(a => a.id === 'pii-plaintext')!;
|
|
152
|
-
expect(plain.run(gov).defended).toBe(true);
|
|
153
|
-
});
|
|
154
|
-
it('base64-encode PII BYPASSED (harness gerçek deliği yakalar)', () => {
|
|
155
|
-
const enc = resultTimeAttacks.find(a => a.id === 'pii-base64')!;
|
|
156
|
-
expect(enc.run(gov).defended).toBe(false);
|
|
157
|
-
});
|
|
158
|
-
});
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
- [ ] **Step 2:** `npx vitest run redteam/attacks/resultTime.test.ts` → FAIL
|
|
162
|
-
- [ ] **Step 3: Uygula:**
|
|
163
|
-
|
|
164
|
-
```ts
|
|
165
|
-
import type { AttackCase } from '../types.js';
|
|
166
|
-
import type { Governance } from '../../src/governance.js';
|
|
167
|
-
import type { QueryResult, GovernedQueryResult } from '../../src/types.js';
|
|
168
|
-
|
|
169
|
-
const PII_EMAIL = 'ahmet@wearu.app';
|
|
170
|
-
const PII_RE = /@[a-z0-9.-]+\.[a-z]{2,}|\b[1-9][0-9]{10}\b/i;
|
|
171
|
-
|
|
172
|
-
function containsRecoverablePII(governed: GovernedQueryResult): boolean {
|
|
173
|
-
const flat = JSON.stringify(governed.rows);
|
|
174
|
-
if (PII_RE.test(flat)) return true; // düz PII sağ kaldı
|
|
175
|
-
for (const row of governed.rows) {
|
|
176
|
-
for (const v of Object.values(row)) {
|
|
177
|
-
if (typeof v === 'string' && /^[A-Za-z0-9+/]{8,}={0,2}$/.test(v)) {
|
|
178
|
-
try {
|
|
179
|
-
const dec = Buffer.from(v, 'base64').toString('utf8');
|
|
180
|
-
if (PII_RE.test(dec)) return true; // encode ile kaçırılmış PII
|
|
181
|
-
} catch { /* base64 değil */ }
|
|
182
|
-
}
|
|
183
|
-
}
|
|
184
|
-
}
|
|
185
|
-
return false;
|
|
186
|
-
}
|
|
187
|
-
|
|
188
|
-
function tryRedact(gov: Governance, rows: Record<string, unknown>[]): { defended: boolean; detail: string } {
|
|
189
|
-
const result: QueryResult = { rows, rowCount: rows.length, fields: Object.keys(rows[0] ?? {}) };
|
|
190
|
-
const governed = gov.redact(result);
|
|
191
|
-
const leaked = containsRecoverablePII(governed);
|
|
192
|
-
return {
|
|
193
|
-
defended: !leaked,
|
|
194
|
-
detail: leaked
|
|
195
|
-
? `BYPASS — PII geri-kazanılabilir: ${JSON.stringify(governed.rows)}`
|
|
196
|
-
: `DEFENDED — maskelendi: ${JSON.stringify(governed.rows)}`,
|
|
197
|
-
};
|
|
198
|
-
}
|
|
199
|
-
|
|
200
|
-
export const resultTimeAttacks: AttackCase[] = [
|
|
201
|
-
{ id: 'pii-plaintext', category: 'pii_exfil', severity: 'HIGH', description: 'Düz-metin e-posta çıktısı',
|
|
202
|
-
run: g => tryRedact(g, [{ email: PII_EMAIL }]) },
|
|
203
|
-
{ id: 'pii-base64', category: 'pii_exfil', severity: 'CRITICAL', description: 'encode(email,base64) ile maske atlatma',
|
|
204
|
-
run: g => tryRedact(g, [{ leak: Buffer.from(PII_EMAIL).toString('base64') }]) },
|
|
205
|
-
];
|
|
206
|
-
```
|
|
207
|
-
|
|
208
|
-
- [ ] **Step 4:** `npx vitest run redteam/attacks/resultTime.test.ts` → PASS
|
|
209
|
-
- [ ] **Step 5:** Commit: `git add redteam/attacks/resultTime.* && git commit -m "feat(redteam): sonuç-zamanı PII-exfil (encode bypass tespiti)"`
|
|
210
|
-
|
|
211
|
-
---
|
|
212
|
-
|
|
213
|
-
### Task 3: runner.ts
|
|
214
|
-
|
|
215
|
-
**Files:**
|
|
216
|
-
- Create: `redteam/runner.ts`
|
|
217
|
-
- Test: `redteam/runner.test.ts`
|
|
218
|
-
|
|
219
|
-
**Interfaces:**
|
|
220
|
-
- Consumes: `AttackCase`, `RedTeamReport`, `Governance`
|
|
221
|
-
- Produces: `runRedTeam(gov: Governance, attacks: AttackCase[], now?: Date): RedTeamReport`
|
|
222
|
-
|
|
223
|
-
- [ ] **Step 1: Testi yaz:**
|
|
224
|
-
|
|
225
|
-
```ts
|
|
226
|
-
import { describe, it, expect } from 'vitest';
|
|
227
|
-
import { Governance } from '../src/governance.js';
|
|
228
|
-
import { runRedTeam } from './runner.js';
|
|
229
|
-
import type { AttackCase } from './types.js';
|
|
230
|
-
|
|
231
|
-
const fake: AttackCase[] = [
|
|
232
|
-
{ id: 'a', category: 'write_smuggle', severity: 'CRITICAL', description: 'x', run: () => ({ defended: true, detail: 'ok' }) },
|
|
233
|
-
{ id: 'b', category: 'pii_exfil', severity: 'CRITICAL', description: 'y', run: () => ({ defended: false, detail: 'leak' }) },
|
|
234
|
-
];
|
|
235
|
-
|
|
236
|
-
describe('runRedTeam', () => {
|
|
237
|
-
it('defended/bypassed sayar', () => {
|
|
238
|
-
const rep = runRedTeam(new Governance({}), fake, new Date('2026-07-02T00:00:00Z'));
|
|
239
|
-
expect(rep.total).toBe(2);
|
|
240
|
-
expect(rep.defended).toBe(1);
|
|
241
|
-
expect(rep.bypassed).toBe(1);
|
|
242
|
-
});
|
|
243
|
-
});
|
|
244
|
-
```
|
|
245
|
-
|
|
246
|
-
- [ ] **Step 2:** `npx vitest run redteam/runner.test.ts` → FAIL
|
|
247
|
-
- [ ] **Step 3: Uygula:**
|
|
248
|
-
|
|
249
|
-
```ts
|
|
250
|
-
import type { Governance } from '../src/governance.js';
|
|
251
|
-
import type { AttackCase, AttackResult, RedTeamReport } from './types.js';
|
|
252
|
-
|
|
253
|
-
export function runRedTeam(gov: Governance, attacks: AttackCase[], now: Date = new Date()): RedTeamReport {
|
|
254
|
-
const results: AttackResult[] = attacks.map(atk => {
|
|
255
|
-
const { defended, detail } = atk.run(gov);
|
|
256
|
-
return { id: atk.id, category: atk.category, severity: atk.severity, description: atk.description, defended, detail };
|
|
257
|
-
});
|
|
258
|
-
return {
|
|
259
|
-
ranAt: now.toISOString(),
|
|
260
|
-
total: results.length,
|
|
261
|
-
defended: results.filter(r => r.defended).length,
|
|
262
|
-
bypassed: results.filter(r => !r.defended).length,
|
|
263
|
-
results,
|
|
264
|
-
};
|
|
265
|
-
}
|
|
266
|
-
```
|
|
267
|
-
|
|
268
|
-
- [ ] **Step 4:** `npx vitest run redteam/runner.test.ts` → PASS
|
|
269
|
-
- [ ] **Step 5:** Commit: `git add redteam/runner.* && git commit -m "feat(redteam): runner + sınıflandırma"`
|
|
270
|
-
|
|
271
|
-
---
|
|
272
|
-
|
|
273
|
-
### Task 4: report.ts
|
|
274
|
-
|
|
275
|
-
**Files:**
|
|
276
|
-
- Create: `redteam/report.ts`
|
|
277
|
-
- Test: `redteam/report.test.ts`
|
|
278
|
-
|
|
279
|
-
**Interfaces:**
|
|
280
|
-
- Consumes: `RedTeamReport`
|
|
281
|
-
- Produces: `renderMarkdown(report: RedTeamReport): string`
|
|
282
|
-
|
|
283
|
-
- [ ] **Step 1: Testi yaz:**
|
|
284
|
-
|
|
285
|
-
```ts
|
|
286
|
-
import { describe, it, expect } from 'vitest';
|
|
287
|
-
import { renderMarkdown } from './report.js';
|
|
288
|
-
import type { RedTeamReport } from './types.js';
|
|
289
|
-
|
|
290
|
-
const rep: RedTeamReport = {
|
|
291
|
-
ranAt: '2026-07-02T00:00:00.000Z', total: 2, defended: 1, bypassed: 1,
|
|
292
|
-
results: [
|
|
293
|
-
{ id: 'a', category: 'write_smuggle', severity: 'CRITICAL', description: 'x', defended: true, detail: 'ok' },
|
|
294
|
-
{ id: 'b', category: 'pii_exfil', severity: 'CRITICAL', description: 'y', defended: false, detail: 'leak' },
|
|
295
|
-
],
|
|
296
|
-
};
|
|
297
|
-
|
|
298
|
-
describe('renderMarkdown', () => {
|
|
299
|
-
it('savunma karnesi + BYPASSED bulgularını listeler', () => {
|
|
300
|
-
const md = renderMarkdown(rep);
|
|
301
|
-
expect(md).toContain('1/2 savundu');
|
|
302
|
-
expect(md).toContain('BYPASS');
|
|
303
|
-
expect(md).toContain('b');
|
|
304
|
-
});
|
|
305
|
-
});
|
|
306
|
-
```
|
|
307
|
-
|
|
308
|
-
- [ ] **Step 2:** `npx vitest run redteam/report.test.ts` → FAIL
|
|
309
|
-
- [ ] **Step 3: Uygula:**
|
|
310
|
-
|
|
311
|
-
```ts
|
|
312
|
-
import type { RedTeamReport } from './types.js';
|
|
313
|
-
|
|
314
|
-
export function renderMarkdown(r: RedTeamReport): string {
|
|
315
|
-
const l: string[] = [];
|
|
316
|
-
l.push(`# Conarium Savunma Karnesi (NEO Red-Team)`);
|
|
317
|
-
l.push(`Tarih: ${r.ranAt}`, '');
|
|
318
|
-
l.push(`**Sonuç: ${r.defended}/${r.total} savundu, ${r.bypassed} bypass.**`, '');
|
|
319
|
-
const bypassed = r.results.filter(x => !x.defended);
|
|
320
|
-
if (bypassed.length) {
|
|
321
|
-
l.push(`## 🚨 Sertleştirilecekler (BYPASS)`);
|
|
322
|
-
for (const b of bypassed) l.push(`- [${b.severity}] ${b.id} — ${b.description}\n - ${b.detail}`);
|
|
323
|
-
l.push('');
|
|
324
|
-
}
|
|
325
|
-
l.push(`## ✅ Savunulanlar (DEFENDED)`);
|
|
326
|
-
for (const d of r.results.filter(x => x.defended)) l.push(`- [${d.severity}] ${d.id} — ${d.description}`);
|
|
327
|
-
return l.join('\n');
|
|
328
|
-
}
|
|
329
|
-
```
|
|
330
|
-
|
|
331
|
-
- [ ] **Step 4:** `npx vitest run redteam/report.test.ts` → PASS
|
|
332
|
-
- [ ] **Step 5:** Commit: `git add redteam/report.* && git commit -m "feat(redteam): savunma karnesi render"`
|
|
333
|
-
|
|
334
|
-
---
|
|
335
|
-
|
|
336
|
-
### Task 5: index.ts (orkestratör + CLI)
|
|
337
|
-
|
|
338
|
-
**Files:**
|
|
339
|
-
- Create: `redteam/index.ts`
|
|
340
|
-
- Test: `redteam/index.test.ts`
|
|
341
|
-
|
|
342
|
-
**Interfaces:**
|
|
343
|
-
- Consumes: `runRedTeam`, `queryTimeAttacks`, `resultTimeAttacks`, `Governance`
|
|
344
|
-
- Produces: `allAttacks: AttackCase[]`, `redTeamConarium(policy): RedTeamReport`
|
|
345
|
-
|
|
346
|
-
- [ ] **Step 1: Testi yaz:**
|
|
347
|
-
|
|
348
|
-
```ts
|
|
349
|
-
import { describe, it, expect } from 'vitest';
|
|
350
|
-
import { redTeamConarium, allAttacks } from './index.js';
|
|
351
|
-
|
|
352
|
-
describe('redTeamConarium', () => {
|
|
353
|
-
it('gerçek Governance ile çalışır: write DEFENDED + base64 PII BYPASS', () => {
|
|
354
|
-
const rep = redTeamConarium({ allowTables: ['public.customers'], maskColumns: ['*.email'] });
|
|
355
|
-
expect(rep.total).toBe(allAttacks.length);
|
|
356
|
-
expect(rep.results.find(r => r.id === 'wr-delete')!.defended).toBe(true);
|
|
357
|
-
expect(rep.results.find(r => r.id === 'pii-base64')!.defended).toBe(false);
|
|
358
|
-
});
|
|
359
|
-
});
|
|
360
|
-
```
|
|
361
|
-
|
|
362
|
-
- [ ] **Step 2:** `npx vitest run redteam/index.test.ts` → FAIL
|
|
363
|
-
- [ ] **Step 3: Uygula:**
|
|
364
|
-
|
|
365
|
-
```ts
|
|
366
|
-
import { Governance } from '../src/governance.js';
|
|
367
|
-
import type { GovernancePolicy } from '../src/types.js';
|
|
368
|
-
import type { AttackCase, RedTeamReport } from './types.js';
|
|
369
|
-
import { queryTimeAttacks } from './attacks/queryTime.js';
|
|
370
|
-
import { resultTimeAttacks } from './attacks/resultTime.js';
|
|
371
|
-
import { runRedTeam } from './runner.js';
|
|
372
|
-
import { renderMarkdown } from './report.js';
|
|
373
|
-
|
|
374
|
-
export const allAttacks: AttackCase[] = [...queryTimeAttacks, ...resultTimeAttacks];
|
|
375
|
-
|
|
376
|
-
export function redTeamConarium(policy: GovernancePolicy): RedTeamReport {
|
|
377
|
-
return runRedTeam(new Governance(policy), allAttacks);
|
|
378
|
-
}
|
|
379
|
-
|
|
380
|
-
// CLI: npx tsx redteam/index.ts
|
|
381
|
-
const isMain = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('index.ts');
|
|
382
|
-
if (isMain) {
|
|
383
|
-
const rep = redTeamConarium({ allowTables: ['public.customers'], maskColumns: ['*.email'], maxRows: 100 });
|
|
384
|
-
console.log(renderMarkdown(rep));
|
|
385
|
-
}
|
|
386
|
-
```
|
|
387
|
-
|
|
388
|
-
- [ ] **Step 4:** `npx vitest run redteam/index.test.ts` → PASS. Sonra tüm suite: `npm test` → hepsi PASS.
|
|
389
|
-
- [ ] **Step 5:** Commit: `git add redteam/index.* && git commit -m "feat(redteam): orkestratör + CLI"`
|
|
390
|
-
|
|
391
|
-
---
|
|
392
|
-
|
|
393
|
-
### Task 6: Canlı çalıştırma (demo materyali)
|
|
394
|
-
|
|
395
|
-
**Files:**
|
|
396
|
-
- (kod yok — canlı doğrulama)
|
|
397
|
-
|
|
398
|
-
- [ ] **Step 1: Harness'i gerçek Conarium'a karşı çalıştır:**
|
|
399
|
-
|
|
400
|
-
Run: `npx tsx redteam/index.ts`
|
|
401
|
-
|
|
402
|
-
Beklenen: Markdown "Savunma Karnesi" — write/unauthorized saldırıları DEFENDED, `pii-base64` BYPASS olarak listelenir (Conarium'un gerçek deliği = Faz 1 demosunun ham materyali + Faz 2 sertleştirme girdisi).
|
|
403
|
-
|
|
404
|
-
- [ ] **Step 2:** Raporu kaydet: `npx tsx redteam/index.ts > redteam/last-report.md` (gitignore'a `redteam/last-report.md` ekle).
|
|
405
|
-
|
|
406
|
-
---
|
|
407
|
-
|
|
408
|
-
## Self-Review
|
|
409
|
-
|
|
410
|
-
**Spec coverage:** ✅ query-time saldırılar (T1), result-time PII-exfil + encode bypass (T2), runner sınıflandırma (T3), savunma karnesi (T4), orkestratör+CLI (T5), canlı demo (T6). Test stratejisi her task'ta.
|
|
411
|
-
|
|
412
|
-
**Placeholder scan:** Tüm adımlarda gerçek kod; TODO/TBD yok.
|
|
413
|
-
|
|
414
|
-
**Type consistency:** `AttackCase.run(gov): {defended, detail}` T0'da tanımlı, T1/T2/T5 aynı kullanıyor. `runRedTeam(gov, attacks, now?)` T3↔T5 tutarlı. `QueryResult` `{rows,rowCount,fields}` gerçek tiple (types.ts:63) uyumlu. Importlar `.js` uzantılı (repo konvansiyonu).
|
|
415
|
-
|
|
416
|
-
**Not:** encode-base64 case'i bilerek BYPASS beklenir — bu Conarium'un gerçek deliği; harness'in görevi onu doğru yakalamak (Conarium'u kusursuz göstermek değil).
|
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
# Conarium Red-Team Harness v1 — Tasarım Belgesi
|
|
2
|
-
|
|
3
|
-
- **Tarih:** 2026-07-02 · **Sahip:** Emek Can Doğru + Claude (gate)
|
|
4
|
-
- **Konum:** `nexus/redteam/` (Conarium repo, `@conarium-ai/core`)
|
|
5
|
-
- **Bağlam:** STRATEJI.md Faz 1 — "NEO Conarium'a saldırır, Conarium bloklar" demosu + Faz 2 purple-team döngüsünün tohumu.
|
|
6
|
-
|
|
7
|
-
## 1. Amaç
|
|
8
|
-
NEO'nun red-team kolu, Conarium'un `Governance` motoruna bir **saldırı bataryası** fırlatır; her saldırının **SAVUNULDU** (Conarium bloklamış/maskelemiş) mı yoksa **BYPASS** (geçmiş/PII sızmış) mı olduğunu ölçer. Her BYPASS = Conarium'u sertleştirecek gerçek bir politika deliği. Çıktı hem **demo** (NEO saldırır, Conarium savunur) hem de purple-team döngüsünün girdisi.
|
|
9
|
-
|
|
10
|
-
## 2. Kapsam
|
|
11
|
-
### Dahil (MVP — Yaklaşım ①: doğrudan kütüphane çağrısı)
|
|
12
|
-
İki savunma katmanına saldırı:
|
|
13
|
-
- **Sorgu-zamanı (`guardQuery`)**: yazma-op kaçakçılığı, yetkisiz tablo (JOIN/UNION/subquery ile), çoklu-statement, parse hileleri.
|
|
14
|
-
- **Sonuç-zamanı (`redact`/`maskPII`)**: PII exfiltration — encode/base64, alias, format kırma (PII'yi parçalayıp maskeyi atlatma).
|
|
15
|
-
- Rapor: her saldırı → {DEFENDED | BYPASSED} + severity + detay (JSON + Markdown).
|
|
16
|
-
|
|
17
|
-
### Hariç (sonra)
|
|
18
|
-
- Kara-kutu MCP saldırısı (② yaklaşım) ve canlı-AI prompt-injection (③).
|
|
19
|
-
- Politikayı OTOMATİK düzeltme (bulguyu üretiriz; düzeltme insan onayı — STRATEJI Tier 2).
|
|
20
|
-
|
|
21
|
-
## 3. Mimari
|
|
22
|
-
```
|
|
23
|
-
runRedTeam(governance, policy) →
|
|
24
|
-
1. attacks[] topla (queryTime + resultTime saldırı case'leri)
|
|
25
|
-
2. her case'i çalıştır → AttackResult { defended, detail }
|
|
26
|
-
3. sınıflandır: DEFENDED (blok/maske) vs BYPASSED (geçti/sızdı)
|
|
27
|
-
4. RedTeamReport üret (stats + bulgular)
|
|
28
|
-
```
|
|
29
|
-
`Governance` motorunu doğrudan import eder (aynı repo). Bir test `GovernancePolicy` ile örnek şirket senaryosu kurar.
|
|
30
|
-
|
|
31
|
-
## 4. Modüller (`nexus/redteam/`)
|
|
32
|
-
| Modül | Sorumluluk |
|
|
33
|
-
|---|---|
|
|
34
|
-
| `types.ts` | `AttackCase`, `AttackResult`, `RedTeamReport` |
|
|
35
|
-
| `attacks/queryTime.ts` | Sorgu-zamanı saldırı case'leri (write-smuggle, unauthorized-table, multi-statement) |
|
|
36
|
-
| `attacks/resultTime.ts` | Sonuç-zamanı PII-exfil case'leri (encode/base64, alias, format-break) |
|
|
37
|
-
| `runner.ts` | Case'leri `Governance`'a karşı çalıştır → defended/bypassed sınıfla |
|
|
38
|
-
| `report.ts` | `RedTeamReport` → Markdown + JSON |
|
|
39
|
-
| `index.ts` | `runRedTeam` orkestratör + CLI (`npx tsx redteam/index.ts`) |
|
|
40
|
-
|
|
41
|
-
## 5. Veri Modeli
|
|
42
|
-
```ts
|
|
43
|
-
type AttackCategory = 'write_smuggle' | 'unauthorized_table' | 'multi_statement' | 'pii_exfil';
|
|
44
|
-
type Severity = 'CRITICAL' | 'HIGH' | 'MEDIUM';
|
|
45
|
-
|
|
46
|
-
interface AttackCase {
|
|
47
|
-
id: string;
|
|
48
|
-
category: AttackCategory;
|
|
49
|
-
severity: Severity;
|
|
50
|
-
description: string;
|
|
51
|
-
// Conarium'a saldırıyı uygula; Conarium savundu mu döndür.
|
|
52
|
-
run(gov: Governance): { defended: boolean; detail: string };
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
interface AttackResult { case: AttackCase; defended: boolean; detail: string; }
|
|
56
|
-
|
|
57
|
-
interface RedTeamReport {
|
|
58
|
-
ranAt: string;
|
|
59
|
-
total: number;
|
|
60
|
-
defended: number;
|
|
61
|
-
bypassed: number;
|
|
62
|
-
results: AttackResult[]; // BYPASSED'lar = bulgular
|
|
63
|
-
}
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
## 6. Saldırı Case Örnekleri (davranış)
|
|
67
|
-
- **write_smuggle:** `guardQuery("DELETE FROM users")`, `"SELECT 1; DROP TABLE x"`, yorumla gizli write → **DEFENDED beklenir** (PolicyError).
|
|
68
|
-
- **unauthorized_table:** izin-dışı tabloya `JOIN`/`UNION SELECT` → **DEFENDED beklenir**.
|
|
69
|
-
- **pii_exfil (encode):** `redact` katmanına, `encode(email,'base64')` sonucu gibi base64 bir PII değeri ver → maske regex'i yakalamaz → **BYPASSED beklenir** (bilinen gerçek delik; harness'in görevi bunu DOĞRU tespit etmek).
|
|
70
|
-
|
|
71
|
-
## 7. Sınıflandırma Mantığı
|
|
72
|
-
- Sorgu-zamanı: `guardQuery` **PolicyError fırlattıysa** → DEFENDED. Fırlatmadıysa (yetkisiz erişim/write geçtiyse) → BYPASSED.
|
|
73
|
-
- Sonuç-zamanı: sahte sonuç satırı `redact`'ten geçir; PII string'i çıktıda **`[MASKED_PII]` değilse** → BYPASSED (sızıntı).
|
|
74
|
-
|
|
75
|
-
## 8. Test Stratejisi (TDD)
|
|
76
|
-
- Her saldırı case'i için birim test: bilinen-savunulan case DEFENDED döner; encode-base64 case BYPASSED döner (harness'in bypass'ı DOĞRU yakaladığını kanıtlar — Conarium'u değil, harness'i test eder).
|
|
77
|
-
- `runner` testi: karışık case seti → doğru defended/bypassed sayısı.
|
|
78
|
-
- `report` testi: bulgu içeren rapor Markdown'da BYPASSED'ları listeler.
|
|
79
|
-
|
|
80
|
-
## 9. Başarı Kriteri (MVP "bitti")
|
|
81
|
-
Gerçek `Governance` + örnek policy ile `runRedTeam` çalışınca:
|
|
82
|
-
1. En az write-smuggle **DEFENDED**, encode-base64 PII-exfil **BYPASSED** doğru sınıflanır.
|
|
83
|
-
2. Markdown + JSON rapor üretilir (Conarium'un savunma karnesi).
|
|
84
|
-
3. Testler geçer.
|
|
85
|
-
4. Çıktı, Faz 1 demosunun ham materyali olur ("NEO N saldırdı, Conarium X savundu, Y bypass — işte sertleştirilecekler").
|
|
86
|
-
|
|
87
|
-
## 10. Bağımlılık
|
|
88
|
-
- `@conarium-ai/core` `Governance` sınıfı (aynı repo, `src/governance.ts`).
|
|
89
|
-
- Test runner: vitest (yoksa eklenir).
|
|
90
|
-
- Ek dış bağımlılık yok.
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
# MSSQL — bugünkü (Postgres) koruma nasıl atlatılır
|
|
2
|
-
|
|
3
|
-
Kod yokken, `pgsql-ast-parser` + `WRITE_TOKENS` ile T-SQL okunursa.
|
|
4
|
-
Bu belge D’den önce yazıldı. Destek iddiası değil.
|
|
5
|
-
|
|
6
|
-
| Fark | Atlatma (parser Postgres varsayarsa) | Bu turdaki kural |
|
|
7
|
-
|---|---|---|
|
|
8
|
-
| Köşeli parantez `[Customers]` | Postgres tırnak kuralı `[` görmez. `[secrets]` string veya bilinmeyen token olabilir. | Parantezli ad çözülür; 3–4 parça ve linked server **deny**. |
|
|
9
|
-
| `TOP` vs `LIMIT` | `LIMIT` yok diye satır tavanı sessizce uygulanmaz. `TOP 100 PERCENT` tavan değil. | `TOP 100 PERCENT` **deny**. `TOP n` n>cap ise cap’e çekilir. Yoksa `TOP (cap)` eklenir. |
|
|
10
|
-
| Şema / sahip `dbo` | `public.customers` allow-list `dbo.customers` ile eşleşmez (ters hata) veya 4 parça düşer. | MSSQL politikası `dbo.*`. `server.db.schema.table` **deny**. Niteliksiz **deny**. |
|
|
11
|
-
| `GO` | Batch ayırıcı; parser tek SELECT görüp gerisini yutabilir. | `\bGO\b` **deny**. |
|
|
12
|
-
| `;` çok ifade | İkinci ifade yazma olabilir. | Birden fazla ifade **deny**. |
|
|
13
|
-
| `xp_*` / `sp_*` | Fonksiyon allow-list Postgres adları. `xp_cmdshell` geçer gibi durur. | `xp_` / `sp_` **deny** (parse öncesi). |
|
|
14
|
-
| `OPENROWSET` / `OPENQUERY` | Tablo gibi durur; `inspectFunction` görmez. | İsim **deny**. |
|
|
15
|
-
| `FOR XML` / `FOR JSON` | SELECT soneki, fonksiyon değil. | **deny**. |
|
|
16
|
-
| `EXEC` / `EXECUTE` | `\bCALL\b` yakalamaz. | **deny**. |
|
|
17
|
-
| Yorum / string | `--` ve `/* */` Postgres ile aynı sınıf; kaçış `]` `]]`. | Parse başarısız → **deny**. |
|
|
18
|
-
|
|
19
|
-
**Ayrıştırıcı:** `node-sql-parser` (yalnız `transactsql` build).
|
|
20
|
-
Gerekçe: T-SQL AST + sqlify. Bakım riski: Microsoft parser’ı değil; PEG. Bilmediği düğüm **deny**, “bilmiyorum = izin” yok.
|
|
21
|
-
|
|
22
|
-
## Parser’ın kabul edip kapının reddettiği (bu turda bulundu)
|
|
23
|
-
|
|
24
|
-
Savunma gevşetilmedi. Pre-deny / tip kontrolü şart:
|
|
25
|
-
|
|
26
|
-
| Girdi | Parser | Kapı |
|
|
27
|
-
|---|---|---|
|
|
28
|
-
| `… customers GO` | parse OK; `GO` tablo takma adı oluyor | `\bGO\b` deny |
|
|
29
|
-
| `OPENROWSET` | parse OK; `tableList` **boş** | isim deny (yalnız tableList = sessiz atlatma) |
|
|
30
|
-
| `not sql` (kısa) | parse OK; `type: assign` | select olmayan tip deny |
|
|
31
|
-
| `not sql at all !!!` | parse fail | parse fail → deny |
|
|
32
|
-
| `SELECT …; SELECT 1` | ast dizi uzunluğu 2 | çok ifade deny |
|
|
33
|
-
| `TOP 100 PERCENT` | parse OK | PERCENT deny |
|
|
34
|
-
| `SELECT id INTO x …` | parse OK | `into.type === 'into'` deny |
|
|
35
|
-
| 4 parça `server.db.dbo.t` | parse OK | `server` / 3+ parça deny |
|
|
36
|
-
|
|
37
|
-
UNION’da `TOP` yalnız ilk SELECT’e biner. Kapı UNION’ı `SELECT TOP n * FROM (… )` ile sarar.
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
# Oracle — bugünkü (Postgres) koruma nasıl atlatılır
|
|
2
|
-
|
|
3
|
-
Kod yokken, `pgsql-ast-parser` + `WRITE_TOKENS` ile Oracle SQL okunursa.
|
|
4
|
-
Bu belge E’den önce yazıldı. Destek iddiası değil.
|
|
5
|
-
|
|
6
|
-
| Fark | Atlatma (parser Postgres varsayarsa) | Bu turdaki kural |
|
|
7
|
-
|---|---|---|
|
|
8
|
-
| Tırnak / büyük-küçük | Oracle tırnaksız adı UPPER fold eder. `"secrets"` ≠ `SECRETS`. Postgres tırnak kuralı yanlış eşleşir. | Fold + tırnaklı ad çözülür; niteliksiz **deny**. |
|
|
9
|
-
| Şema = kullanıcı | `public.customers` allow-list `APP.CUSTOMERS` ile eşleşmez. | Oracle politikası `app.*`. |
|
|
10
|
-
| `ROWNUM` / `FETCH FIRST` | `LIMIT` yok diye tavan sessizce uygulanmaz. `ROWNUM <= 9999` tavan değil. | `FETCH FIRST n ROWS ONLY` n>cap ise cap. `ROWNUM` **deny** (satır tavanı değil, predicate). |
|
|
11
|
-
| Analitik / pencere | `ROW_NUMBER() OVER` ile dışarıdan LIMIT taklidi. | Pencere fonksiyonu satır tavanı sayılmaz; dış `FETCH FIRST` zorunlu. |
|
|
12
|
-
| `UTL_*` / `DBMS_*` | Fonksiyon allow-list Postgres adları. Ağ/dosya çağrısı geçer gibi durur. | `UTL_` / `DBMS_` **deny** (parse öncesi). |
|
|
13
|
-
| `BEGIN…END` | Anonim blok; parser SELECT görmeyebilir veya yutabilir. | SELECT/WITH olmayan **deny**. |
|
|
14
|
-
| Yorum / string | `--` `/* */` q-quote `q'!...!'`. | Parse başarısız → **deny**. |
|
|
15
|
-
| Synonym | Parser taban tabloyu görmez; allow-list synonym adına bakar. | **Kapanmaz.** Operatör allow-list’e koyduğu adı görür, hedefi değil. LIMITATIONS’ta dürüst kal. |
|
|
16
|
-
| DB link `table@dblink` | Uzak tablo yerel gibi durur. | `@` **deny**. |
|
|
17
|
-
|
|
18
|
-
**Ayrıştırıcı:** `node-sql-parser` 5.4.0’da Oracle build **yok**.
|
|
19
|
-
Bunun yerine `@guanmingchiu/sqlparser-ts` 0.62 (`sqlparser-rs` WASM, lehçe `oracle`).
|
|
20
|
-
Gerekçe: gerçek Oracle AST. Bakım: genç sarmalayıcı, upstream Apache sqlparser-rs.
|
|
21
|
-
`format()` AST→SQL bu sürümde çalışmıyor; satır tavanı orijinal SQL’i `FETCH FIRST n` ile sarar.
|
|
22
|
-
Bilmediği girdi **deny**. Synonym hedefi **kapanmaz**.
|
|
23
|
-
|
|
24
|
-
## Canlı örnek (kabul 2) — 2026-08-14 19:36
|
|
25
|
-
|
|
26
|
-
İlk tur: `--memory=2g` + init sırasında exec/stop. Log: `CONTAINER: shutdown request received` (SIGTERM). `OOMKilled=false`. Yarım init → `ORA-01109`.
|
|
27
|
-
Bu tur: bellek tavanı yok, `--shm-size=1g`, named volume, init bitene kadar dokunulmadı. ~1 dk’da `DATABASE IS READY TO USE` + `APP_USER`. `PASS oracle-live`: 80→50, secrets dolu+deny, garbage deny.
|
|
28
|
-
Emit: `_conarium_cap` Oracle’da yasadışı tanımlayıcı (`ORA-00911`); `conarium_cap` oldu.
|