Aruba Key CNS

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 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 Aruba Key, il est possible de signer numériquement n'importe quel document informatique (par exemple, les états financiers et les actes de société, les factures, les notifications, les formulaires d'enregistrement dans les registres publics, les contrats) en connectant le dispositif à n'importe quel ordinateur de bureau ou portable. Elle a une valeur légale dans toute l'Europe, dure 3 ans et peut être renouvelée pour 3 années supplémentaires avant son expiration en suivant la procédure prévue à cet effet.

Requête de liste de signatures et de codes

Comme indiqué 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, une requête API doit être faite au endpoint GET /prodotti.

GEThttps://ws.firmadigitale.com/prodotti

Reponse liste de signatures et de codes

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

Dans le cas de Aruba Key CNS, le code disponible est unique: ARUBAKEYCNS.

Le code permet d'effectuer la requête de dispositif.

Requête Aruba Key CNS

Pour procéder à la demande de dispositif, une requête doit être faite au endpoint POST /richiesta/{codice_prodotto}

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

Dans le Payload de la requête, une série d'informations sur le demandeur doit être transmise. Ces données dépendent du type de dispositif sélectionné; dans le cas de l'Aruba Key (avec ou sans CNS), elles sont les suivantes:

Voici un exemple de payload utile pour une requête de Aruba Key CNS:

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

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

Dans cette phase, il est également possible de sélectionner une ou plusieurs options pour Aruba Key CNS.

Nous vous suggérons de configurer une callback pour rester constamment informé de l'état de la demande.

Réponse Aruba Key CNS

La réponse contient toutes les informations et l'ID de la demande, par exemple, dans notre cas, ce sera 5f7ef1e83a716836d3152662. L'ID de la demande est essentiel car il permet de vérifier l'état de la demande, de télécharger et éventuellement d'envoyer le formulaire d'inscription 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.

Avez-vous des questions sur les types de dispositifs de signature numérique ou sur les méthodes de demande et d'activation? N'hésitez pas à nous contacter: l'un de nos consultants sera à votre disposition pour vous fournir toutes les informations et clarifications dont vous avez besoin!