Signature électronique qualifiée Aruba OTP Display

Openapi est la seule plateforme qui permet plus de 15 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 Signature Numérique d'autres types de signatures telles que la signature électronique simple (avec OTP) et la signature qualifiée peuvent être demandées.

Signature électronique qualifiée Aruba OTP Display

La signature électronique qualifiée Aruba OTP Display est la signature d'Aruba qui, contrairement à la version mobile, comprend un token pour générer les OTP nécessaires à la signature et offre une sécurité encore plus grande. Ne nécessite pas de certificat de la Carte des Services Nationaux (CNS) et 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

Réponse 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 Display",
  "tipo": "Aruba",
  "codice_prodotto": "OTPDIS",
  "prezzo": 25.20
  },
  {
  "nome": "Firma Aruba OTP Mobile",
  "tipo": "Aruba",
  "codice_prodotto": "OTPMOB",
  "prezzo": 21.70
  },
  {
  "nome": "Videoriconoscimento Aruba",
  "tipo": "Aruba",
  "codice_prodotto": "VIDEORIC",
  "prezzo": 15
  },
  .....
],
"success": true,
"message": "",
"error": null
}

Dans le cas de la signature à distance Aruba OTP Display un seul code est disponible: OTPDIS.

Le code permet d'effectuer la demande de dispositif.

Requête Aruba OTP Display

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 OTPDIS.

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

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 la Signature à distance Aruba OTP Display 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 Display 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 Aruba OTP Display

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 le certificat soit délivré 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 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!