Digital Signature Aruba Key CNS

Openapi is the only platform that allows over 15 different types of digital signatures to be requested via APIs, including signatures including physical devices (e.g. USB and smart cards), InfoCert qualified electronic signatures, devices with or without CNSs, and video recognition identification possibilities.

On Openapi it is also possible to choose between different Certification Authorities such as InfoCert or Aruba, without minimum purchase commitment or obligations to specific brands.

With the API Digital Signature other types of signatures such as simple electronic signature (with OTP) and qualified signature can be requested.

Digital Signature Aruba Key CNS

Aruba Key is a type of Aruba digital signature on USB, which includes the National Service Card (CNS) certificate and the video recognition option for the identification phase.

Thanks to the CNS certificate, it is possible to access all the Public Administration portals in a few seconds and in secure mode.

Aruba Key allows you to digitally sign all the IT documents (e.g. financial statements and company deeds, invoices, notifications, forms for entry in public registers, contracts) by connecting the device to any desktop or notebook. It has legal value throughout Europe, lasts for 3 years and can be renewed for a further 3 years before expiry by following the dedicated procedure.

Request Signature List and Code

As mentioned above, Openapi offers a wide range of digital signatures. To check all the devices available via the API Digital Signature, and their respective prices, it is necessary to make an API request to the endpoint GET /prodotti.

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

Response Signature List and Code

The response will contain the complete list of all available signatures with name, type (e.g. InfoCert or Aruba), code and price. This list does not include electronic signatures not belonging to the type (e.g. Simple Electronic Signature) for which there are dedicated endpoints. For some products, it will also be indicated whether it is a "blank" signature, in which case no signature certificates will be issued.

The list below is only an example and not exhaustive of the available products.

{
"data": [
{
"nome": "Aruba Key CNS",
"tipo": "Aruba",
"codice_prodotto": "ARUBAKEYCNS",
"prezzo": 39.40
},
{
"nome": ""Smart Card Aruba CNS",
"tipo": "Aruba",
"codice_prodotto": "SCARUBACNS",
"prezzo": 22.40
},
{
"nome": "Videoriconoscimento Aruba",
"tipo": "Aruba",
"codice_prodotto": "VIDEORIC",
"prezzo": 15
},
.....
],
"success": true,
"message": "",
"error": null
}

In the case of the Aruba Key the available code is only one, ARUBAKEYCNS, and it allows the device request to be made.

Request Aruba Key CNS

In order to proceed with the device request it is necessary to make a call to the endpoint POST /richiesta/{codice_prodotto}. In our case we chose Digital Signature Aruba Key CNS and the product code, as just mentioned, is ARUBAKEYCNS.

POSThttps://ws.firmadigitale.com/richiesta/ARUBAKEYCNS

In the payload of the request, we have to pass a series of information about the requester. These data depend on the type of device selected, in the case of the Business Key (with or without CNS) they are:

Here is an example of a payload for an Aruba Key CNS signature request:

{
"data":{
"assistenza": true,
"videoriconoscimento": false,
"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"
}

If you wish to request the Aruba Key CNS with video recognition, simply set the video recognition parameter to "true" during the request phase. It is also possible to request it in another moment, with the dedicated code 'VIDEORIC'.

For the product Aruba Key with video recognition, a more limited dataset of information must be passed:

For the Aruba Key without video recognition it is also possible to select one or more options such as assistance, urgency and type of delivery: ordinary, priority, fast.

Shipping times are:

The timeframe is from receipt of the required documentation.

We suggest you set up a callback to stay updated on the status change of the request.

Response Aruba Key CNS

The response contains all the information and the id of the request, e.g. in our case it will be 5f7ef1e83a716836d3152662. The request id is indispensable because it allows us to check the status of the request, download and possibly send the Signature registration form.

The form can be downloaded via the endpoint GET/richiesta/{id}/modulo.

Request Completion

In order for the certificates to be issued and the device to be processed, it is necessary for the requester to complete the identification process.

This can be done in various ways. If the applicant:

The video recognition option simplifies this process by automating the entire identification process through a simple call with an operator, which can be done from any device.

You can check the status of signature processing at any time via the endpoint GET/richiesta/{id}.

In the response, when the status has changed to processed, it will be possible to access the tracking code of the shipment, the envelope number, the device identification number and the first 4 PIN AND PUK numbers. The remaining numbers will instead be sent directly to the email of the requester by the Certification Authority Aruba.

In addition, 'Virgin' signature can also be requested via the API Digital Signature. This is the case, for example, with RAO customers who can issue signature certificates themselves and only need to purchase batches of devices (CNSs).

The Aruba Key CNS service via API is ideal for companies and organisations wishing to offer their customers a secure, certified signature that can be used by individuals with their own credentials both to sign any digital document and to access public administration services thanks to the CNS (National Services Card) option.

Do you have questions about the types of digital signature devices or how to apply and activate them? Do not hesitate to contact us: one of our consultants will be at your disposal to provide you with all the information and clarifications you need!