Firma Remota Aruba OTP Mobile

Openapi è l'unica piattaforma che consente di richiedere tramite API oltre 15 tipologie di firme digitali diverse, tra cui firme che includono dispositivi fisici (es. USB e smart card), firme remote, dispositivi con o senza CNS, e identificazione con video riconoscimento.

Inoltre solo su Openapi è possibile scegliere tra diverse Certification Authority come InfoCert o Aruba, senza impegni di acquisti di volume o obblighi verso Brand specifici.

L'API Firma Digitale permette anche di richiedere altre tipologie di firme come la firma elettronica semplice (con OTP) e la firma elettronica qualificata.

Firma Remota Aruba OTP Mobile

La Firma Remota OTP Mobile è la firma digitale Aruba che non richiede alcun dispositivo fisico per poter essere utilizzata. Può essere attivata comodamente da casa o dall'ufficio tramite video riconoscimento.

Con la Firma Remota OTP Mobile è possibile firmare digitalmente qualsiasi documento informatico (es. bilanci ed atti societari, fatture, notifiche, moduli per iscrizione a pubblici registri, contratti) collegando il dispositivo a qualsiasi desktop o notebook. Ha valore legale in tutta Europa, dura per 3 anni e può essere rinnovata per ulteriori 3 anni prima della scadenza seguendo la procedura dedicata.

Richiesta Elenco Firme e Codici

GET /prodotti

Come indicato precedentemente, Openapi offre un'ampia gamma di firme digitali. Per verificare tutti i dispositivi disponibili tramite l'API Firma Digitale, ed i rispettivi prezzi, è necessario effettuare una richiesta API all'endpoint GET /prodotti.

GET https://ws.firmadigitale.com/prodotti

Risposta Elenco Firme e Codici

GET /prodotti

La risposta conterrà l'elenco completo di tutte le firme disponibili con nome, tipo (es. InfoCert o Aruba), codice e prezzo. Questo elenco non include firme elettroniche non appartenenti alla tipologia (come ad esempio la Firma Elettronica Semplice) per cui sono previsti endpoint dedicati. Per alcuni prodotti sarà indicato anche se si tratta di firma "vergine", in tali casi non è prevista l'emissione dei certificati di firma.

L'elenco che segue è solo a titolo di esempio e non esaustivo dei prodotti disponibili.

{
"data": [
  {
  "nome": "Firma Aruba OTP Mobile",
  "tipo": "Aruba",
  "codice_prodotto": "OTPMOB",
  "prezzo": 21.70
  },
  {
  "nome": ""Firma Aruba OTP Display",
  "tipo": "Aruba",
  "codice_prodotto": "OTPDIS",
  "prezzo": 25.20
  },
{
  "nome": "Videoriconoscimento Aruba",
  "tipo": "Aruba",
  "codice_prodotto": "VIDEORIC",
  "prezzo": 15
},
.....
],
"success": true,
"message": "",
"error": null
}

Richiesta Firma Remota Aruba OTP Mobile

POST /richiesta/{codice_prodotto}

Per procedere alla richiesta del dispositivo è necessario effettuare una richiesta all'endpoint POST /richiesta/{codice_prodotto}. Nel nostro caso abbiamo scelto come dispositivo la Firma Remota OTP Mobile ed il codice prodotto è OTPMOB.

POST https://ws.firmadigitale.com/richiesta/OTPMOB

Nel payload della richiesta bisogna passare una serie di informazioni sul richiedente. Questi dati dipendono dalla tipologia di dispositivo selezionato, nel caso della Aruba OTP Mobile sono:

Ecco un esempio di payload per la richiesta di una Firma Remota:

{
"data":{
  "assistenza": true,
  "videoriconoscimento": false,
  "urgenza": true,
  "spedizione": "veloce",
  "anagrafica": {
  "nome": "alberto",
  "cognome": "neri",
  "email": "[email protected]",
  "cellulare": "349xxxxx18",
  "codice_fiscale": "vnxxxxxxxl1x7d",
  "data_nascita": "28/12/2000",
  "sesso": "M",
  "comune_nascita": "terni",
  "provincia_nascita": "terni",
  "nazione_nascita": "terni",
  "indirizzo_residenza": "via rossi 2",
  "comune_residenza": "terni",
  "provincia_residenza": "terni",
  "cap_residenza": "05100",
  "nazione_residenza": "italia",
  "destinatario": "alberto neri",
  "indirizzo_spedizione": "via rossi 2",
  "comune_spedizione": "terni",
  "provincia_spedizione": "terni",
  "cap_spedizione": "05100",
  "tipo_documento": "patente",
  "numero_documento": "123456",
  "soggetto_emittente": "mctc",
  "data_emissione": "05/11/1990",
  "data_scadenza": "12/12/2020"
  },
"callback": {
"url": "https://dev.ws.firmadigitale.com/test.php",
"method": "JSON",
"field": "data"
},
  "documento": "JVBERi0xLjYNJeLjz9MNCjcgMCBvYmoNPDwvTGluZWFyaXplZCAxL0wgNDQ5MjMvTyA5L0UgNDA1MDcvTiAxL1QgNDQ2MzQvSCBbIDUwMyAxNzRdPj4NZW5kb2JqDSAgICAgICAgICAgICAgICAgICAgDQozMiAwIG9iag08PC9EZWNvZGVQYXJtczw8L0NvbHVtbnMgNC9QcmVkaWN0b3IgMTI",
  "nome_documento": "doc_SCARUBACNS.pdf"
}

In questa fase si possono selezionare anche una o più opzioni per l'Aruba OTP Mobile:

Ti suggeriamo di impostare una callback per rimanere sempre aggiornato/a sul cambio di stato della richiesta.

Risposta Firma Remota Aruba OTP Mobile

POST /richiesta/{codice_prodotto}

La risposta riporterà tutte le informazioni ed includerà l'id della richiesta, ad esempio nel nostro caso sarà 5f7ef1e83a716836d3152662. L'id della richiesta è indispensabile perché ci consentirà di verificare lo stato della richiesta, scaricare ed eventualmente inviare il modulo di registrazione della Firma. Il modulo può essere scaricato tramite l'endpoint GET /richiesta/{id}/modulo.

Completamento Richiesta

Per consentire l'emissione del certificato è necessario che il richiedente completi il processo di identificazione, come prevede la normativa vigente. Questo può avvenire in varie modalità. Se il richiedente:

È possibile verificare lo stato di evasione delle firme in qualsiasi momento tramite l'endpoint GET /richiesta/{id}.

Una volta che lo stato sarà passato ad "evaso", riceverai entro breve tempo - tramite un'email di Aruba - i codici per poter attivare la firma remota.

Il servizio Firma Aruba OTP Mobile via API è ideale per aziende e organizzazioni che desiderano offrire ai propri clienti una firma sicura e certificata, utilizzabile dalla singola persona con proprie credenziali per poter sottoscrivere qualsiasi documento digitale, senza dover utilizzare un dispositivo fisico.

Hai domande sulle tipologie di dispositivi di firma digitale o sulle modalità di richiesta e attivazione? Non esitare a contattarci: un nostro consulente sarà a tua disposizione per fornirti tutte le informazioni e i chiarimenti di cui hai bisogno!