@selfauth/conformance 0.0.0-stage → 0.1.0

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.
Files changed (50) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +16 -2
  3. package/cases/admin.json +326 -0
  4. package/cases/audit-and-errors.json +233 -0
  5. package/cases/csrf.json +413 -0
  6. package/cases/email-verification.json +567 -0
  7. package/cases/identity.json +546 -0
  8. package/cases/login.json +446 -0
  9. package/cases/logout.json +213 -0
  10. package/cases/password-change.json +270 -0
  11. package/cases/password-reset.json +698 -0
  12. package/cases/rate-limits.json +667 -0
  13. package/cases/rbac.json +575 -0
  14. package/cases/registration.json +782 -0
  15. package/cases/resources.json +373 -0
  16. package/cases/sessions.json +308 -0
  17. package/dist/coverage.d.ts +26 -0
  18. package/dist/coverage.d.ts.map +1 -0
  19. package/dist/coverage.js +105 -0
  20. package/dist/coverage.js.map +1 -0
  21. package/dist/index.d.ts +7 -0
  22. package/dist/index.d.ts.map +1 -0
  23. package/dist/index.js +7 -0
  24. package/dist/index.js.map +1 -0
  25. package/dist/load.d.ts +12 -0
  26. package/dist/load.d.ts.map +1 -0
  27. package/dist/load.js +26 -0
  28. package/dist/load.js.map +1 -0
  29. package/dist/report.d.ts +3 -0
  30. package/dist/report.d.ts.map +1 -0
  31. package/dist/report.js +31 -0
  32. package/dist/report.js.map +1 -0
  33. package/dist/runner/assertions.d.ts +11 -0
  34. package/dist/runner/assertions.d.ts.map +1 -0
  35. package/dist/runner/assertions.js +253 -0
  36. package/dist/runner/assertions.js.map +1 -0
  37. package/dist/runner/driver.d.ts +58 -0
  38. package/dist/runner/driver.d.ts.map +1 -0
  39. package/dist/runner/driver.js +2 -0
  40. package/dist/runner/driver.js.map +1 -0
  41. package/dist/runner/run.d.ts +17 -0
  42. package/dist/runner/run.d.ts.map +1 -0
  43. package/dist/runner/run.js +390 -0
  44. package/dist/runner/run.js.map +1 -0
  45. package/dist/schema.d.ts +168 -0
  46. package/dist/schema.d.ts.map +1 -0
  47. package/dist/schema.js +121 -0
  48. package/dist/schema.js.map +1 -0
  49. package/package.json +53 -3
  50. package/verification.json +165 -0
