Signature à distance Aruba OTP Mobile

Openapi est la seule plateforme qui permet plus de 28 types de signatures numériques via API, y compris les dispositifs physiques tels que l'USB Key et les Smart Card, les signatures à distance, les dispositifs avec ou sans CNS, et les signatures avec identification par reconnaissance vidéo.

Sur Openapi, il est également possible de choisir entre différentes autorités de certification telles qu'InfoCert ou Aruba, sans engagement d'achat minimum ni obligation envers des marques spécifiques.

Avec l'API de signature d'Openapi, d'autres types de signatures telles que la signature électronique simple (avec OTP) et la signature qualifiée peuvent être demandées.

Signature à distance OTP Mobile Aruba

Signature à distance OTP Mobile est la signature numérique Aruba sans support physique (par exemple USB ou Smart Card) et est disponible avec ou sans l'option de reconnaissance vidéo.

La signature à distance ne nécessite pas de certificat de la Carte des Services Nationaux (CNS).

La signature à distance permet d'apposer des signatures numériques sur n'importe quel document électronique (comme les états financiers et les actes de société, les factures, les notifications, les formulaires du registre public, les contrats) ayant une validité juridique dans toute l'Europe et constitue la solution idéale pour les utilisateurs d'ordinateurs à partir d'un lieu fixe.

Requête liste de signatures et de codes

GET/prodotti

Comme mentionné ci-dessus, Openapi offre une large gamme de signatures numériques. Pour vérifier tous les dispositifs disponibles via l'API des signatures numériques, ainsi que leurs prix respectifs, il est nécessaire de faire une requête API au endpoint GET/prodotti .

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

Reponse liste de signatures et de codes

GET/prodotti

La réponse offre une liste complète de toutes les signatures disponibles avec le nom, le type (par exemple InfoCert ou Aruba), le code et le prix. Cette liste ne comprend pas les signatures électroniques n'appartenant pas au type de signature numérique (par exemple, la signature électronique simple), pour lesquelles il existe des endpoints spécifiques. Pour certains produits, il sera également indiqué s'il s'agit d'une signature "vierge", auquel cas aucun certificat de signature ne sera délivré.

La liste ci-dessous n'est qu'un exemple et n'est pas exhaustive des produits disponibles:

{
"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
  }

Dans le cas de l'Aruba OTP Mobile Signature, un seul code est disponible: OTPMOB.

Le code permet d'effectuer la demande de dispositif.

Requête Signature à distance

POST/richiesta/{codice_prodotto}

Pour obtenir le dispositif, il faut en faire la requête adressée au l'endpoint POST/richiesta/{codice_prodotto} . Dans notre cas, nous avons choisi la signature à distance InfoCert et le code produit est OTPMOB.

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

Dans le Payload de la requête, un ensemble d'informations sur le demandeur doit être transmis. Ces données dépendent du type de dispositif sélectionné; dans le cas de la signature à distance, elles sont les suivantes:

Voici un exemple de payload utile pour une demande de la signature à distance

{
  "data":{
  "assistenza": true,
  "urgenza": true,
  "spedizione": "veloce",
  "anagrafica": {
    "nome": "alberto",
    "cognome": "neri",
    "email": "a.neri@openapi.com",
    "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"
}

Si vous souhaitez demander l'Aruba OTP Mobile Remote Signature avec reconnaissance vidéo, il vous suffit de régler le paramètre de reconnaissance vidéo sur "true" pendant la phase de demande. Il est également possible de la demander dans un deuxième temps par le biais d'une demande séparée avec un code dédié: VIDEORIC.

Pour le signature à distance OTP Mobile vous pouvez également sélectionner une ou plusieurs options

Nous vous suggérons de mettre en place un callback afin de rester informé de l'évolution de l'état de la demande.

Réponse Signature à distance

POST/richiesta/{codice_prodotto}

La réponse contient toutes les informations et l'identifiant de la demande, par exemple, dans notre cas, il s'agit de 5f7ef1e83a716836d3152662. L'identifiant de la demande est indispensable car il nous permet de vérifier le statut de la demande, de télécharger et éventuellement d'envoyer le formulaire d'enregistrement de la signature.

Le formulaire peut être téléchargé via l'endpoint GET/richiesta/{id}/modulo .

Achèvement de la requête

Pour que les certificats soient délivrés et que le dispositif soit traité, il est nécessaire que le demandeur achève le processus d'identification.

Cela peut être fait de différentes manières. Dans le cas où le demandeur:

L'option de reconnaissance vidéo simplifie ce processus en automatisant l'ensemble du processus d'identification par un simple appel à un opérateur, qui peut être effectué à partir de n'importe quel appareil.

Vous pouvez vérifier l'état du traitement des signatures à tout moment via l'endpoint GET/richiesta/{id}

Dans la réponse, lorsque le statut est passé à "traité", il sera possible d'accéder au code de suivi de l'envoi, au numéro de l'enveloppe, au numéro d'identification de l'appareil et aux 4 premiers numéros PIN ET PUK. Les autres numéros seront envoyés directement à l'adresse électronique du demandeur par l'autorité de certification Aruba.

Vous avez des questions sur les types de dispositifs de signature numérique ou sur la manière de les appliquer et de les activer? N'hésitez pas à nous contacter: l'un de nos consultants se tient à votre disposition pour vous fournir toutes les informations et éclaircissements dont vous avez besoin!