Firmar con Documents Desktop por protocolo

Última revisión: 24 abril 2023

A continuación se explica los pasos a seguir para realizar una firma con un dispositivo wacom compatible con documents o certificado digital local desde una aplicación externa mediante la llamada por protocolo a Viafirma Documents Desktop.

1. Recuperación del valor del atributo scheme

Dentro del modelo message donde localizamos el atributo scheme dentro el objeto sharedLink que a su vez está dentro de notification.

El valor de scheme es el que utlizaremos para componer la llamada a Viafirma Documents Desktop por protocolo. En este caso: viafirmadocuments://eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXJ2ZXIiOiJodHRwczovL3NhbmRib3gudmlhZmlybWEuY29tL2RvY3VtZW50cyIsImNvZGUiOiIxNTMzMjgzMTA3NzI3UjMzNSIsInRva2VuU2VjcmV0IjoiN2U4ZTk5MDA4MmFmNDE3NzgzYmEyMDBmNjNiYjkyMTgiLCJ0b2tlbiI6IlRLMTUzMzI4MzEwNzcyN1IzMzUifQ.sbwGmK4cdS_OI29FMFRsJd3UTz-CKeE785nyJbBuIG0

2. Composición de la llamada

Para componer la llamada final a la apliación Viafirma Documents Desktop por protocolo se debe concatenar al valor scheme el código de la evidencia tipo wacom o certificado obtenidos dentro del objeto policies del json:

Para este ejemplo, obtenemos los siguientes atributos del json:

• scheme : viafirmadocuments://eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXJ2ZXIiOiJodHRwczovL3NhbmRib3gudmlhZmlybWEuY29tL2RvY3VtZW50cyIsImNvZGUiOiIxNTMzMjgzMTA3NzI3UjMzNSIsInRva2VuU2VjcmV0IjoiN2U4ZTk5MDA4MmFmNDE3NzgzYmEyMDBmNjNiYjkyMTgiLCJ0b2tlbiI6IlRLMTUzMzI4MzEwNzcyN1IzMzUifQ.sbwGmK4cdS_OI29FMFRsJd3UTz-CKeE785nyJbBuIG0,

• code : 1533283107727R335P001E001 (obtenido del objeto evidencies (para firma wacom) o signatures (para firma con certificado digital))

  Componemos la llamada scheme#code que tendrá que ejecutarse al pulsar sobre la acción "firmar" desde la aplicación cliente: viafirmadocuments://eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXJ2ZXIiOiJodHRwczovL3NhbmRib3gudmlhZmlybWEuY29tL2RvY3VtZW50cyIsImNvZGUiOiIxNTMzMjgzMTA3NzI3UjMzNSIsInRva2VuU2VjcmV0IjoiN2U4ZTk5MDA4MmFmNDE3NzgzYmEyMDBmNjNiYjkyMTgiLCJ0b2tlbiI6IlRLMTUzMzI4MzEwNzcyN1IzMzUifQ.sbwGmK4cdS_OI29FMFRsJd3UTz-CKeE785nyJbBuIG0#1533283107727R335P001E001

3. Firma en documents desktop

La llamada por protocolo anterior abrirá la aplicación Viafirma Documents Desktop, donde se procederá a la firma con el dispositivo wacom o seleccionando el certificado digital según el caso.