@@ -0,0 +1,446 @@
1
+ {
2
+ "cases": [
3
+ {
4
+ "id": "CT-LOGIN-001",
5
+ "title": "Successful login creates a session and returns the current user",
6
+ "category": "login",
7
+ "level": "core",
8
+ "requirements": ["AUTHN-LOGIN-001", "AUTHN-LOGIN-008", "AUTHN-LOGIN-009", "AUTHN-ME-001"],
9
+ "given": [
10
+ {
11
+ "user": "alice",
12
+ "email": "alice@example.test",
13
+ "password": "correct horse battery staple",
14
+ "state": "active"
15
+ }
16
+ ],
17
+ "steps": [
18
+ {
19
+ "op": "login",
20
+ "input": {
21
+ "email": "alice@example.test",
22
+ "password": "correct horse battery staple"
23
+ },
24
+ "expect": {
25
+ "outcome": "success",
26
+ "sessionCreated": true,
27
+ "assert": {
28
+ "body.user.email": "alice@example.test"
29
+ }
30
+ }
31
+ },
32
+ {
33
+ "op": "getCurrentUser",
34
+ "expect": {
35
+ "outcome": "success",
36
+ "assert": {
37
+ "body.user.id": "$alice.id",
38
+ "bodyHasPath": [
39
+ "user.emailVerified",
40
+ "user.state",
41
+ "user.roles",
42
+ "user.permissions",
43
+ "session.idleExpiresAt",
44
+ "session.absoluteExpiresAt"
45
+ ]
46
+ }
47
+ }
48
+ },
49
+ {
50
+ "op": "inspectEvents",
51
+ "input": {
52
+ "type": "auth.login.succeeded"
53
+ },
54
+ "expect": {
55
+ "outcome": "success",
56
+ "assert": {
57
+ "count": 1,
58
+ "last.userId": "$alice.id"
59
+ }
60
+ }
61
+ }
62
+ ]
63
+ },
64
+ {
65
+ "id": "CT-LOGIN-002",
66
+ "title": "Wrong password, unknown user, and deleted user are indistinguishable",
67
+ "category": "login",
68
+ "level": "core",
69
+ "requirements": [
70
+ "AUTHN-LOGIN-002",
71
+ "SEC-ENUM-001",
72
+ "ERR-FORMAT-004",
73
+ "AUTHN-LOGIN-008",
74
+ "SEC-AUDIT-003"
75
+ ],
76
+ "given": [
77
+ {
78
+ "user": "alice",
79
+ "email": "alice@example.test",
80
+ "password": "correct horse battery staple",
81
+ "state": "active"
82
+ },
83
+ {
84
+ "user": "gone",
85
+ "email": "gone@example.test",
86
+ "password": "correct horse battery staple",
87
+ "state": "deleted"
88
+ }
89
+ ],
90
+ "steps": [
91
+ {
92
+ "op": "login",
93
+ "input": {
94
+ "email": "alice@example.test",
95
+ "password": "wrong password!!"
96
+ },
97
+ "expect": {
98
+ "outcome": "error",
99
+ "code": "INVALID_CREDENTIALS",
100
+ "sessionCreated": false
101
+ },
102
+ "save": "wrong"
103
+ },
104
+ {
105
+ "op": "login",
106
+ "input": {
107
+ "email": "nobody@example.test",
108
+ "password": "wrong password!!"
109
+ },
110
+ "expect": {
111
+ "outcome": "error",
112
+ "code": "INVALID_CREDENTIALS",
113
+ "indistinguishableFrom": "wrong"
114
+ }
115
+ },
116
+ {
117
+ "op": "login",
118
+ "input": {
119
+ "email": "gone@example.test",
120
+ "password": "correct horse battery staple"
121
+ },
122
+ "expect": {
123
+ "outcome": "error",
124
+ "code": "INVALID_CREDENTIALS",
125
+ "indistinguishableFrom": "wrong"
126
+ }
127
+ },
128
+ {
129
+ "op": "inspectEvents",
130
+ "input": {
131
+ "type": "auth.login.failed"
132
+ },
133
+ "expect": {
134
+ "outcome": "success",
135
+ "assert": {
136
+ "count": 3,
137
+ "noFieldContaining": ["wrong password!!", "correct horse battery staple"]
138
+ }
139
+ }
140
+ }
141
+ ]
142
+ },
143
+ {
144
+ "id": "CT-LOGIN-003",
145
+ "title": "Pending accounts are revealed only after a correct password",
146
+ "category": "login",
147
+ "level": "core",
148
+ "requirements": ["AUTHN-LOGIN-004"],
149
+ "given": [
150
+ {
151
+ "user": "pending",
152
+ "email": "pending@example.test",
153
+ "password": "correct horse battery staple",
154
+ "state": "pending"
155
+ }
156
+ ],
157
+ "steps": [
158
+ {
159
+ "op": "login",
160
+ "input": {
161
+ "email": "pending@example.test",
162
+ "password": "wrong password!!"
163
+ },
164
+ "expect": {
165
+ "outcome": "error",
166
+ "code": "INVALID_CREDENTIALS"
167
+ }
168
+ },
169
+ {
170
+ "op": "login",
171
+ "input": {
172
+ "email": "pending@example.test",
173
+ "password": "correct horse battery staple"
174
+ },
175
+ "expect": {
176
+ "outcome": "error",
177
+ "code": "EMAIL_NOT_VERIFIED",
178
+ "sessionCreated": false
179
+ }
180
+ }
181
+ ]
182
+ },
183
+ {
184
+ "id": "CT-LOGIN-004",
185
+ "title": "Suspended and disabled accounts cannot log in",
186
+ "category": "login",
187
+ "level": "core",
188
+ "requirements": ["AUTHN-LOGIN-004"],
189
+ "given": [
190
+ {
191
+ "user": "susp",
192
+ "email": "susp@example.test",
193
+ "password": "correct horse battery staple",
194
+ "state": "suspended"
195
+ },
196
+ {
197
+ "user": "dis",
198
+ "email": "dis@example.test",
199
+ "password": "correct horse battery staple",
200
+ "state": "disabled"
201
+ }
202
+ ],
203
+ "steps": [
204
+ {
205
+ "op": "login",
206
+ "input": {
207
+ "email": "susp@example.test",
208
+ "password": "wrong password!!"
209
+ },
210
+ "expect": {
211
+ "outcome": "error",
212
+ "code": "INVALID_CREDENTIALS"
213
+ }
214
+ },
215
+ {
216
+ "op": "login",
217
+ "input": {
218
+ "email": "susp@example.test",
219
+ "password": "correct horse battery staple"
220
+ },
221
+ "expect": {
222
+ "outcome": "error",
223
+ "code": "ACCOUNT_UNAVAILABLE",
224
+ "sessionCreated": false
225
+ }
226
+ },
227
+ {
228
+ "op": "login",
229
+ "input": {
230
+ "email": "dis@example.test",
231
+ "password": "correct horse battery staple"
232
+ },
233
+ "expect": {
234
+ "outcome": "error",
235
+ "code": "ACCOUNT_UNAVAILABLE",
236
+ "sessionCreated": false
237
+ }
238
+ }
239
+ ]
240
+ },
241
+ {
242
+ "id": "CT-LOGIN-005",
243
+ "title": "Login issues a fresh session and never adopts a client-supplied token",
244
+ "category": "login",
245
+ "level": "core",
246
+ "requirements": ["AUTHN-LOGIN-005"],
247
+ "given": [
248
+ {
249
+ "user": "alice",
250
+ "email": "alice@example.test",
251
+ "password": "correct horse battery staple",
252
+ "state": "active"
253
+ }
254
+ ],
255
+ "steps": [
256
+ {
257
+ "op": "rawRequest",
258
+ "note": "plant a fixed token in the client",
259
+ "input": {
260
+ "setCookie": {
261
+ "name": "$config.sessionCookieName",
262
+ "value": "attacker-chosen-value"
263
+ }
264
+ }
265
+ },
266
+ {
267
+ "op": "login",
268
+ "input": {
269
+ "email": "alice@example.test",
270
+ "password": "correct horse battery staple"
271
+ },
272
+ "expect": {
273
+ "outcome": "success",
274
+ "sessionCreated": true,
275
+ "assert": {
276
+ "cookieValueNot": "attacker-chosen-value"
277
+ }
278
+ },
279
+ "save": "first"
280
+ },
281
+ {
282
+ "op": "login",
283
+ "note": "second login from the same client",
284
+ "input": {
285
+ "email": "alice@example.test",
286
+ "password": "correct horse battery staple"
287
+ },
288
+ "expect": {
289
+ "outcome": "success",
290
+ "sessionCreated": true,
291
+ "assert": {
292
+ "cookieValueNot": "$first.cookieValue"
293
+ }
294
+ }
295
+ },
296
+ {
297
+ "op": "inspectStorage",
298
+ "input": {
299
+ "entity": "session",
300
+ "where": {
301
+ "userId": "$alice.id",
302
+ "revokedAt": null
303
+ }
304
+ },
305
+ "expect": {
306
+ "outcome": "success",
307
+ "assert": {
308
+ "count": 1
309
+ }
310
+ }
311
+ }
312
+ ]
313
+ },
314
+ {
315
+ "id": "CT-LOGIN-006",
316
+ "title": "Passwords are NFKC-normalized but otherwise unaltered",
317
+ "category": "login",
318
+ "level": "core",
319
+ "requirements": ["SEC-HASH-005", "SEC-PWPOLICY-003"],
320
+ "given": [],
321
+ "steps": [
322
+ {
323
+ "op": "register",
324
+ "note": "fullwidth letters and a trailing space",
325
+ "input": {
326
+ "email": "nfkc@example.test",
327
+ "password": "password with spaces "
328
+ },
329
+ "expect": {
330
+ "outcome": "success"
331
+ }
332
+ },
333
+ {
334
+ "op": "readLastEmail",
335
+ "input": {
336
+ "to": "nfkc@example.test"
337
+ },
338
+ "save": "verifyMail"
339
+ },
340
+ {
341
+ "op": "verifyEmail",
342
+ "input": {
343
+ "token": "$verifyMail.token"
344
+ },
345
+ "expect": {
346
+ "outcome": "success"
347
+ }
348
+ },
349
+ {
350
+ "op": "login",
351
+ "note": "NFKC maps fullwidth letters to ASCII",
352
+ "input": {
353
+ "email": "nfkc@example.test",
354
+ "password": "password with spaces "
355
+ },
356
+ "expect": {
357
+ "outcome": "success"
358
+ }
359
+ },
360
+ {
361
+ "op": "login",
362
+ "note": "trailing space is significant",
363
+ "input": {
364
+ "email": "nfkc@example.test",
365
+ "password": "password with spaces"
366
+ },
367
+ "expect": {
368
+ "outcome": "error",
369
+ "code": "INVALID_CREDENTIALS"
370
+ }
371
+ },
372
+ {
373
+ "op": "login",
374
+ "note": "no case folding",
375
+ "input": {
376
+ "email": "nfkc@example.test",
377
+ "password": "PASSWORD with spaces "
378
+ },
379
+ "expect": {
380
+ "outcome": "error",
381
+ "code": "INVALID_CREDENTIALS"
382
+ }
383
+ }
384
+ ]
385
+ },
386
+ {
387
+ "id": "CT-LOGIN-007",
388
+ "title": "Authentication responses are not cacheable",
389
+ "category": "login",
390
+ "level": "core",
391
+ "requirements": ["AUTHN-ME-003", "SEC-HTTP-001"],
392
+ "given": [
393
+ {
394
+ "user": "alice",
395
+ "email": "alice@example.test",
396
+ "password": "correct horse battery staple",
397
+ "state": "active"
398
+ }
399
+ ],
400
+ "steps": [
401
+ {
402
+ "op": "login",
403
+ "input": {
404
+ "email": "alice@example.test",
405
+ "password": "correct horse battery staple"
406
+ },
407
+ "expect": {
408
+ "outcome": "success",
409
+ "assert": {
410
+ "header.cache-control": {
411
+ "contains": "no-store"
412
+ }
413
+ }
414
+ }
415
+ },
416
+ {
417
+ "op": "getCurrentUser",
418
+ "expect": {
419
+ "outcome": "success",
420
+ "assert": {
421
+ "header.cache-control": {
422
+ "contains": "no-store"
423
+ }
424
+ }
425
+ }
426
+ },
427
+ {
428
+ "op": "login",
429
+ "input": {
430
+ "email": "alice@example.test",
431
+ "password": "wrong password!!"
432
+ },
433
+ "expect": {
434
+ "outcome": "error",
435
+ "code": "INVALID_CREDENTIALS",
436
+ "assert": {
437
+ "header.cache-control": {
438
+ "contains": "no-store"
439
+ }
440
+ }
441
+ }
442
+ }
443
+ ]
444
+ }
445
+ ]
446
+ }
@@ -0,0 +1,213 @@
1
+ {
2
+ "cases": [
3
+ {
4
+ "id": "CT-LOGOUT-001",
5
+ "title": "Logout revokes the session server-side and expires the cookie",
6
+ "category": "logout",
7
+ "level": "core",
8
+ "requirements": ["AUTHN-LOGOUT-001", "AUTHN-LOGOUT-002", "AUTHN-SESS-006"],
9
+ "given": [
10
+ {
11
+ "user": "alice",
12
+ "email": "alice@example.test",
13
+ "password": "correct horse battery staple",
14
+ "state": "active"
15
+ }
16
+ ],
17
+ "steps": [
18
+ {
19
+ "op": "login",
20
+ "input": {
21
+ "email": "alice@example.test",
22
+ "password": "correct horse battery staple"
23
+ },
24
+ "save": "sess"
25
+ },
26
+ {
27
+ "op": "logout",
28
+ "expect": {
29
+ "outcome": "success",
30
+ "assert": {
31
+ "cookieCleared": true
32
+ }
33
+ }
34
+ },
35
+ {
36
+ "op": "rawRequest",
37
+ "note": "replay the old token directly",
38
+ "input": {
39
+ "operation": "getCurrentUser",
40
+ "cookie": "$sess.cookieValue"
41
+ },
42
+ "expect": {
43
+ "outcome": "error",
44
+ "code": "UNAUTHENTICATED"
45
+ }
46
+ },
47
+ {
48
+ "op": "inspectEvents",
49
+ "input": {
50
+ "type": "auth.logout"
51
+ },
52
+ "expect": {
53
+ "outcome": "success",
54
+ "assert": {
55
+ "count": 1
56
+ }
57
+ }
58
+ }
59
+ ]
60
+ },
61
+ {
62
+ "id": "CT-LOGOUT-002",
63
+ "title": "Logout is idempotent and reveals nothing without a session",
64
+ "category": "logout",
65
+ "level": "core",
66
+ "requirements": ["AUTHN-LOGOUT-003"],
67
+ "given": [
68
+ {
69
+ "user": "alice",
70
+ "email": "alice@example.test",
71
+ "password": "correct horse battery staple",
72
+ "state": "active"
73
+ }
74
+ ],
75
+ "steps": [
76
+ {
77
+ "op": "logout",
78
+ "as": "stranger",
79
+ "expect": {
80
+ "outcome": "success"
81
+ },
82
+ "save": "anon"
83
+ },
84
+ {
85
+ "op": "login",
86
+ "input": {
87
+ "email": "alice@example.test",
88
+ "password": "correct horse battery staple"
89
+ }
90
+ },
91
+ {
92
+ "op": "logout",
93
+ "expect": {
94
+ "outcome": "success"
95
+ }
96
+ },
97
+ {
98
+ "op": "logout",
99
+ "expect": {
100
+ "outcome": "success",
101
+ "indistinguishableFrom": "anon"
102
+ }
103
+ }
104
+ ]
105
+ },
106
+ {
107
+ "id": "CT-LOGOUT-003",
108
+ "title": "Logout cannot be triggered with a safe method",
109
+ "category": "logout",
110
+ "level": "core",
111
+ "requirements": ["AUTHN-LOGOUT-004", "SEC-CSRF-002"],
112
+ "given": [
113
+ {
114
+ "user": "alice",
115
+ "email": "alice@example.test",
116
+ "password": "correct horse battery staple",
117
+ "state": "active"
118
+ }
119
+ ],
120
+ "steps": [
121
+ {
122
+ "op": "login",
123
+ "input": {
124
+ "email": "alice@example.test",
125
+ "password": "correct horse battery staple"
126
+ }
127
+ },
128
+ {
129
+ "op": "rawRequest",
130
+ "note": "any response; must not change state",
131
+ "input": {
132
+ "method": "GET",
133
+ "operation": "logout"
134
+ }
135
+ },
136
+ {
137
+ "op": "getCurrentUser",
138
+ "expect": {
139
+ "outcome": "success"
140
+ }
141
+ }
142
+ ]
143
+ },
144
+ {
145
+ "id": "CT-LOGOUT-004",
146
+ "title": "Logout from all devices revokes every session including the current one",
147
+ "category": "logout",
148
+ "level": "core",
149
+ "requirements": ["AUTHN-LOGOUT-005", "AUTHN-LOGOUT-006", "AUTHN-SESS-006"],
150
+ "given": [
151
+ {
152
+ "user": "alice",
153
+ "email": "alice@example.test",
154
+ "password": "correct horse battery staple",
155
+ "state": "active"
156
+ }
157
+ ],
158
+ "steps": [
159
+ {
160
+ "op": "login",
161
+ "as": "laptop",
162
+ "input": {
163
+ "email": "alice@example.test",
164
+ "password": "correct horse battery staple"
165
+ }
166
+ },
167
+ {
168
+ "op": "login",
169
+ "as": "phone",
170
+ "input": {
171
+ "email": "alice@example.test",
172
+ "password": "correct horse battery staple"
173
+ }
174
+ },
175
+ {
176
+ "op": "logoutAll",
177
+ "as": "laptop",
178
+ "expect": {
179
+ "outcome": "success"
180
+ }
181
+ },
182
+ {
183
+ "op": "getCurrentUser",
184
+ "as": "laptop",
185
+ "expect": {
186
+ "outcome": "error",
187
+ "code": "UNAUTHENTICATED"
188
+ }
189
+ },
190
+ {
191
+ "op": "getCurrentUser",
192
+ "as": "phone",
193
+ "expect": {
194
+ "outcome": "error",
195
+ "code": "UNAUTHENTICATED"
196
+ }
197
+ },
198
+ {
199
+ "op": "inspectEvents",
200
+ "input": {
201
+ "type": "auth.sessions.revoked_all"
202
+ },
203
+ "expect": {
204
+ "outcome": "success",
205
+ "assert": {
206
+ "count": 1
207
+ }
208
+ }
209
+ }
210
+ ]
211
+ }
212
+ ]
213
+ }