Certificados Digitales (Ed25519) — Entidades Content-Type y Casos de Uso
Package:
@vicacha-devs/strapi-plugin-certificates· Plugin ID:certificates· Admin Workspace:/admin/plugins/certificates
1. Entidades Content-Type, Ubicación y Esquemas (strapi.documents)
Sección titulada «1. Entidades Content-Type, Ubicación y Esquemas (strapi.documents)»Registers two Collection Types (plugin::certificates.template and plugin::certificates.certificate). Templates define reusable certificate layouts, signatory rules, witness counts, and serial prefixes; Issued Certificates store canonical JSON payloads signed with Ed25519 (cryptographicSignature, publicKeyFingerprint), salted PII hashes (nationalIdHash), and DocuSign envelope status. Supports schemaExtensions in config/plugins.ts.
Dónde Encontrar las Entidades Content-Type en Strapi v5
Sección titulada «Dónde Encontrar las Entidades Content-Type en Strapi v5»- Content Manager:
/admin/content-manager/collection-types/plugin::certificates.template&/admin/content-manager/collection-types/plugin::certificates.certificate(visible: true) - Content-Type Builder:
/admin/plugins/content-type-builderunder Collection Types (Certificate Template&Issued Certificate) - Plugin Workspace & Settings:
/admin/plugins/certificates(Issuance Wizard, Ledger & Templates) and/admin/settings/certificates - Database Tables:
certificates_templatesandcertificates_records
plugin::certificates.certificate — Issued Certificate
Sección titulada «plugin::certificates.certificate — Issued Certificate»Cryptographically signed official certificate record with signatory and witness attestation
Kind:
collectionType· DB Table:certificates_records· Admin Location:/admin/content-manager/collection-types/plugin::certificates.certificate· Draft & Publish:No· i18n:No
| Atributo | Tipo en Strapi | Requerido | Restricciones / Relación |
|---|---|---|---|
serialNumber |
string |
Yes | max: 64 |
templateDocumentId |
string |
Yes | max: 120 |
templateSlug |
string |
Yes | max: 120 |
templateName |
string |
Yes | max: 160 |
status |
enumeration |
Yes | enum: pending_approval, issued, revoked, expired; default: "pending_approval" |
recipientFullName |
string |
Yes | max: 200 |
recipientChosenName |
string |
No | max: 200 |
recipientEmail |
email |
No | — |
recipientPhone |
string |
No | max: 64 |
recipientNationality |
string |
No | max: 120 |
nationalIdMasked |
string |
No | max: 32 |
nationalIdHash |
string |
No | max: 128; private: true |
issuedAt |
string |
Yes | max: 40 |
expiresAt |
string |
No | max: 40 |
revokedAt |
string |
No | max: 40 |
revocationReason |
text |
No | — |
signatories |
json |
No | default: [] |
witnesses |
json |
No | default: [] |
customData |
json |
No | default: {} |
secondaryDates |
json |
No | default: {} |
canonicalPayloadHash |
string |
Yes | max: 128 |
cryptographicSignature |
text |
Yes | — |
publicKeyFingerprint |
string |
Yes | max: 96 |
verificationToken |
string |
No | max: 128; private: true |
esignProvider |
enumeration |
No | enum: none, docusign, docuseal, webhook; default: "none" |
esignEnvelopeId |
string |
No | max: 128 |
esignEnvelopeStatus |
enumeration |
No | enum: not_sent, sent, delivered, completed, declined, voided; default: "not_sent" |
esignCompletedAt |
string |
No | max: 40 |
linkedBookingCode |
string |
No | max: 64 |
notes |
text |
No | — |
plugin::certificates.template — Certificate Template
Sección titulada «plugin::certificates.template — Certificate Template»Reusable official certificate template with signatory rules, witness requirements, and body statement
Kind:
collectionType· DB Table:certificates_templates· Admin Location:/admin/content-manager/collection-types/plugin::certificates.template· Draft & Publish:No· i18n:No
| Atributo | Tipo en Strapi | Requerido | Restricciones / Relación |
|---|---|---|---|
name |
string |
Yes | max: 160 |
slug |
uid |
Yes | — |
description |
text |
No | — |
serialPrefix |
string |
Yes | max: 8; default: "CERT" |
defaultValidityDays |
integer |
No | — |
requiresWitnesses |
boolean |
No | default: false |
minWitnesses |
integer |
No | default: 0 |
requiresApproval |
boolean |
No | default: true |
esignEnabled |
boolean |
No | default: false |
esignProvider |
enumeration |
No | enum: none, docusign, docuseal, webhook; default: "none" |
organizationName |
string |
Yes | max: 200 |
organizationSubheader |
string |
No | max: 240 |
headerText |
string |
No | max: 240 |
titleText |
string |
Yes | max: 200 |
bodyTemplate |
text |
Yes | — |
footerText |
text |
No | — |
defaultSignatories |
json |
No | default: [] |
customFieldsSchema |
json |
No | default: [] |
secondaryCalendars |
json |
No | default: [] |
accentColor |
string |
No | max: 16; default: "#14532d" |
active |
boolean |
No | default: true |
Integración con el Content Manager de Strapi v5 (/admin/content-manager)
Sección titulada «Integración con el Content Manager de Strapi v5 (/admin/content-manager)»Grupo en la Barra Lateral del Content Manager:
Donations & Certificates
Entidades y Componentes en el Content Manager
Sección titulada «Entidades y Componentes en el Content Manager»plugin::certificates.template(Certificate Template —/admin/content-manager/collection-types/plugin::certificates.template)plugin::certificates.certificate(Issued Certificate —/admin/content-manager/collection-types/plugin::certificates.certificate)

