@imolko/ultra-event-signature 0.4.0 → 0.4.1-beta
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-node/sign.d.ts.map +1 -1
- package/dist-node/sign.js +40 -0
- package/dist-node/sign.js.map +1 -1
- package/docs/emitter-checklist.md +10 -1
- package/package.json +1 -1
package/dist-node/sign.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiBjE,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAG3D;
|
|
1
|
+
{"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiBjE,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAG3D;AA2DD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CAqD7E"}
|
package/dist-node/sign.js
CHANGED
|
@@ -40,6 +40,40 @@ function validateKeyId(envelope, options) {
|
|
|
40
40
|
}
|
|
41
41
|
return undefined;
|
|
42
42
|
}
|
|
43
|
+
/**
|
|
44
|
+
* Rechaza la forma de `source` y de `comimolkotenant` que ninguna política
|
|
45
|
+
* aceptada por `parseTrustPolicy` podría autorizar jamás (02 §2, 03 §4).
|
|
46
|
+
*
|
|
47
|
+
* «Presente» significa `!== undefined`: la forma canónica omite los miembros
|
|
48
|
+
* con valor `undefined` (01 §3.5), así que `{ source: undefined }` es el mismo
|
|
49
|
+
* hecho que la ausencia. Devuelve como mucho un token, el primer fallo, en el
|
|
50
|
+
* orden de 03 §4: autor (paso 3) y tenencia (paso 5).
|
|
51
|
+
*/
|
|
52
|
+
function authorisabilityIssues(envelope) {
|
|
53
|
+
const source = envelope["source"];
|
|
54
|
+
if (source === undefined) {
|
|
55
|
+
return "missing:source";
|
|
56
|
+
}
|
|
57
|
+
if (typeof source !== "string" || source.length === 0) {
|
|
58
|
+
return "invalid:source";
|
|
59
|
+
}
|
|
60
|
+
if (source.includes("*")) {
|
|
61
|
+
return "invalid:source:wildcard";
|
|
62
|
+
}
|
|
63
|
+
// El vocabulario del `type` es de la política, no del firmador (03 §4): un
|
|
64
|
+
// `type` ausente o no textual ya falla más abajo, en la derivación del
|
|
65
|
+
// payload type, y la lista blanca la posee el documento de política.
|
|
66
|
+
// Un `comimolkotenant` presente que no es un string no vacío es un candidato
|
|
67
|
+
// que ningún scope puede contener, ni siquiera `all` (03 §4.5, PJ-005). El
|
|
68
|
+
// comodín sí es un candidato válido bajo `all`: la tenencia no es asunto del
|
|
69
|
+
// firmador, sólo su presencia y su forma.
|
|
70
|
+
const tenant = envelope["comimolkotenant"];
|
|
71
|
+
if (tenant !== undefined &&
|
|
72
|
+
(typeof tenant !== "string" || tenant.length === 0)) {
|
|
73
|
+
return "invalid:comimolkotenant";
|
|
74
|
+
}
|
|
75
|
+
return undefined;
|
|
76
|
+
}
|
|
43
77
|
/**
|
|
44
78
|
* Firma un hecho con Ed25519 y devuelve el sobre con `comimolkohash` y
|
|
45
79
|
* `securityToken`.
|
|
@@ -63,6 +97,12 @@ function signFact(envelope, options) {
|
|
|
63
97
|
if (declares(envelope, "comimolkohash")) {
|
|
64
98
|
return (0, errors_1.invalid)("existing:comimolkohash");
|
|
65
99
|
}
|
|
100
|
+
// Estructural y barata: precede al tipado del payload y a cualquier
|
|
101
|
+
// operación criptográfica, para que un sobre sin autor no llegue al digest.
|
|
102
|
+
const authorisabilityIssue = authorisabilityIssues(envelope);
|
|
103
|
+
if (authorisabilityIssue !== undefined) {
|
|
104
|
+
return (0, errors_1.invalid)(authorisabilityIssue);
|
|
105
|
+
}
|
|
66
106
|
const payloadType = (0, payload_type_1.factPayloadType)(envelope);
|
|
67
107
|
if (payloadType.kind !== "parsed") {
|
|
68
108
|
return { kind: "invalid", issues: payloadType.issues };
|
package/dist-node/sign.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sign.js","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":";;AAwBA,wCAGC;
|
|
1
|
+
{"version":3,"file":"sign.js","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":";;AAwBA,wCAGC;AAmED,4BAqDC;AAnJD,qDAAiD;AACjD,qCAAoD;AACpD,qCAAkD;AAClD,+BAA4B;AAC5B,yCAAyC;AACzC,iDAAiD;AAGjD;;;;;;;GAOG;AAEH,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B,qEAAqE;AACrE,MAAM,QAAQ,GAAG,CAAC,QAAkB,EAAE,MAAc,EAAW,EAAE,CAC/D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEzD,4DAA4D;AAC5D,SAAgB,cAAc,CAAC,QAAkB;IAC/C,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC;IAC7E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CACpB,QAAkB,EAClB,OAAoB;IAEpB,MAAM,aAAa,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,IAAA,gBAAO,EAAC,uBAAuB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,sBAAW,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAA,gBAAO,EAAC,uBAAuB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,sBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAA,gBAAO,EAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,aAAa,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,IAAA,gBAAO,EAAC,wBAAwB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,QAAkB;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,2EAA2E;IAC3E,uEAAuE;IACvE,qEAAqE;IACrE,6EAA6E;IAC7E,2EAA2E;IAC3E,6EAA6E;IAC7E,0CAA0C;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC3C,IACE,MAAM,KAAK,SAAS;QACpB,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,EACnD,CAAC;QACD,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,QAAQ,CAAC,QAAkB,EAAE,OAAoB;IAC/D,IAAI,CAAC;QACH,IAAI,CAAC,IAAA,sBAAa,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAA,gBAAO,EAAC,kBAAkB,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC;YACxC,OAAO,IAAA,gBAAO,EAAC,wBAAwB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC;YACxC,OAAO,IAAA,gBAAO,EAAC,wBAAwB,CAAC,CAAC;QAC3C,CAAC;QAED,oEAAoE;QACpE,4EAA4E;QAC5E,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;YACvC,OAAO,IAAA,gBAAO,EAAC,oBAAoB,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,8BAAe,EAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;QACzD,CAAC;QACD,MAAM,SAAS,GAAG,IAAA,8BAAa,EAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,IAAA,aAAI,EAAC,IAAA,SAAG,EAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAEzE,wEAAwE;QACxE,2EAA2E;QAC3E,sEAAsE;QACtE,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAa,CAAC;QAE9D,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE;gBACR,GAAG,aAAa;gBAChB,aAAa,EAAE,MAAM;gBACrB,aAAa,EAAE,IAAA,mBAAU,EAAC,SAAS,CAAC;aACrC;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAA,gBAAO,EAAC,eAAe,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}
|
|
@@ -30,7 +30,16 @@ one in [01 — wire format](spec/01-wire-format.md); the signing call is in
|
|
|
30
30
|
4. **Freeze `source`.** `source` is the author identity the policy binds to the
|
|
31
31
|
key. Changing it makes an emitter look like a different author and invalidates
|
|
32
32
|
the policy entry. Done when `source` is a constant of the emitter, not a
|
|
33
|
-
per-deployment or per-request value.
|
|
33
|
+
per-deployment or per-request value. Since `0.4.1` the library enforces the
|
|
34
|
+
shape, so this is a rule and not advice: `signFact` returns `invalid` with
|
|
35
|
+
`missing:source` when the envelope has no `source`, `invalid:source` when it is
|
|
36
|
+
present and not a non-empty string, and `invalid:source:wildcard` when it
|
|
37
|
+
contains `*` — before any cryptographic operation, so a forgotten or templated
|
|
38
|
+
author is never signed. A
|
|
39
|
+
`comimolkotenant` that is present and not a non-empty string is
|
|
40
|
+
`invalid:comimolkotenant`. Which `source` and `type` values are yours stay
|
|
41
|
+
the policy's decision (03 §4); the
|
|
42
|
+
signer only refuses the shapes no policy could accept.
|
|
34
43
|
|
|
35
44
|
5. **Sign with `signFact`, never a home-grown canonicaliser.** Import the
|
|
36
45
|
library (or delegate through `ultra-ddd`) and pass the covered envelope plus
|
package/package.json
CHANGED