InfoCert Signature à distance
Demande via API la signature à distance InfoCert sans support physique, qui peut également être activée avec l'option de reconnaissance vidéo.
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 Key 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 de signature d'Openapi, d'autres types de signatures telles que la signature électronique simple (avec OTP) et la signature qualifiée peuvent être demandées.
Signature à distance InfoCert
La Signature à distance est la signature numérique InfoCert qui ne nécessite aucun dispositif physique pour être utilisée.
Requête liste de signatures et de codes
GET/prodottiComme 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.
GEThttps://ws.firmadigitale.com/prodottiReponse liste de signatures et de codes
GET/prodottiLa 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": "Firma Digitale Remota Infocert",
"tipo": "Infocert",
"codice_prodotto": "FIRREM",
"prezzo": 25.70
},
{
"nome": "Firma Digitale Remota Infocert Con Videoriconoscimento",
"tipo": "Infocert",
"codice_prodotto": "FIRREM_V",
"prezzo": 25.70
},
{
"nome": "Firma Digitale Remota Infocert Vergine ",
"tipo": "Infocert",
"codice_prodotto": "RINFIRREM",
"prezzo": 19.70
},
{
"nome": "Rinnovo Firma Remota",
"tipo": "Infocert",
"codice_prodotto": "RINFIRREM",
"prezzo": 19.70
}
.....
],
"success": true,
"message": "",
"error": null
}
Dans le cas de la signature à distance, il y aura plus d'un code en fonction de la présence de l'option de reconnaissance vidéo.
- FIRREM pour la signature à distance
- FIRREM_VIDEO pour la signature à distanc avec reconnaissance vidéo
Le code permet d'effectuer la demande de dispositif.
Requête Signature à distance
POST/richiesta/{codice_prodotto}Pour obtenir le dispositif, il faut en faire la requête adressée au l'endpoint POST/richiesta/{codice_prodotto}. Dans notre cas, nous avons choisi la signature à distance InfoCert et le code produit est FIRREM.
https://ws.firmadigitale.com/richiesta/FIRREMDans le Payload de la requête, un ensemble d'informations sur le demandeur doit être transmis. Ces données dépendent du type de dispositif sélectionné; dans le cas de la signature à distance, elles sont les suivantes:
- Nom et prénom
- Email et téléphone portable
- Date, commune, province et pays de naissance
- Adresse de résidence
- Code Fiscal
- Adresse de livraison
- Type, numéro, date de délivrance et d'expiration du document
Voici un exemple de payload utile pour une demande de la signature à distance
{
"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 signature à distance avec reconnaissance vidéo, un dataset plus limité doit être transmis:
- Nom et prénom
- Email et téléphone portable
- Adresse de livraison
Pour le signature à distance (sans reconnaissance vidéo), vous pouvez également sélectionner une ou plusieurs options
- assistance
- urgence
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 Signature à distance
POST/richiesta/{codice_prodotto}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.
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:
- Possède une signature numérique valide, le formulaire peut être signé numériquement et envoyé via l'endpoint PATCH /richiesta/{id} où l'identifiant est clairement celui obtenu précédemment.
- Si vous ne disposez pas d'une signature numérique, le formulaire doit être rempli, soumis à une authentification de signature auprès d'un agent public et envoyé par courrier recommandé accompagné d'une pièce d'identité.
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 signatures à distance "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.
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!
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
Le service permet de demander via API une signature à distance pour signer des documents numériques de manière sécurisée, sans avoir besoin d’un dispositif physique comme une carte à puce ou une clé USB. La signature est effectuée via une authentification en ligne, en utilisant des identifiants de connexion et un code OTP (One-Time Password) envoyé par SMS ou via une application.
Cette signature a la même valeur légale qu'une signature manuscrite et est souvent utilisée pour signer des contrats, autorisations et autres documents officiels à distance.
Openapi propose également l'option de reconnaissance vidéo lors de la phase de vérification d’identité, qui peut être effectuée en ligne, où que vous soyez. Pour l'émission de la signature, le demandeur est légalement tenu de suivre une procédure de vérification d'identité, et grâce à la reconnaissance vidéo, il gagne du temps et de l'argent. En effet, tout se passe numériquement et il n'est plus nécessaire de se rendre physiquement chez un officier public, ni d'acheter un timbre fiscal ou d'envoyer la documentation originale par courrier recommandé.
Terms and conditions
