@gerege-systems/eid-mongolia-sdk 0.40.3 → 0.42.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.
- package/README.md +58 -1
- package/dist/{browser-DdxKtnvo.d.cts → browser-Cbph4U6r.d.cts} +5 -0
- package/dist/{browser-CxTMnKOc.d.ts → browser-aa_Judox.d.ts} +5 -0
- package/dist/browser.d.cts +1 -1
- package/dist/browser.d.ts +1 -1
- package/dist/browser.js +1 -1
- package/dist/{chunk-PWFTN52X.js → chunk-A6FYBPRV.js} +1 -1
- package/dist/index.cjs +235 -108
- package/dist/index.d.cts +80 -6
- package/dist/index.d.ts +80 -6
- package/dist/index.js +201 -77
- package/dist/pades.cjs +30 -0
- package/dist/pades.d.cts +40 -1
- package/dist/pades.d.ts +40 -1
- package/dist/pades.js +30 -1
- package/dist/validate.js +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -407,7 +407,7 @@ certificate-choice хүчингүй / хуучирсан / ашиглагдса
|
|
|
407
407
|
таарахгүй.
|
|
408
408
|
|
|
409
409
|
```ts
|
|
410
|
-
const cc = await eid.sign.certificateChoiceByEtsi("PNOMN-12345678"); // эсвэл certificateChoiceDeviceLink() (
|
|
410
|
+
const cc = await eid.sign.certificateChoiceByEtsi("PNOMN-12345678"); // эсвэл certificateChoiceDeviceLink() (QR; callbackUrl өгвөл Web2App/App2App ч)
|
|
411
411
|
const signer = eid.validator.validateCertificateChoice(await eid.session.waitForResult(cc.sessionId), cc.sessionId);
|
|
412
412
|
const dtbs = myCmsBuilder.dtbs(signer.certificate); // таных: SHA-256(signedAttrs), 32 байт, стандарт base64 (PDF бол /pades prepare)
|
|
413
413
|
const ix = [{ type: "displayTextAndPIN" as const, displayText60: "Гэрээнд гарын үсэг зурах" }];
|
|
@@ -426,6 +426,31 @@ const sig = eid.validator.validateSign(r, s.sign!.digest, {
|
|
|
426
426
|
алгоритмаар, PKCS#1 v1.5; хуучин threshold-ECDSA credential нь үргэлж `ecdsa-with-SHA256` — `expectedAlgorithm` үүнийг
|
|
427
427
|
зөвхөн EC P-256 гэрчилгээтэй үед зөвшөөрнө). Digest-ийн урт hash-тай таарахгүй бол хүсэлт явахгүй.
|
|
428
428
|
|
|
429
|
+
#### Утсан дээр linked signing (буцах URL-тай)
|
|
430
|
+
|
|
431
|
+
`certificateChoiceDeviceLink({ callbackUrl })` — нэг session-оос desktop-д QR, утсан дээр Web2App товч гаргана.
|
|
432
|
+
`callbackUrl` нь RP-ийн `callback_hosts` жагсаалтад байх `https` URL (CA зам нь `/auth/eid/callback` болгон
|
|
433
|
+
хэвийн болгоно); жагсаалтад байхгүй бол CA хаяж, session зөвхөн QR болно. Утас linked SIGN дууссаны дараа л callback-ийг
|
|
434
|
+
нээнэ: RP-ийн өөрийн query (ж: `value=<санамсаргүй>`) хэвээр + `sessionSecretDigest` + `sessionId` (certificate-choice-ийн).
|
|
435
|
+
|
|
436
|
+
```ts
|
|
437
|
+
// 1) cert-choice-ийг callback-тай эхлүүл; `value`-г эхэлсэн браузерийн cookie-д хадгал
|
|
438
|
+
const cc = await eid.sign.certificateChoiceDeviceLink({ callbackUrl: `${origin}/auth/eid/callback?value=${value}` });
|
|
439
|
+
const qr = buildDeviceLink(deviceLinkInput(cc, "QR", "mon")); // desktop (секунд тутам шинэчил)
|
|
440
|
+
const w2a = buildDeviceLink(deviceLinkInput(cc, "Web2App", "mon")); // утсан дээрх товч (нэг session)
|
|
441
|
+
// 2) validateCertificateChoice → 3) digestForSigner(signer, …) — дээрх linked sign
|
|
442
|
+
const signer = eid.validator.validateCertificateChoice(await eid.session.waitForResult(cc.sessionId), cc.sessionId);
|
|
443
|
+
const s = await eid.sign.digestForSigner(signer, dtbs, ix);
|
|
444
|
+
|
|
445
|
+
// 4) /auth/eid/callback дээр
|
|
446
|
+
const ok = q.value === cookieValue && verifySessionSecretDigest(q.sessionSecretDigest, cc.sessionSecret!);
|
|
447
|
+
// ok бол session-ийг ЗӨВХӨН НЭГ УДАА хүлээн зөвшөөр (дахин ашиглахгүй), дараа нь linked SIGN-ий үр дүнг уншина:
|
|
448
|
+
const r = await eid.session.waitForResult(s.sessionId);
|
|
449
|
+
```
|
|
450
|
+
|
|
451
|
+
Linked SIGN session өөрөө callback-гүй. `sessionSecretDigest` = BASE64URL(SHA-256(base64-decode(`sessionSecret`))),
|
|
452
|
+
`userChallengeVerifier` ирэхгүй. `sessionSecret`/`sessionToken` зөвхөн backend-д.
|
|
453
|
+
|
|
429
454
|
## 3a. Байгууллагын нэрийн өмнөөс гарын үсэг (onBehalfOf)
|
|
430
455
|
|
|
431
456
|
Иргэн **өөрийн PIN2 гэрчилгээгээр** зурна; тухайн мөчид байгууллагыг төлөөлөх эрхтэйг eID **өөрийн бүртгэлээр**
|
|
@@ -973,6 +998,38 @@ KeyUsage contentCommitment, QUALIFIED (qcStatements), issuer allowlist (анхд
|
|
|
973
998
|
`PERMISSION_DENIED` / `RP_REQUIRED`, 404 `QR_TOKEN_INVALID`, 409 `NO_SIGNING_CERTIFICATE`, 429 `RATE_LIMITED`; `GET /session`-ийн
|
|
974
999
|
410 → `QrError` `QR_PRESENTATION_GONE` (presentation нэг л удаа өгөгдөнө). `qr.issuer` тохиргоо — тест орчинд л.
|
|
975
1000
|
|
|
1001
|
+
## 3i. Байгууллагын цахим тамга (e-Seal) — `eid.seal`, `sealPdf` (0.42.0)
|
|
1002
|
+
|
|
1003
|
+
Байгууллагын нэрийн өмнөөс **хүнгүй, автомат** систем баримт тамгална (нэхэмжлэх, тодорхойлолт, хуулга): түлхүүр eID-ийн
|
|
1004
|
+
серверт, иргэн/PIN/апп оролцохгүй, хариу шууд (session-гүй). RP-д тухайн байгууллагын **`SEAL:<orgEtsi>`** эрх хэрэгтэй
|
|
1005
|
+
(eID-ийн оператор олгоно; эрхгүй бол `ForbiddenError` 403). Иргэн байгууллагын нэрийн өмнөөс зурах бол §3a (тамга биш).
|
|
1006
|
+
Зөвхөн backend (RP secret).
|
|
1007
|
+
|
|
1008
|
+
```ts
|
|
1009
|
+
import { sealPdf, PadesError } from "@gerege-systems/eid-mongolia-sdk/pades";
|
|
1010
|
+
|
|
1011
|
+
const done = await sealPdf(eid.seal, "NTRMN-6235972", pdfBytes, { reason: "Нэхэмжлэх" });
|
|
1012
|
+
writeFileSync("sealed.pdf", done.pdf); // PAdES-BASELINE-LT, байгууллагын тамгатай
|
|
1013
|
+
```
|
|
1014
|
+
|
|
1015
|
+
- Урсгал: `eid.seal.getCertificate(org)` (`GET /seal/certificate/{orgEtsi}`) → `prepare` (signerCert = тамганы cert) →
|
|
1016
|
+
32 байт DTBS-ийг `eid.seal.seal(org, dtbs, "SHA-256")` (`POST /seal/{orgEtsi}`, `{digest, hashType}`) → `complete`.
|
|
1017
|
+
PDF eID руу очихгүй.
|
|
1018
|
+
- **RFC 3161 timestamp заавал** (eID TSA, `complete.tsaUrl`): TSA хүрэхгүй бол `TSA_UNAVAILABLE`, цагийн тэмдэггүй файл
|
|
1019
|
+
буцаахгүй; OCSP/CRL + DSS → B-LT. Тамга үл харагдах, баталгаажуулалтын (QR) хуудасгүй — тамга иргэний гарын үсгийн
|
|
1020
|
+
бүртгэлд (`registerSignature`) ордоггүй тул `/verify/{docId}` холбоос өгөхгүй.
|
|
1021
|
+
- Шалгагч (`validatePdf`, CA `/v3/validate/pdf`) энэ гарын үсгийг `certificate.usage: "seal"` гэж ангилна — хэрэглэгчид
|
|
1022
|
+
«Байгууллагын тамга» гэж харуулна уу.
|
|
1023
|
+
- `eid.seal.seal` хариуг шалгана: гарын үсэг хариуны гэрчилгээгээр digest дээр таарч, гэрчилгээ e-Seal профайл
|
|
1024
|
+
(`isSealCertificate`: KeyUsage = зөвхөн nonRepudiation, EKU-гүй) байх ёстой — эс бөгөөс `ValidationError`.
|
|
1025
|
+
`hashAlgorithm`: `SHA-256` (анхдагч) | `SHA-384` | `SHA-512`.
|
|
1026
|
+
- Алдаа: `PadesError` `SIGNER_INVALID` (cert e-Seal биш, эсвэл тамгалах хооронд cert солигдсон — дахин оролд),
|
|
1027
|
+
`SIGNATURE_INVALID`, `TSA_UNAVAILABLE` / `LTV_UNAVAILABLE` (`retryable`); RP-API-ийн алдаа хэвээр: **429
|
|
1028
|
+
`RATE_LIMITED`** → `ApiError` (`retryable`, `retryAfterMs`-ийн дараа дахин), 404 — байгууллага олдсонгүй, 409 —
|
|
1029
|
+
байгууллага ACTIVE биш эсвэл идэвхтэй тамганы гэрчилгээ алга/цуцлагдсан.
|
|
1030
|
+
- Тамганы гэрчилгээ олгох (`POST /seal/certificate/{orgEtsi}`) энэ хувилбарт алга — байгууллагын захирлын
|
|
1031
|
+
баталгаажуулалттай олголтын урсгал CA-д нэвтэрмэгц нэмэгдэнэ. Go: `pades.SealPDF`; .NET: `EidPades.SealAsync`.
|
|
1032
|
+
|
|
976
1033
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
977
1034
|
|
|
978
1035
|
Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
|
|
@@ -156,6 +156,11 @@ interface DeviceLinkSession {
|
|
|
156
156
|
receivedAt: number;
|
|
157
157
|
/** auth | sign | cert ({@link deviceLinkInput}-д). Хуучин хадгалсан session-д undefined = auth. */
|
|
158
158
|
sessionType?: "auth" | "sign" | "cert";
|
|
159
|
+
/**
|
|
160
|
+
* Зөвхөн cert (certificate-choice) session: эхлүүлэхэд илгээсэн түүхий `initialCallbackUrl` (linked signing буцах
|
|
161
|
+
* URL). Web2App/App2App authCode-д орно ({@link deviceLinkInput}); байхгүй бол QR-only.
|
|
162
|
+
*/
|
|
163
|
+
initialCallbackUrl?: string;
|
|
159
164
|
/** Sign session-д ({@link deviceLinkInput}, `validateSign`); бусад үед undefined. */
|
|
160
165
|
sign?: SignContext;
|
|
161
166
|
/** Certificate-choice session-ий хүсэлтэд илгээсэн нэр (cert холбоосын authCode-д). */
|
|
@@ -156,6 +156,11 @@ interface DeviceLinkSession {
|
|
|
156
156
|
receivedAt: number;
|
|
157
157
|
/** auth | sign | cert ({@link deviceLinkInput}-д). Хуучин хадгалсан session-д undefined = auth. */
|
|
158
158
|
sessionType?: "auth" | "sign" | "cert";
|
|
159
|
+
/**
|
|
160
|
+
* Зөвхөн cert (certificate-choice) session: эхлүүлэхэд илгээсэн түүхий `initialCallbackUrl` (linked signing буцах
|
|
161
|
+
* URL). Web2App/App2App authCode-д орно ({@link deviceLinkInput}); байхгүй бол QR-only.
|
|
162
|
+
*/
|
|
163
|
+
initialCallbackUrl?: string;
|
|
159
164
|
/** Sign session-д ({@link deviceLinkInput}, `validateSign`); бусад үед undefined. */
|
|
160
165
|
sign?: SignContext;
|
|
161
166
|
/** Certificate-choice session-ий хүсэлтэд илгээсэн нэр (cert холбоосын authCode-д). */
|
package/dist/browser.d.cts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-
|
|
1
|
+
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-Cbph4U6r.cjs';
|
|
2
2
|
export { D as DeviceLinkError, E as EidError } from './errors-CgJcEjrZ.cjs';
|
package/dist/browser.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-
|
|
1
|
+
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-aa_Judox.js';
|
|
2
2
|
export { D as DeviceLinkError, E as EidError } from './errors-CgJcEjrZ.js';
|
package/dist/browser.js
CHANGED
|
@@ -135,7 +135,7 @@ var ResponseTooLargeError = class extends EidError {
|
|
|
135
135
|
limit;
|
|
136
136
|
};
|
|
137
137
|
function maskPath(path) {
|
|
138
|
-
return path.split(/[?#]/)[0].replace(/\/(etsi|document|linked)\/[^/?#\s]+/g, "/$1/\u2026");
|
|
138
|
+
return path.split(/[?#]/)[0].replace(/\/(etsi|document|linked|seal(?:\/certificate)?)\/[^/?#\s]+/g, "/$1/\u2026");
|
|
139
139
|
}
|
|
140
140
|
var SessionFailedError = class extends EidError {
|
|
141
141
|
constructor(endResult) {
|