@claude-flow/security 3.0.0-alpha.1 → 3.0.0-alpha.7
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/README.md +234 -234
- package/__tests__/acceptance/security-compliance.test.ts +674 -674
- package/__tests__/credential-generator.test.ts +310 -310
- package/__tests__/fixtures/configurations.ts +425 -419
- package/__tests__/fixtures/index.ts +21 -21
- package/__tests__/helpers/create-mock.ts +469 -469
- package/__tests__/helpers/index.ts +32 -32
- package/__tests__/input-validator.test.ts +382 -381
- package/__tests__/integration/security-flow.test.ts +606 -606
- package/__tests__/password-hasher.test.ts +239 -239
- package/__tests__/path-validator.test.ts +302 -302
- package/__tests__/safe-executor.test.ts +292 -292
- package/__tests__/token-generator.test.ts +371 -371
- package/__tests__/unit/credential-generator.test.ts +182 -182
- package/__tests__/unit/password-hasher.test.ts +359 -359
- package/__tests__/unit/path-validator.test.ts +509 -509
- package/__tests__/unit/safe-executor.test.ts +667 -667
- package/__tests__/unit/token-generator.test.ts +310 -310
- package/dist/credential-generator.js +9 -9
- package/dist/domain/services/security-domain-service.js +1 -1
- package/dist/domain/services/security-domain-service.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/password-hasher.d.ts.map +1 -1
- package/dist/password-hasher.js +8 -1
- package/dist/password-hasher.js.map +1 -1
- package/dist/safe-executor.d.ts +7 -0
- package/dist/safe-executor.d.ts.map +1 -1
- package/dist/safe-executor.js +21 -1
- package/dist/safe-executor.js.map +1 -1
- package/package.json +27 -28
- package/src/CVE-REMEDIATION.ts +251 -251
- package/src/application/index.ts +10 -10
- package/src/application/services/security-application-service.ts +193 -193
- package/src/credential-generator.ts +368 -368
- package/src/domain/entities/security-context.ts +173 -173
- package/src/domain/index.ts +17 -17
- package/src/domain/services/security-domain-service.ts +296 -296
- package/src/index.ts +271 -271
- package/src/input-validator.ts +466 -466
- package/src/password-hasher.ts +277 -270
- package/src/path-validator.ts +525 -525
- package/src/safe-executor.ts +546 -525
- package/src/token-generator.ts +463 -463
- package/tmp.json +0 -0
- package/tsconfig.json +9 -9
- package/tsconfig.tsbuildinfo +1 -1
- package/vitest.config.ts +20 -0
- package/.agentic-flow/intelligence.json +0 -16
- package/__tests__/coverage/base.css +0 -224
- package/__tests__/coverage/block-navigation.js +0 -87
- package/__tests__/coverage/coverage-final.json +0 -11
- package/__tests__/coverage/favicon.png +0 -0
- package/__tests__/coverage/index.html +0 -161
- package/__tests__/coverage/lcov-report/base.css +0 -224
- package/__tests__/coverage/lcov-report/block-navigation.js +0 -87
- package/__tests__/coverage/lcov-report/favicon.png +0 -0
- package/__tests__/coverage/lcov-report/index.html +0 -161
- package/__tests__/coverage/lcov-report/prettify.css +0 -1
- package/__tests__/coverage/lcov-report/prettify.js +0 -2
- package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
- package/__tests__/coverage/lcov-report/sorter.js +0 -210
- package/__tests__/coverage/lcov-report/src/CVE-REMEDIATION.ts.html +0 -838
- package/__tests__/coverage/lcov-report/src/application/services/index.html +0 -116
- package/__tests__/coverage/lcov-report/src/application/services/security-application-service.ts.html +0 -664
- package/__tests__/coverage/lcov-report/src/credential-generator.ts.html +0 -1189
- package/__tests__/coverage/lcov-report/src/domain/entities/index.html +0 -116
- package/__tests__/coverage/lcov-report/src/domain/entities/security-context.ts.html +0 -604
- package/__tests__/coverage/lcov-report/src/domain/services/index.html +0 -116
- package/__tests__/coverage/lcov-report/src/domain/services/security-domain-service.ts.html +0 -973
- package/__tests__/coverage/lcov-report/src/index.html +0 -206
- package/__tests__/coverage/lcov-report/src/input-validator.ts.html +0 -1483
- package/__tests__/coverage/lcov-report/src/password-hasher.ts.html +0 -895
- package/__tests__/coverage/lcov-report/src/path-validator.ts.html +0 -1660
- package/__tests__/coverage/lcov-report/src/safe-executor.ts.html +0 -1660
- package/__tests__/coverage/lcov-report/src/token-generator.ts.html +0 -1474
- package/__tests__/coverage/lcov.info +0 -3650
- package/__tests__/coverage/prettify.css +0 -1
- package/__tests__/coverage/prettify.js +0 -2
- package/__tests__/coverage/sort-arrow-sprite.png +0 -0
- package/__tests__/coverage/sorter.js +0 -210
- package/__tests__/coverage/src/CVE-REMEDIATION.ts.html +0 -838
- package/__tests__/coverage/src/application/services/index.html +0 -116
- package/__tests__/coverage/src/application/services/security-application-service.ts.html +0 -664
- package/__tests__/coverage/src/credential-generator.ts.html +0 -1189
- package/__tests__/coverage/src/domain/entities/index.html +0 -116
- package/__tests__/coverage/src/domain/entities/security-context.ts.html +0 -604
- package/__tests__/coverage/src/domain/services/index.html +0 -116
- package/__tests__/coverage/src/domain/services/security-domain-service.ts.html +0 -973
- package/__tests__/coverage/src/index.html +0 -206
- package/__tests__/coverage/src/input-validator.ts.html +0 -1483
- package/__tests__/coverage/src/password-hasher.ts.html +0 -895
- package/__tests__/coverage/src/path-validator.ts.html +0 -1660
- package/__tests__/coverage/src/safe-executor.ts.html +0 -1660
- package/__tests__/coverage/src/token-generator.ts.html +0 -1474
|
@@ -1,310 +1,310 @@
|
|
|
1
|
-
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
|
2
|
-
import { TokenGenerator, TokenGeneratorError } from '
|
|
3
|
-
|
|
4
|
-
describe('TokenGenerator', () => {
|
|
5
|
-
describe('cryptographically secure token generation', () => {
|
|
6
|
-
it('should generate tokens using crypto.randomBytes', () => {
|
|
7
|
-
const generator = new TokenGenerator();
|
|
8
|
-
const token = generator.generate();
|
|
9
|
-
|
|
10
|
-
// Token should be base64url encoded (default)
|
|
11
|
-
expect(token).toMatch(/^[A-Za-z0-9_-]+$/);
|
|
12
|
-
expect(token.length).toBeGreaterThan(0);
|
|
13
|
-
});
|
|
14
|
-
|
|
15
|
-
it('should generate tokens with specified length', () => {
|
|
16
|
-
const generator = new TokenGenerator();
|
|
17
|
-
|
|
18
|
-
// 16 bytes = 22 chars in base64url (without padding)
|
|
19
|
-
const token16 = generator.generate(16);
|
|
20
|
-
expect(token16.length).toBe(22);
|
|
21
|
-
|
|
22
|
-
// 32 bytes = 43 chars in base64url (without padding)
|
|
23
|
-
const token32 = generator.generate(32);
|
|
24
|
-
expect(token32.length).toBe(43);
|
|
25
|
-
});
|
|
26
|
-
|
|
27
|
-
it('should support different encodings', () => {
|
|
28
|
-
const hexGenerator = new TokenGenerator({ encoding: 'hex' });
|
|
29
|
-
const hexToken = hexGenerator.generate(16);
|
|
30
|
-
expect(hexToken).toMatch(/^[0-9a-f]+$/i);
|
|
31
|
-
expect(hexToken.length).toBe(32); // 16 bytes = 32 hex chars
|
|
32
|
-
|
|
33
|
-
const base64Generator = new TokenGenerator({ encoding: 'base64' });
|
|
34
|
-
const base64Token = base64Generator.generate(16);
|
|
35
|
-
expect(base64Token).toMatch(/^[A-Za-z0-9+/]+=*$/);
|
|
36
|
-
});
|
|
37
|
-
|
|
38
|
-
it('should reject token length below 16 bytes', () => {
|
|
39
|
-
expect(() => new TokenGenerator({ defaultLength: 8 }))
|
|
40
|
-
.toThrow('Token length must be at least 16 bytes');
|
|
41
|
-
});
|
|
42
|
-
});
|
|
43
|
-
|
|
44
|
-
describe('token uniqueness', () => {
|
|
45
|
-
it('should generate unique tokens each time', () => {
|
|
46
|
-
const generator = new TokenGenerator();
|
|
47
|
-
const tokens = new Set(Array.from({ length: 1000 }, () => generator.generate()));
|
|
48
|
-
expect(tokens.size).toBe(1000);
|
|
49
|
-
});
|
|
50
|
-
|
|
51
|
-
it('should generate unique session tokens', () => {
|
|
52
|
-
const generator = new TokenGenerator();
|
|
53
|
-
const tokens = new Set(Array.from({ length: 100 }, () => generator.generateSessionToken().value));
|
|
54
|
-
expect(tokens.size).toBe(100);
|
|
55
|
-
});
|
|
56
|
-
|
|
57
|
-
it('should generate unique verification codes', () => {
|
|
58
|
-
const generator = new TokenGenerator();
|
|
59
|
-
const codes = new Set(Array.from({ length: 100 }, () => generator.generateVerificationCode().code));
|
|
60
|
-
// Due to 6-digit codes, some collisions are possible but should be rare
|
|
61
|
-
expect(codes.size).toBeGreaterThan(90);
|
|
62
|
-
});
|
|
63
|
-
|
|
64
|
-
it('should generate unique request IDs', () => {
|
|
65
|
-
const generator = new TokenGenerator();
|
|
66
|
-
const ids = new Set(Array.from({ length: 1000 }, () => generator.generateRequestId()));
|
|
67
|
-
expect(ids.size).toBe(1000);
|
|
68
|
-
});
|
|
69
|
-
|
|
70
|
-
it('should generate unique correlation IDs', () => {
|
|
71
|
-
const generator = new TokenGenerator();
|
|
72
|
-
const ids = new Set(Array.from({ length: 1000 }, () => generator.generateCorrelationId()));
|
|
73
|
-
expect(ids.size).toBe(1000);
|
|
74
|
-
});
|
|
75
|
-
});
|
|
76
|
-
|
|
77
|
-
describe('timing-safe comparison', () => {
|
|
78
|
-
it('should return true for equal tokens', () => {
|
|
79
|
-
const generator = new TokenGenerator();
|
|
80
|
-
const token = generator.generate();
|
|
81
|
-
expect(generator.compare(token, token)).toBe(true);
|
|
82
|
-
});
|
|
83
|
-
|
|
84
|
-
it('should return false for different tokens', () => {
|
|
85
|
-
const generator = new TokenGenerator();
|
|
86
|
-
const token1 = generator.generate();
|
|
87
|
-
const token2 = generator.generate();
|
|
88
|
-
expect(generator.compare(token1, token2)).toBe(false);
|
|
89
|
-
});
|
|
90
|
-
|
|
91
|
-
it('should return false for different length strings', () => {
|
|
92
|
-
const generator = new TokenGenerator();
|
|
93
|
-
expect(generator.compare('short', 'muchlongerstring')).toBe(false);
|
|
94
|
-
});
|
|
95
|
-
|
|
96
|
-
it('should perform constant-time comparison', () => {
|
|
97
|
-
const generator = new TokenGenerator();
|
|
98
|
-
const token = 'a'.repeat(100);
|
|
99
|
-
|
|
100
|
-
// Compare with identical string should work
|
|
101
|
-
expect(generator.compare(token, token)).toBe(true);
|
|
102
|
-
|
|
103
|
-
// Compare with different strings at various positions
|
|
104
|
-
const differentAtStart = 'b' + 'a'.repeat(99);
|
|
105
|
-
const differentAtEnd = 'a'.repeat(99) + 'b';
|
|
106
|
-
|
|
107
|
-
expect(generator.compare(token, differentAtStart)).toBe(false);
|
|
108
|
-
expect(generator.compare(token, differentAtEnd)).toBe(false);
|
|
109
|
-
});
|
|
110
|
-
});
|
|
111
|
-
|
|
112
|
-
describe('signed tokens', () => {
|
|
113
|
-
it('should require HMAC secret for signed tokens', () => {
|
|
114
|
-
const generator = new TokenGenerator();
|
|
115
|
-
expect(() => generator.generateSignedToken({ userId: '123' }))
|
|
116
|
-
.toThrow('HMAC secret required for signed tokens');
|
|
117
|
-
});
|
|
118
|
-
|
|
119
|
-
it('should generate valid signed tokens', () => {
|
|
120
|
-
const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
|
|
121
|
-
const signed = generator.generateSignedToken({ userId: '123' });
|
|
122
|
-
|
|
123
|
-
expect(signed.token).toBeDefined();
|
|
124
|
-
expect(signed.signature).toBeDefined();
|
|
125
|
-
expect(signed.combined).toBe(`${signed.token}.${signed.signature}`);
|
|
126
|
-
expect(signed.createdAt).toBeInstanceOf(Date);
|
|
127
|
-
expect(signed.expiresAt).toBeInstanceOf(Date);
|
|
128
|
-
});
|
|
129
|
-
|
|
130
|
-
it('should verify valid signed tokens', () => {
|
|
131
|
-
const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
|
|
132
|
-
const signed = generator.generateSignedToken({ userId: '123', role: 'admin' });
|
|
133
|
-
|
|
134
|
-
const payload = generator.verifySignedToken(signed.combined);
|
|
135
|
-
expect(payload).not.toBeNull();
|
|
136
|
-
expect(payload!.userId).toBe('123');
|
|
137
|
-
expect(payload!.role).toBe('admin');
|
|
138
|
-
});
|
|
139
|
-
|
|
140
|
-
it('should reject tampered tokens', () => {
|
|
141
|
-
const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
|
|
142
|
-
const signed = generator.generateSignedToken({ userId: '123' });
|
|
143
|
-
|
|
144
|
-
// Tamper with signature
|
|
145
|
-
const tampered = signed.combined.slice(0, -5) + 'xxxxx';
|
|
146
|
-
expect(generator.verifySignedToken(tampered)).toBeNull();
|
|
147
|
-
});
|
|
148
|
-
|
|
149
|
-
it('should reject tokens with wrong secret', () => {
|
|
150
|
-
const generator1 = new TokenGenerator({ hmacSecret: 'secret-1' });
|
|
151
|
-
const generator2 = new TokenGenerator({ hmacSecret: 'secret-2' });
|
|
152
|
-
|
|
153
|
-
const signed = generator1.generateSignedToken({ userId: '123' });
|
|
154
|
-
expect(generator2.verifySignedToken(signed.combined)).toBeNull();
|
|
155
|
-
});
|
|
156
|
-
|
|
157
|
-
it('should reject expired signed tokens', async () => {
|
|
158
|
-
const generator = new TokenGenerator({ hmacSecret: 'test-secret' });
|
|
159
|
-
const signed = generator.generateSignedToken({ userId: '123' }, 0); // Expires immediately
|
|
160
|
-
|
|
161
|
-
// Wait a tiny bit for expiration
|
|
162
|
-
await new Promise(resolve => setTimeout(resolve, 10));
|
|
163
|
-
expect(generator.verifySignedToken(signed.combined)).toBeNull();
|
|
164
|
-
});
|
|
165
|
-
|
|
166
|
-
it('should reject malformed token format', () => {
|
|
167
|
-
const generator = new TokenGenerator({ hmacSecret: 'test-secret' });
|
|
168
|
-
|
|
169
|
-
expect(generator.verifySignedToken('no-dot-in-token')).toBeNull();
|
|
170
|
-
expect(generator.verifySignedToken('too.many.dots')).toBeNull();
|
|
171
|
-
expect(generator.verifySignedToken('')).toBeNull();
|
|
172
|
-
});
|
|
173
|
-
});
|
|
174
|
-
|
|
175
|
-
describe('token expiration', () => {
|
|
176
|
-
it('should create tokens with expiration', () => {
|
|
177
|
-
const generator = new TokenGenerator();
|
|
178
|
-
const token = generator.generateWithExpiration(3600);
|
|
179
|
-
|
|
180
|
-
expect(token.expiresAt.getTime()).toBe(token.createdAt.getTime() + 3600 * 1000);
|
|
181
|
-
});
|
|
182
|
-
|
|
183
|
-
it('should use default expiration', () => {
|
|
184
|
-
const generator = new TokenGenerator({ defaultExpiration: 7200 });
|
|
185
|
-
const token = generator.generateWithExpiration();
|
|
186
|
-
|
|
187
|
-
expect(token.expiresAt.getTime()).toBe(token.createdAt.getTime() + 7200 * 1000);
|
|
188
|
-
});
|
|
189
|
-
|
|
190
|
-
it('should correctly identify expired tokens', () => {
|
|
191
|
-
const generator = new TokenGenerator();
|
|
192
|
-
|
|
193
|
-
const expiredToken = {
|
|
194
|
-
value: 'test',
|
|
195
|
-
createdAt: new Date(Date.now() - 10000),
|
|
196
|
-
expiresAt: new Date(Date.now() - 5000),
|
|
197
|
-
};
|
|
198
|
-
expect(generator.isExpired(expiredToken)).toBe(true);
|
|
199
|
-
|
|
200
|
-
const validToken = {
|
|
201
|
-
value: 'test',
|
|
202
|
-
createdAt: new Date(),
|
|
203
|
-
expiresAt: new Date(Date.now() + 10000),
|
|
204
|
-
};
|
|
205
|
-
expect(generator.isExpired(validToken)).toBe(false);
|
|
206
|
-
});
|
|
207
|
-
});
|
|
208
|
-
|
|
209
|
-
describe('specialized token types', () => {
|
|
210
|
-
it('should generate session tokens with expiration', () => {
|
|
211
|
-
const generator = new TokenGenerator();
|
|
212
|
-
const token = generator.generateSessionToken();
|
|
213
|
-
|
|
214
|
-
expect(token.value).toBeDefined();
|
|
215
|
-
expect(token.expiresAt.getTime()).toBeGreaterThan(token.createdAt.getTime());
|
|
216
|
-
});
|
|
217
|
-
|
|
218
|
-
it('should generate CSRF tokens with 30-minute expiration', () => {
|
|
219
|
-
const generator = new TokenGenerator();
|
|
220
|
-
const token = generator.generateCsrfToken();
|
|
221
|
-
|
|
222
|
-
const expectedExpiry = token.createdAt.getTime() + 1800 * 1000;
|
|
223
|
-
expect(token.expiresAt.getTime()).toBe(expectedExpiry);
|
|
224
|
-
});
|
|
225
|
-
|
|
226
|
-
it('should generate API tokens with prefix and 1-year expiration', () => {
|
|
227
|
-
const generator = new TokenGenerator();
|
|
228
|
-
const token = generator.generateApiToken('api_');
|
|
229
|
-
|
|
230
|
-
expect(token.value.startsWith('api_')).toBe(true);
|
|
231
|
-
|
|
232
|
-
const oneYear = 365 * 24 * 60 * 60 * 1000;
|
|
233
|
-
expect(token.expiresAt.getTime()).toBeCloseTo(token.createdAt.getTime() + oneYear, -3);
|
|
234
|
-
});
|
|
235
|
-
|
|
236
|
-
it('should generate password reset tokens with 30-minute expiration', () => {
|
|
237
|
-
const generator = new TokenGenerator();
|
|
238
|
-
const token = generator.generatePasswordResetToken();
|
|
239
|
-
|
|
240
|
-
const expectedExpiry = token.createdAt.getTime() + 1800 * 1000;
|
|
241
|
-
expect(token.expiresAt.getTime()).toBe(expectedExpiry);
|
|
242
|
-
});
|
|
243
|
-
|
|
244
|
-
it('should generate email verification tokens with 24-hour expiration', () => {
|
|
245
|
-
const generator = new TokenGenerator();
|
|
246
|
-
const token = generator.generateEmailVerificationToken();
|
|
247
|
-
|
|
248
|
-
const expectedExpiry = token.createdAt.getTime() + 86400 * 1000;
|
|
249
|
-
expect(token.expiresAt.getTime()).toBe(expectedExpiry);
|
|
250
|
-
});
|
|
251
|
-
|
|
252
|
-
it('should generate token pairs (access + refresh)', () => {
|
|
253
|
-
const generator = new TokenGenerator();
|
|
254
|
-
const pair = generator.generateTokenPair();
|
|
255
|
-
|
|
256
|
-
expect(pair.accessToken).toBeDefined();
|
|
257
|
-
expect(pair.refreshToken).toBeDefined();
|
|
258
|
-
|
|
259
|
-
// Access token: 15 minutes
|
|
260
|
-
expect(pair.accessToken.expiresAt.getTime()).toBe(
|
|
261
|
-
pair.accessToken.createdAt.getTime() + 900 * 1000
|
|
262
|
-
);
|
|
263
|
-
|
|
264
|
-
// Refresh token: 7 days
|
|
265
|
-
expect(pair.refreshToken.expiresAt.getTime()).toBe(
|
|
266
|
-
pair.refreshToken.createdAt.getTime() + 604800 * 1000
|
|
267
|
-
);
|
|
268
|
-
});
|
|
269
|
-
});
|
|
270
|
-
|
|
271
|
-
describe('verification codes', () => {
|
|
272
|
-
it('should generate numeric codes of specified length', () => {
|
|
273
|
-
const generator = new TokenGenerator();
|
|
274
|
-
|
|
275
|
-
const code6 = generator.generateVerificationCode(6);
|
|
276
|
-
expect(code6.code).toMatch(/^\d{6}$/);
|
|
277
|
-
|
|
278
|
-
const code8 = generator.generateVerificationCode(8);
|
|
279
|
-
expect(code8.code).toMatch(/^\d{8}$/);
|
|
280
|
-
});
|
|
281
|
-
|
|
282
|
-
it('should set expiration and attempt limits', () => {
|
|
283
|
-
const generator = new TokenGenerator();
|
|
284
|
-
const code = generator.generateVerificationCode(6, 15, 5);
|
|
285
|
-
|
|
286
|
-
expect(code.attempts).toBe(0);
|
|
287
|
-
expect(code.maxAttempts).toBe(5);
|
|
288
|
-
expect(code.expiresAt.getTime()).toBe(code.createdAt.getTime() + 15 * 60 * 1000);
|
|
289
|
-
});
|
|
290
|
-
});
|
|
291
|
-
|
|
292
|
-
describe('correlation and request IDs', () => {
|
|
293
|
-
it('should generate short request IDs', () => {
|
|
294
|
-
const generator = new TokenGenerator();
|
|
295
|
-
const id = generator.generateRequestId();
|
|
296
|
-
|
|
297
|
-
// 8 bytes = 11 chars in base64url
|
|
298
|
-
expect(id.length).toBe(11);
|
|
299
|
-
});
|
|
300
|
-
|
|
301
|
-
it('should generate correlation IDs with timestamp prefix', () => {
|
|
302
|
-
const generator = new TokenGenerator();
|
|
303
|
-
const id = generator.generateCorrelationId();
|
|
304
|
-
|
|
305
|
-
expect(id).toMatch(/^[a-z0-9]+-[A-Za-z0-9_-]+$/);
|
|
306
|
-
const [timestamp] = id.split('-');
|
|
307
|
-
expect(parseInt(timestamp, 36)).toBeGreaterThan(0);
|
|
308
|
-
});
|
|
309
|
-
});
|
|
310
|
-
});
|
|
1
|
+
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
|
2
|
+
import { TokenGenerator, TokenGeneratorError } from '../../src/token-generator.js';
|
|
3
|
+
|
|
4
|
+
describe('TokenGenerator', () => {
|
|
5
|
+
describe('cryptographically secure token generation', () => {
|
|
6
|
+
it('should generate tokens using crypto.randomBytes', () => {
|
|
7
|
+
const generator = new TokenGenerator();
|
|
8
|
+
const token = generator.generate();
|
|
9
|
+
|
|
10
|
+
// Token should be base64url encoded (default)
|
|
11
|
+
expect(token).toMatch(/^[A-Za-z0-9_-]+$/);
|
|
12
|
+
expect(token.length).toBeGreaterThan(0);
|
|
13
|
+
});
|
|
14
|
+
|
|
15
|
+
it('should generate tokens with specified length', () => {
|
|
16
|
+
const generator = new TokenGenerator();
|
|
17
|
+
|
|
18
|
+
// 16 bytes = 22 chars in base64url (without padding)
|
|
19
|
+
const token16 = generator.generate(16);
|
|
20
|
+
expect(token16.length).toBe(22);
|
|
21
|
+
|
|
22
|
+
// 32 bytes = 43 chars in base64url (without padding)
|
|
23
|
+
const token32 = generator.generate(32);
|
|
24
|
+
expect(token32.length).toBe(43);
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
it('should support different encodings', () => {
|
|
28
|
+
const hexGenerator = new TokenGenerator({ encoding: 'hex' });
|
|
29
|
+
const hexToken = hexGenerator.generate(16);
|
|
30
|
+
expect(hexToken).toMatch(/^[0-9a-f]+$/i);
|
|
31
|
+
expect(hexToken.length).toBe(32); // 16 bytes = 32 hex chars
|
|
32
|
+
|
|
33
|
+
const base64Generator = new TokenGenerator({ encoding: 'base64' });
|
|
34
|
+
const base64Token = base64Generator.generate(16);
|
|
35
|
+
expect(base64Token).toMatch(/^[A-Za-z0-9+/]+=*$/);
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
it('should reject token length below 16 bytes', () => {
|
|
39
|
+
expect(() => new TokenGenerator({ defaultLength: 8 }))
|
|
40
|
+
.toThrow('Token length must be at least 16 bytes');
|
|
41
|
+
});
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
describe('token uniqueness', () => {
|
|
45
|
+
it('should generate unique tokens each time', () => {
|
|
46
|
+
const generator = new TokenGenerator();
|
|
47
|
+
const tokens = new Set(Array.from({ length: 1000 }, () => generator.generate()));
|
|
48
|
+
expect(tokens.size).toBe(1000);
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
it('should generate unique session tokens', () => {
|
|
52
|
+
const generator = new TokenGenerator();
|
|
53
|
+
const tokens = new Set(Array.from({ length: 100 }, () => generator.generateSessionToken().value));
|
|
54
|
+
expect(tokens.size).toBe(100);
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
it('should generate unique verification codes', () => {
|
|
58
|
+
const generator = new TokenGenerator();
|
|
59
|
+
const codes = new Set(Array.from({ length: 100 }, () => generator.generateVerificationCode().code));
|
|
60
|
+
// Due to 6-digit codes, some collisions are possible but should be rare
|
|
61
|
+
expect(codes.size).toBeGreaterThan(90);
|
|
62
|
+
});
|
|
63
|
+
|
|
64
|
+
it('should generate unique request IDs', () => {
|
|
65
|
+
const generator = new TokenGenerator();
|
|
66
|
+
const ids = new Set(Array.from({ length: 1000 }, () => generator.generateRequestId()));
|
|
67
|
+
expect(ids.size).toBe(1000);
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
it('should generate unique correlation IDs', () => {
|
|
71
|
+
const generator = new TokenGenerator();
|
|
72
|
+
const ids = new Set(Array.from({ length: 1000 }, () => generator.generateCorrelationId()));
|
|
73
|
+
expect(ids.size).toBe(1000);
|
|
74
|
+
});
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
describe('timing-safe comparison', () => {
|
|
78
|
+
it('should return true for equal tokens', () => {
|
|
79
|
+
const generator = new TokenGenerator();
|
|
80
|
+
const token = generator.generate();
|
|
81
|
+
expect(generator.compare(token, token)).toBe(true);
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
it('should return false for different tokens', () => {
|
|
85
|
+
const generator = new TokenGenerator();
|
|
86
|
+
const token1 = generator.generate();
|
|
87
|
+
const token2 = generator.generate();
|
|
88
|
+
expect(generator.compare(token1, token2)).toBe(false);
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
it('should return false for different length strings', () => {
|
|
92
|
+
const generator = new TokenGenerator();
|
|
93
|
+
expect(generator.compare('short', 'muchlongerstring')).toBe(false);
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
it('should perform constant-time comparison', () => {
|
|
97
|
+
const generator = new TokenGenerator();
|
|
98
|
+
const token = 'a'.repeat(100);
|
|
99
|
+
|
|
100
|
+
// Compare with identical string should work
|
|
101
|
+
expect(generator.compare(token, token)).toBe(true);
|
|
102
|
+
|
|
103
|
+
// Compare with different strings at various positions
|
|
104
|
+
const differentAtStart = 'b' + 'a'.repeat(99);
|
|
105
|
+
const differentAtEnd = 'a'.repeat(99) + 'b';
|
|
106
|
+
|
|
107
|
+
expect(generator.compare(token, differentAtStart)).toBe(false);
|
|
108
|
+
expect(generator.compare(token, differentAtEnd)).toBe(false);
|
|
109
|
+
});
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
describe('signed tokens', () => {
|
|
113
|
+
it('should require HMAC secret for signed tokens', () => {
|
|
114
|
+
const generator = new TokenGenerator();
|
|
115
|
+
expect(() => generator.generateSignedToken({ userId: '123' }))
|
|
116
|
+
.toThrow('HMAC secret required for signed tokens');
|
|
117
|
+
});
|
|
118
|
+
|
|
119
|
+
it('should generate valid signed tokens', () => {
|
|
120
|
+
const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
|
|
121
|
+
const signed = generator.generateSignedToken({ userId: '123' });
|
|
122
|
+
|
|
123
|
+
expect(signed.token).toBeDefined();
|
|
124
|
+
expect(signed.signature).toBeDefined();
|
|
125
|
+
expect(signed.combined).toBe(`${signed.token}.${signed.signature}`);
|
|
126
|
+
expect(signed.createdAt).toBeInstanceOf(Date);
|
|
127
|
+
expect(signed.expiresAt).toBeInstanceOf(Date);
|
|
128
|
+
});
|
|
129
|
+
|
|
130
|
+
it('should verify valid signed tokens', () => {
|
|
131
|
+
const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
|
|
132
|
+
const signed = generator.generateSignedToken({ userId: '123', role: 'admin' });
|
|
133
|
+
|
|
134
|
+
const payload = generator.verifySignedToken(signed.combined);
|
|
135
|
+
expect(payload).not.toBeNull();
|
|
136
|
+
expect(payload!.userId).toBe('123');
|
|
137
|
+
expect(payload!.role).toBe('admin');
|
|
138
|
+
});
|
|
139
|
+
|
|
140
|
+
it('should reject tampered tokens', () => {
|
|
141
|
+
const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
|
|
142
|
+
const signed = generator.generateSignedToken({ userId: '123' });
|
|
143
|
+
|
|
144
|
+
// Tamper with signature
|
|
145
|
+
const tampered = signed.combined.slice(0, -5) + 'xxxxx';
|
|
146
|
+
expect(generator.verifySignedToken(tampered)).toBeNull();
|
|
147
|
+
});
|
|
148
|
+
|
|
149
|
+
it('should reject tokens with wrong secret', () => {
|
|
150
|
+
const generator1 = new TokenGenerator({ hmacSecret: 'secret-1' });
|
|
151
|
+
const generator2 = new TokenGenerator({ hmacSecret: 'secret-2' });
|
|
152
|
+
|
|
153
|
+
const signed = generator1.generateSignedToken({ userId: '123' });
|
|
154
|
+
expect(generator2.verifySignedToken(signed.combined)).toBeNull();
|
|
155
|
+
});
|
|
156
|
+
|
|
157
|
+
it('should reject expired signed tokens', async () => {
|
|
158
|
+
const generator = new TokenGenerator({ hmacSecret: 'test-secret' });
|
|
159
|
+
const signed = generator.generateSignedToken({ userId: '123' }, 0); // Expires immediately
|
|
160
|
+
|
|
161
|
+
// Wait a tiny bit for expiration
|
|
162
|
+
await new Promise(resolve => setTimeout(resolve, 10));
|
|
163
|
+
expect(generator.verifySignedToken(signed.combined)).toBeNull();
|
|
164
|
+
});
|
|
165
|
+
|
|
166
|
+
it('should reject malformed token format', () => {
|
|
167
|
+
const generator = new TokenGenerator({ hmacSecret: 'test-secret' });
|
|
168
|
+
|
|
169
|
+
expect(generator.verifySignedToken('no-dot-in-token')).toBeNull();
|
|
170
|
+
expect(generator.verifySignedToken('too.many.dots')).toBeNull();
|
|
171
|
+
expect(generator.verifySignedToken('')).toBeNull();
|
|
172
|
+
});
|
|
173
|
+
});
|
|
174
|
+
|
|
175
|
+
describe('token expiration', () => {
|
|
176
|
+
it('should create tokens with expiration', () => {
|
|
177
|
+
const generator = new TokenGenerator();
|
|
178
|
+
const token = generator.generateWithExpiration(3600);
|
|
179
|
+
|
|
180
|
+
expect(token.expiresAt.getTime()).toBe(token.createdAt.getTime() + 3600 * 1000);
|
|
181
|
+
});
|
|
182
|
+
|
|
183
|
+
it('should use default expiration', () => {
|
|
184
|
+
const generator = new TokenGenerator({ defaultExpiration: 7200 });
|
|
185
|
+
const token = generator.generateWithExpiration();
|
|
186
|
+
|
|
187
|
+
expect(token.expiresAt.getTime()).toBe(token.createdAt.getTime() + 7200 * 1000);
|
|
188
|
+
});
|
|
189
|
+
|
|
190
|
+
it('should correctly identify expired tokens', () => {
|
|
191
|
+
const generator = new TokenGenerator();
|
|
192
|
+
|
|
193
|
+
const expiredToken = {
|
|
194
|
+
value: 'test',
|
|
195
|
+
createdAt: new Date(Date.now() - 10000),
|
|
196
|
+
expiresAt: new Date(Date.now() - 5000),
|
|
197
|
+
};
|
|
198
|
+
expect(generator.isExpired(expiredToken)).toBe(true);
|
|
199
|
+
|
|
200
|
+
const validToken = {
|
|
201
|
+
value: 'test',
|
|
202
|
+
createdAt: new Date(),
|
|
203
|
+
expiresAt: new Date(Date.now() + 10000),
|
|
204
|
+
};
|
|
205
|
+
expect(generator.isExpired(validToken)).toBe(false);
|
|
206
|
+
});
|
|
207
|
+
});
|
|
208
|
+
|
|
209
|
+
describe('specialized token types', () => {
|
|
210
|
+
it('should generate session tokens with expiration', () => {
|
|
211
|
+
const generator = new TokenGenerator();
|
|
212
|
+
const token = generator.generateSessionToken();
|
|
213
|
+
|
|
214
|
+
expect(token.value).toBeDefined();
|
|
215
|
+
expect(token.expiresAt.getTime()).toBeGreaterThan(token.createdAt.getTime());
|
|
216
|
+
});
|
|
217
|
+
|
|
218
|
+
it('should generate CSRF tokens with 30-minute expiration', () => {
|
|
219
|
+
const generator = new TokenGenerator();
|
|
220
|
+
const token = generator.generateCsrfToken();
|
|
221
|
+
|
|
222
|
+
const expectedExpiry = token.createdAt.getTime() + 1800 * 1000;
|
|
223
|
+
expect(token.expiresAt.getTime()).toBe(expectedExpiry);
|
|
224
|
+
});
|
|
225
|
+
|
|
226
|
+
it('should generate API tokens with prefix and 1-year expiration', () => {
|
|
227
|
+
const generator = new TokenGenerator();
|
|
228
|
+
const token = generator.generateApiToken('api_');
|
|
229
|
+
|
|
230
|
+
expect(token.value.startsWith('api_')).toBe(true);
|
|
231
|
+
|
|
232
|
+
const oneYear = 365 * 24 * 60 * 60 * 1000;
|
|
233
|
+
expect(token.expiresAt.getTime()).toBeCloseTo(token.createdAt.getTime() + oneYear, -3);
|
|
234
|
+
});
|
|
235
|
+
|
|
236
|
+
it('should generate password reset tokens with 30-minute expiration', () => {
|
|
237
|
+
const generator = new TokenGenerator();
|
|
238
|
+
const token = generator.generatePasswordResetToken();
|
|
239
|
+
|
|
240
|
+
const expectedExpiry = token.createdAt.getTime() + 1800 * 1000;
|
|
241
|
+
expect(token.expiresAt.getTime()).toBe(expectedExpiry);
|
|
242
|
+
});
|
|
243
|
+
|
|
244
|
+
it('should generate email verification tokens with 24-hour expiration', () => {
|
|
245
|
+
const generator = new TokenGenerator();
|
|
246
|
+
const token = generator.generateEmailVerificationToken();
|
|
247
|
+
|
|
248
|
+
const expectedExpiry = token.createdAt.getTime() + 86400 * 1000;
|
|
249
|
+
expect(token.expiresAt.getTime()).toBe(expectedExpiry);
|
|
250
|
+
});
|
|
251
|
+
|
|
252
|
+
it('should generate token pairs (access + refresh)', () => {
|
|
253
|
+
const generator = new TokenGenerator();
|
|
254
|
+
const pair = generator.generateTokenPair();
|
|
255
|
+
|
|
256
|
+
expect(pair.accessToken).toBeDefined();
|
|
257
|
+
expect(pair.refreshToken).toBeDefined();
|
|
258
|
+
|
|
259
|
+
// Access token: 15 minutes
|
|
260
|
+
expect(pair.accessToken.expiresAt.getTime()).toBe(
|
|
261
|
+
pair.accessToken.createdAt.getTime() + 900 * 1000
|
|
262
|
+
);
|
|
263
|
+
|
|
264
|
+
// Refresh token: 7 days
|
|
265
|
+
expect(pair.refreshToken.expiresAt.getTime()).toBe(
|
|
266
|
+
pair.refreshToken.createdAt.getTime() + 604800 * 1000
|
|
267
|
+
);
|
|
268
|
+
});
|
|
269
|
+
});
|
|
270
|
+
|
|
271
|
+
describe('verification codes', () => {
|
|
272
|
+
it('should generate numeric codes of specified length', () => {
|
|
273
|
+
const generator = new TokenGenerator();
|
|
274
|
+
|
|
275
|
+
const code6 = generator.generateVerificationCode(6);
|
|
276
|
+
expect(code6.code).toMatch(/^\d{6}$/);
|
|
277
|
+
|
|
278
|
+
const code8 = generator.generateVerificationCode(8);
|
|
279
|
+
expect(code8.code).toMatch(/^\d{8}$/);
|
|
280
|
+
});
|
|
281
|
+
|
|
282
|
+
it('should set expiration and attempt limits', () => {
|
|
283
|
+
const generator = new TokenGenerator();
|
|
284
|
+
const code = generator.generateVerificationCode(6, 15, 5);
|
|
285
|
+
|
|
286
|
+
expect(code.attempts).toBe(0);
|
|
287
|
+
expect(code.maxAttempts).toBe(5);
|
|
288
|
+
expect(code.expiresAt.getTime()).toBe(code.createdAt.getTime() + 15 * 60 * 1000);
|
|
289
|
+
});
|
|
290
|
+
});
|
|
291
|
+
|
|
292
|
+
describe('correlation and request IDs', () => {
|
|
293
|
+
it('should generate short request IDs', () => {
|
|
294
|
+
const generator = new TokenGenerator();
|
|
295
|
+
const id = generator.generateRequestId();
|
|
296
|
+
|
|
297
|
+
// 8 bytes = 11 chars in base64url
|
|
298
|
+
expect(id.length).toBe(11);
|
|
299
|
+
});
|
|
300
|
+
|
|
301
|
+
it('should generate correlation IDs with timestamp prefix', () => {
|
|
302
|
+
const generator = new TokenGenerator();
|
|
303
|
+
const id = generator.generateCorrelationId();
|
|
304
|
+
|
|
305
|
+
expect(id).toMatch(/^[a-z0-9]+-[A-Za-z0-9_-]+$/);
|
|
306
|
+
const [timestamp] = id.split('-');
|
|
307
|
+
expect(parseInt(timestamp, 36)).toBeGreaterThan(0);
|
|
308
|
+
});
|
|
309
|
+
});
|
|
310
|
+
});
|
|
@@ -223,15 +223,15 @@ export class CredentialGenerator {
|
|
|
223
223
|
* @returns Environment variable export script
|
|
224
224
|
*/
|
|
225
225
|
createEnvScript(credentials) {
|
|
226
|
-
return `# Claude Flow V3 - Generated Credentials
|
|
227
|
-
# Generated: ${credentials.generatedAt.toISOString()}
|
|
228
|
-
# IMPORTANT: Store these securely and delete this file after use
|
|
229
|
-
|
|
230
|
-
export CLAUDE_FLOW_ADMIN_PASSWORD="${credentials.adminPassword}"
|
|
231
|
-
export CLAUDE_FLOW_SERVICE_PASSWORD="${credentials.servicePassword}"
|
|
232
|
-
export CLAUDE_FLOW_JWT_SECRET="${credentials.jwtSecret}"
|
|
233
|
-
export CLAUDE_FLOW_SESSION_SECRET="${credentials.sessionSecret}"
|
|
234
|
-
export CLAUDE_FLOW_ENCRYPTION_KEY="${credentials.encryptionKey}"
|
|
226
|
+
return `# Claude Flow V3 - Generated Credentials
|
|
227
|
+
# Generated: ${credentials.generatedAt.toISOString()}
|
|
228
|
+
# IMPORTANT: Store these securely and delete this file after use
|
|
229
|
+
|
|
230
|
+
export CLAUDE_FLOW_ADMIN_PASSWORD="${credentials.adminPassword}"
|
|
231
|
+
export CLAUDE_FLOW_SERVICE_PASSWORD="${credentials.servicePassword}"
|
|
232
|
+
export CLAUDE_FLOW_JWT_SECRET="${credentials.jwtSecret}"
|
|
233
|
+
export CLAUDE_FLOW_SESSION_SECRET="${credentials.sessionSecret}"
|
|
234
|
+
export CLAUDE_FLOW_ENCRYPTION_KEY="${credentials.encryptionKey}"
|
|
235
235
|
`;
|
|
236
236
|
}
|
|
237
237
|
/**
|
|
@@ -229,7 +229,7 @@ export class SecurityDomainService {
|
|
|
229
229
|
permissions,
|
|
230
230
|
allowedPaths: customPaths ?? ['./src', './tests', './docs'],
|
|
231
231
|
blockedPaths: ['/etc', '/var', '~/', '../'],
|
|
232
|
-
allowedCommands: ['npm', '
|
|
232
|
+
allowedCommands: ['npm', 'node', 'git', 'vitest'],
|
|
233
233
|
blockedCommands: ['rm -rf /', 'dd', 'mkfs', 'format'],
|
|
234
234
|
});
|
|
235
235
|
}
|