Uso de Políticas en viafirma documents

Últ. revisión: 06 ago 2018

¿Qué es una política en viafirma documents?

Las políticas son un conjunto de evidencias, firmas, aprobaciones y otro tipo de elementos de seguridad que van a determinar cómo se debe firmar el PDF que remitiremos al usuario.

Los elementos que intervienen en una política son:

Firmas electrónicas (con certificado digital)

• desatendida (en servidor)
• en cliente

Evidencias Electrónicas

• firma biométrica
• OTP/SMS
• OTP/Mail
• imágenes
• huellas
• cuestionarios de seguridad
• checks avanzados

Aprobaciones

• aprobación simple (check)
• aprobación con código (PIN)
• aprobación con certificado digital en cliente
• aprobación con certificado digital en servidor

Otras

• geolocalización (GPS)
• código de bloqueo (PIN)
• lectura obligada del documento

Objeto Policy

Los mensajes intercambiados con viafirma documents podrán tener una o varias políticas que serán aplicadas al documento que se desea firmar. Este objeto cuenta con las siguientes características y estructura básica.

Policy {
  evidences (Array[Evidence], optional),
  signatures (Array[Signature], optional)
}

• evidences: conjunto de evidencias electrónicas: imágenes, huellas, firmas biométricas, OTP/SMS, OTP/Mail o Checks avanzados.
• signatures: conjunto de firmas electrónicas (con certificado digital) que se realizarán sobre el PDF tras haber capturado las evidencias definidas.

Evidencias

Este objeto cuenta con las siguientes características y estructura básica.

Evidence {
  type (string) = ['SIGNATURE', 'FINGERPRINT', 'IMAGE', 'ANNOTATION', 'FINGER_PRINT', 'OTP_SMS', 'GENERIC'],
  helpText (string, optional),
  helpDetail (string, optional),
  positions (Array[Position], optional),
  typeFormatSign (string, optional),
  optional (boolean, optional),
  positionsKey (string, optional)
}

Este objeto permite mayor número de atributos y configuración que puedes consultar en detalle en la documentación avanzada de políticas.

Ejemplo de evidencia

Evidence {
  type: "SIGNATURE",
  helpText: "Firma biométrica del cliente",
  helpDetail: "Nombre y apellidos del cliente",
  typeFormatSign: "XADES_T",
  optional: "false",
  positionsKey: "signature_box"
}

Signatures

Este objeto cuenta con las siguientes características y estructura básica.

Signature {
  type (string) = ['CLIENT', 'SERVER'],
  helpText (string, optional),
  typeFormatSign (string, optional) = ['PADES_B', 'PADES_T', 'PADES_LT', 'PADES_LTA']
}

Este objeto permite mayor número de atributos y configuración que puedes consultar en detalle en la documentación avanzada de políticas.

Ejemplo de firma

Signature {
  type: "SERVER",
  helpText: "Sello electrónico",
  typeFormatSign: "PADES_LTA"
}