Saltearse al contenido

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-builder under Collection Types (Certificate Template & Issued Certificate)
  • Plugin Workspace & Settings: /admin/plugins/certificates (Issuance Wizard, Ledger & Templates) and /admin/settings/certificates
  • Database Tables: certificates_templates and certificates_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)

Certificados Digitales (Ed25519) — Vista de Entidades en el Content Manager de Strapi v5

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 Template records (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), and esignEnvelopeStatus on Issued Certificate entries while keeping nationalIdHash and verificationToken protected (private: true).
  • Relational & Schema Extensions: Link Issued Certificate records to api::leader.leader officiating scholars or donor profiles via config/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)»
  1. 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).
  2. Manage Certificate Templates: Open Certificate Template to configure name, slug, category, serialPrefix (e.g., SHD, DON), bodyTemplate, requiresWitnesses, and defaultSignatories.
  3. Audit or Revoke Issued Certificates: Open Issued Certificate to filter credentials by serialNumber, status (active, pending_signature, revoked), recipientName, or esignEnvelopeStatus.
  4. 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, edit Official Shahada Certificate or Tax-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.certificate and filter by category = donation_tax and status = active.

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.template in /admin/plugins/certificates or call POST /certificates/certificates/issue; the service canonicalizes the payload, signs it with Ed25519, and persists plugin::certificates.certificate.

Digital Certificates (Ed25519) — Strapi v5 Admin Workspace

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 against canonicalPayloadHash and return masked recipient details.

Digital Certificates (Ed25519) — Strapi v5 Content Manager Entities

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-256 nationalIdHash (private: true).

Digital Certificates (Ed25519) — Strapi v5 Settings Panel

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 update esignEnvelopeStatus on plugin::certificates.certificate.