Business Key InfoCert

Openapi est la seule plateforme qui permet de demander plus de 28 types différents de signatures numériques par l'intermédiaire de l'API. Il s'agit notamment de dispositifs physiques tels que les cartes USB et les Smart Card, de signatures à distance, de dispositifs avec ou sans CNS et de signatures avec reconnaissance vidéo.

En outre, ce n'est que sur Openapi qu'il est possible de choisir entre différentes autorités de certification telles qu'InfoCert ou Aruba, sans achats en volume ni obligations envers des marques spécifiques.

L'API de signature d'Openapi vous permet également de demander d'autres types de signatures telles que les signatures électroniques simples (avec OTP) et les signatures qualifiées.

Business Key InfoCert

La Business Key est un type de signature numérique InfoCert sur USB, et est disponible:

Avec le certificat CNS, vous pouvez accéder à tous les portails de l'administration publique en quelques secondes et en mode sécurisé.

Business Key permet de signer numériquement n'importe quel document informatique (états financiers et actes de société, factures, notifications, formulaires d'inscription dans les registres publics, contrats) au moyen d'une USB portable utilisable avec n'importe quel PC. Il ne nécessite pas l'installation d'un logiciel car celui-ci est déjà présent sur l'appareil. Il a une valeur légale dans toute l'Europe, a une durée de 3 ans et peut être renouvelé pour 3 années supplémentaires avant expiration en suivant la procédure prévue à cet effet.

Requête de liste de signatures et de codes

GET/prodotti

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

GEThttps://ws.firmadigitale.com/prodotti

Response de liste de signatures et de codes

GET/prodotti

La réponse contiendra la 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 (comme la signature électronique simple) pour lequel des points finaux dédiés sont fournis. 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 suivante n'est qu'un exemple et n'est pas exhaustive des produits disponibles.

{
"data": [{
    "nome": "Business Key",
    "tipo": "Infocert",
    "codice_prodotto": "KEY",
    "prezzo": 38.00
    },
    {
    "nome": "Business Key CNS",
    "tipo": "Infocert",
    "codice_prodotto": "KEYCNS",
    "prezzo": 38.70
    },
    {
    "nome": "Business Key CNS Con Videoriconoscimento",
    "tipo": "Infocert",
    "codice_prodotto": "KEYCNS_VIDEO",
    "prezzo": 77.90
    },
    {
    "nome": "Business Key Vergine",
    "tipo": "Infocert",
    "codice_prodotto": "KEY_V",
    "prezzo": 38.70,
    "vergine": true
    },
    {
    "nome": "Business Key CNS Vergine",
    "tipo": "Infocert",
    "codice_prodotto": "KEYCNS_V",
    "prezzo": 38.70
    "vergine": true
    }
    .....
  ],
"success": true,
"message": "",
"error": null
}

Dans le cas de la signature numérique Business Key, il y aura plusieurs codes en fonction de la présence du certificat CNS et de l'option Videorecognition.

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

Requête Business Key

POST/richiesta/{codice_prodotto}

Pour procéder à la demande de dispositif, une demande doit être faite au endpoint POST/richiesta/{codice_prodotto}. Dans notre cas, nous avons choisi la Business Key avec CNS comme dispositif et le code produit est KEYCNS.

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

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 choisi, dans le cas de la clé de gestion (avec ou sans CNS), elles sont les suivantes:

Voici un exemple de Payload utiles pour une requête de Business Key

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

Dans le cas d'une requête de produit Business Key avec reconnaissance vidéo, un ensemble plus limité d'informations doit être transmis:

À ce stade, vous pouvez également sélectionner pour les Business Keys (sans reconnaissance vidéo) une ou plusieurs options:

Les types d'expédition disponibles sont : ordinaire, prioritaire, express.

Les délais de livraison sont:

Les délais s'entendent à partir de la réception de la documentation requise.

Nous vous suggérons d'organiser un callback pour vous tenir informé de l'évolution de l'état de votre requête.

Réponse Business Key

POST/richiesta/{codice_prodotto}

La réponse contiendra toutes les informations et l'identifiant de la requête, par exemple, dans notre cas, 5f7ef1e83a716836d3152662. L'identifiant de la requête est indispensable car il nous permet de vérifier le statut de la requête, 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.

Compléter 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 se faire de différentes manières. Si le demandeur:

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

Vous pouvez vérifier l'état de 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 et au numéro d'identification du dispositif. En revanche, les données d'activation de la signature (code d'urgence, PIN, PUK) seront, conformément à la réglementation, envoyées directement à l'adresse électronique du demandeur par le biais d'une enveloppe virtuelle (PDF).

Via l'API Signature Numérique, il est également possible de demander des Business Keys "vierges". C'est le cas, par exemple, pour les clients RAO qui peuvent émettre eux-mêmes des certificats de signature et n'ont besoin que d'acheter des lots de dispositifs.

Avez-vous des questions sur les types de dispositifs de signature numérique ou sur les procédures 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 les clarifications dont vous avez besoin.