Signature numérique Aruba Key CNS

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

L'API Signature Numérique vous permet également de demander d'autres types de signatures telles que la signature électronique simple (avec OTP) et la signature électronique qualifiée.

Signature Numérique Aruba Key CNS

Aruba Key est un type de signature numérique Aruba sur USB, qui inclut le certificat CNS (Carte nationale des services) et l'option de reconnaissance vidéo pour la phase d'identification.

Grâce au certificat CNS, il est possible d'accéder à tous les portails de l'AP en quelques secondes et en toute sécurité.

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 liste de signatures et 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.

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

Réponse liste de signatures et 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, et 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}. Dans notre cas, nous avons choisi l'Aruba Signature Key CNS comme appareil et le code produit, comme mentionné ci-dessus, est ARUBAKEYCNS.

POST https://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 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 d'identification de l'appareil, au code de la carte et aux 4 premiers codes PIN et PUK. Les autres numéros seront envoyés directement à l'adresse électronique du demandeur par l'autorité de certification Aruba.

En outre, la signature «vierge» peut également être demandée via l'API Signature Numérique. C'est le cas, par exemple, des clients RAO qui peuvent émettre eux-mêmes des certificats de signature et n'ont besoin que d'acheter des lots de dispositifs (CNS).

Le service Aruba Key CNS via API est idéal pour les entreprises et les organisations qui souhaitent offrir à leurs clients une signature sécurisée et certifiée qui peut être utilisée par les individus avec leurs propres identifiants à la fois pour signer n'importe quel document numérique et pour accéder aux services de l'administration publique grâce à l'option CNS (Carte de Services Nationaux).

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!