Signature numérique Smart Card InfoCert

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.

Avec l'API Digital Signature, d'autres types de signatures telles que la signature électronique simple (avec OTP) et la signature qualifiée peuvent être demandées.

Digital Signature Smart Card InfoCert

La Smart Card est un type de signature numérique InfoCert en forme de carte de crédit, compatible avec les lecteurs de Smart Card les plus courants. Il existe deux versions de la Smart Card:

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

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

L'achat du dispositif de signature de Smart Card comprend les éléments suivants:

Requête liste de signatures et de codes

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

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": "Smart Card",
      "tipo": "Infocert",
      "codice_prodotto": "FIR",
      "prezzo": 22.7
    },
    {
      "nome": "Smart Card CNS",
      "tipo": "Infocert",
      "codice_prodotto": "SMARTCARDCNS",
      "prezzo": 25.7
    },
    {
      "nome": "Smart Card CNS Con Videoriconoscimento",
      "tipo": "Infocert",
      "codice_prodotto": "SMARTCARDCNS_VIDEO",
      "prezzo": 57.9
    },
    {
      "nome": "Smart Card CNS Vergine",
      "tipo": "Infocert",
      "codice_prodotto": "SMARTCARDCNS_V",
      "prezzo": 25.70,
      "vergine": true
    }
    .....
  ],
  "success": true,
  "message": "",
  "error": null
}

Dans le cas de la signature numérique Smart Card, il y aura plus d'un code en fonction de la présence du certificat CNS et de l'option de reconnaissance vidéo.

Le code permet d'effectuer la demande de dispositif.

Requête Smart Card

Pour obtenir le dispositif, il faut en faire la requête adressée au l'endpoint POST/richiesta/{codice_prodotto}. Dans ce cas, le dispositif est la Smart Card avec CNS et le code produit est le suivant SMARTCARDCNS.

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

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 la Smart Card (avec ou sans CNS), elles sont les suivantes:

Voici un exemple de payload utile pour une demande de Smart Card

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

Pour le produit Smart Card avec reconnaissance vidéo, un dataset plus limité doit être transmis:

Pour les Smart Card (sans reconnaissance vidéo), vous pouvez également sélectionner une ou plusieurs options telles que le service, l'urgence et le type d'envoi: ordinaire, prioritaire, rapide.

Les délais d'expédition sont les suivants:

Les délais courent à partir de la réception de la documentation requise.

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 Smart Card

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.

Réalisation 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 se faire de différentes manières. Dans le cas du 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 et au numéro d'identification du dispositif. Les données d'activation de la signature (Emergency Code, PIN, PUK) seront, conformément à la réglementation, envoyées directement au courrier électronique du demandeur via une enveloppe virtuelle (PDF) par l'autorité de certification InfoCert.

En outre, des Smart Card "vierges" peuvent également être demandées via l'API de 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 d'appareils (CNS).

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!