@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 CHANGED
@@ -407,7 +407,7 @@ certificate-choice хүчингүй / хуучирсан / ашиглагдса
407
407
  таарахгүй.
408
408
 
409
409
  ```ts
410
- const cc = await eid.sign.certificateChoiceByEtsi("PNOMN-12345678"); // эсвэл certificateChoiceDeviceLink() (зөвхөн QR)
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-д). */
@@ -1,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-DdxKtnvo.cjs';
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-CxTMnKOc.js';
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
@@ -4,7 +4,7 @@ import {
4
4
  import {
5
5
  DeviceLinkError,
6
6
  EidError
7
- } from "./chunk-PWFTN52X.js";
7
+ } from "./chunk-A6FYBPRV.js";
8
8
  export {
9
9
  DeviceLinkError,
10
10
  EidError,
@@ -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) {