@gerege-systems/eid-mongolia-sdk 0.41.0 → 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 +32 -0
- package/dist/browser.js +1 -1
- package/dist/{chunk-PWFTN52X.js → chunk-A6FYBPRV.js} +1 -1
- package/dist/index.cjs +205 -103
- package/dist/index.d.cts +57 -2
- package/dist/index.d.ts +57 -2
- package/dist/index.js +169 -68
- 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
|
@@ -998,6 +998,38 @@ KeyUsage contentCommitment, QUALIFIED (qcStatements), issuer allowlist (анхд
|
|
|
998
998
|
`PERMISSION_DENIED` / `RP_REQUIRED`, 404 `QR_TOKEN_INVALID`, 409 `NO_SIGNING_CERTIFICATE`, 429 `RATE_LIMITED`; `GET /session`-ийн
|
|
999
999
|
410 → `QrError` `QR_PRESENTATION_GONE` (presentation нэг л удаа өгөгдөнө). `qr.issuer` тохиргоо — тест орчинд л.
|
|
1000
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
|
+
|
|
1001
1033
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
1002
1034
|
|
|
1003
1035
|
Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
|
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) {
|