Por Qué Este Plugin Crea e Integra Entidades en el Content Manager
Sección titulada «Por Qué Este Plugin Crea e Integra Entidades en el Content Manager»@vicacha-devs/strapi-plugin-certificates exposes Certificate Template (plugin::certificates.template) and Issued Certificate (plugin::certificates.certificate) inside the Strapi v5 Content Manager so legal, academic, and finance administrators can manage templates, link signatories, and audit issued credentials using Strapi’s native tools:
- Structured Template & Signatory Management: Create and version
Certificate Templaterecords (shahada,nikah,donation_tax,course_completion,membership) with default signatory titles, serial prefixes, and witness counts in Content Manager. - Cryptographic Audit Trail Inspection: Inspect
serialNumber,canonicalPayloadHash,cryptographicSignature(Ed25519),publicKeyFingerprint,nationalIdMasked(***-***-7720), andesignEnvelopeStatusonIssued Certificateentries while keepingnationalIdHashandverificationTokenprotected (private: true). - Relational & Schema Extensions: Link
Issued Certificaterecords toapi::leader.leaderofficiating scholars or donor profiles viaconfig/plugins.ts -> schemaExtensions.
Cómo Usarlo en el Content Manager de Strapi (Paso a Paso)
Sección titulada «Cómo Usarlo en el Content Manager de Strapi (Paso a Paso)»- Open in Content Manager: In the left sidebar, expand Content Manager -> Collection Types -> Donations & Certificates and click Certificate Template (
/admin/content-manager/collection-types/plugin::certificates.template) or Issued Certificate (/admin/content-manager/collection-types/plugin::certificates.certificate). - Manage Certificate Templates: Open Certificate Template to configure
name,slug,category,serialPrefix(e.g.,SHD,DON),bodyTemplate,requiresWitnesses, anddefaultSignatories. - Audit or Revoke Issued Certificates: Open Issued Certificate to filter credentials by
serialNumber,status(active,pending_signature,revoked),recipientName, oresignEnvelopeStatus. - Workspace vs. Content Manager: Use the Certificates Workspace (
/admin/plugins/certificates) to issue new Ed25519-signed credentials via the cryptographic signing wizard; use Content Manager to maintain templates, inspect audit hashes, and manage custom relational fields.
Sincronización entre el Content Manager y el Espacio del Plugin
Sección titulada «Sincronización entre el Content Manager y el Espacio del Plugin»Casos de Uso en el Content Manager y Flujos Editoriales
Sección titulada «Casos de Uso en el Content Manager y Flujos Editoriales»Content Manager Use Case 1 — Designing & Updating Official Shahada, Nikah & Tax Certificate Templates
Sección titulada «Content Manager Use Case 1 — Designing & Updating Official Shahada, Nikah & Tax Certificate Templates»- Para qué sirve y por qué usarlo: Maintain standardized legal wording, serial prefixes (
SHD-,TAX-), and default signatory blocks in Content Manager. - Cómo ejecutarlo en el Content Manager: Open
/admin/content-manager/collection-types/plugin::certificates.template, editOfficial Shahada CertificateorTax-Deductible Donation Certificate, and save.
Content Manager Use Case 2 — Compliance Filtering of Issued Credentials by Status & Fiscal Year
Sección titulada «Content Manager Use Case 2 — Compliance Filtering of Issued Credentials by Status & Fiscal Year»- Para qué sirve y por qué usarlo: Audit all active or revoked tax donation and consular certificates for annual compliance reporting.
- Cómo ejecutarlo en el Content Manager: Open
/admin/content-manager/collection-types/plugin::certificates.certificateand filter bycategory = donation_taxandstatus = active.
3. Casos de Uso y Flujos de Trabajo
Sección titulada «3. Casos de Uso y Flujos de Trabajo»Use Case 1 — Issuing Cryptographically Signed Official Credentials
Sección titulada «Use Case 1 — Issuing Cryptographically Signed Official Credentials»- What it is for: Issue tamper-evident Shahada, Marriage (Nikah), Course Completion, or Tax Donation certificates signed with an Ed25519 private key.
- How it works: Select a
plugin::certificates.templatein/admin/plugins/certificatesor callPOST /certificates/certificates/issue; the service canonicalizes the payload, signs it with Ed25519, and persistsplugin::certificates.certificate.

Use Case 2 — Public QR Code Verification & Tamper Detection
Sección titulada «Use Case 2 — Public QR Code Verification & Tamper Detection»- What it is for: Let third parties (embassies, employers, auditors) verify a certificate’s authenticity by scanning its QR code.
- How it works: Call
GET /api/certificates/verify/{serialNumber}?token=...to re-verify the Ed25519 signature againstcanonicalPayloadHashand return masked recipient details.

Use Case 3 — Privacy-Preserving National ID Lookup (nationalIdHash)
Sección titulada «Use Case 3 — Privacy-Preserving National ID Lookup (nationalIdHash)»- What it is for: Verify whether a certificate belongs to a specific national ID number without storing plaintext national IDs in the database.
- How it works: The entity stores only
nationalIdMasked(***-***-7720) and a per-serial salted SHA-256nationalIdHash(private: true).

Use Case 4 — DocuSign / Webhook Multi-Party E-Signature Attestation
Sección titulada «Use Case 4 — DocuSign / Webhook Multi-Party E-Signature Attestation»- What it is for: Route pending certificates to signatories and witnesses via DocuSign envelopes and automatically transition status upon completion.
- How it works: Webhook events hit
POST /api/certificates/webhooks/esign(verified with constant-time HMAC-SHA256) and updateesignEnvelopeStatusonplugin::certificates.certificate.