Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

La piste d'auditFermé Informations stockées dans un document signé concernant les signatures qui y ont été apposées. Ces informations comprennent, entre autres, le nom ou l’organisation du signataire, la date et l’heure de la signature, le certificat numérique à utiliser pour la validation du document et la chaîne de certificats à utiliser pour la validation du certificat. d'un document contient le certificat numérique utilisé pour signer, ainsi que l'image du bloc de signature, l'horodatage et les informations d'identification du signataire unique. Le document et les signatures électroniques qu'il contient sont scellés par une signature numérique afin de garantir l'intégrité et l'authenticité du document signé électroniquement. Particulièrement utile dans un processus à plusieurs signataires, OneSpan Sign horodate et verrouille indépendamment chaque signature et toute donnée saisie par chaque signataire indépendamment des autres. Ainsi, lorsque vous consultez la piste d'audit, même des années plus tard, vous savez clairement qui a signé quoi, dans quel ordre, à quel moment, etc.

Pour récupérer une piste d'audit, vous devez d'abord créer votre EslClient en utilisant votre API_Key et votre API_URL. Le code suivant permet d'effectuer ce qui suit :

public static final String API_KEY = "YOUR_API_KEY";
public static final String API_URL = "https://sandbox.esignlive.com/api";
EslClient eslClient = new EslClient( API_KEY, API_URL );

L'URL_API que vous utiliserez dépend de votre environnement. Par exemple :

  • Pour les environnements Sandbox, utilisez https://sandbox.esignlive.com/api

  • Pour les environnements de production, utilisez https://apps.esignlive.com

Pour obtenir plus d'informations, consultez la section URL des adresses IP et environnements.

Ensuite, créez un nouvel objet PackageId en utilisant un PackageId statique. Normalement, cette valeur devrait être générée dynamiquement, mais dans cet exemple, une valeur statique est utilisée. Le code suivant permet d'effectuer ce qui suit :

PackageId packageId = new PackageId("PACKAGE_ID");

Créez ensuite une liste d'informations d'audit et votre itérateur de liste.

List<Audit> auditList = eslClient.getAuditService().getAudit(packageId);
Iterator<Audit> iter = auditList.iterator();

Enfin, vous pouvez utiliser une boucle pour naviguer dans la liste des informations d'audit. À chaque boucle, les différentes valeurs des propriétés sont imprimées sur la console.

while(iter.hasNext())
{
     Audit myaudit = iter.next();
     System.out.println("DateTime - " + myaudit.getDateTime() + ", Type - " + myaudit.getType() + ", User - " +     myaudit.getUser() + ", Email - " + myaudit.getEmail() + ", IP - " + myaudit.getIp() + ", Target - " + myaudit.getTarget() + ", Data - " + myaudit.getData());
}

Résultats

Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous aurez exécuté votre code.

cSharpGetAuditOutput

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

La piste d'auditFermé Informations stockées dans un document signé concernant les signatures qui y ont été apposées. Ces informations comprennent, entre autres, le nom ou l’organisation du signataire, la date et l’heure de la signature, le certificat numérique à utiliser pour la validation du document et la chaîne de certificats à utiliser pour la validation du certificat. d'un document contient le certificat numérique utilisé pour signer, ainsi que l'image du bloc de signature, l'horodatage et les informations d'identification du signataire unique. Le document et les signatures électroniques qu'il contient sont scellés par une signature numérique afin de garantir l'intégrité et l'authenticité du document signé électroniquement. Particulièrement utile dans un processus à plusieurs signataires, OneSpan Sign horodate et verrouille indépendamment chaque signature et toute donnée saisie par chaque signataire indépendamment des autres. Ainsi, lorsque vous consultez la piste d'audit, même des années plus tard, vous savez clairement qui a signé quoi, dans quel ordre, à quel moment, etc.

Récupération d'une piste d'audit

Pour récupérer une piste d'audit, vous devez d'abord créer votre EslClient en utilisant votre API_Key et votre API_URL. Le code suivant permet d'effectuer ce qui suit :

String apiUrl = "https://sandbox.esignlive.com/api";
String apiKey = "YOUR_API_KEY";
 
EslClient eslClient = new EslClient(apiKey, apiUrl);

L'URL_API que vous utiliserez dépend de votre environnement. Par exemple :

  • Pour les environnements Sandbox, utilisez https://sandbox.esignlive.com/api

  • Pour les environnements de production, utilisez https://apps.esignlive.com

Pour obtenir plus d'informations, consultez la section URL des adresses IP et environnements.

Ensuite, créez un nouvel objet PackageId en utilisant un PackageId statique. Normalement, cette valeur devrait être générée dynamiquement, mais dans cet exemple, une valeur statique est utilisée. Le code suivant permet d'effectuer ce qui suit :

PackageId packageId = new PackageId("PACKAGE_ID");

Créez ensuite une liste d'informations d'audit et votre itérateur de liste.

List<Audit> myaudit = eslClient.AuditService.GetAudit(packageId);
List<Audit>.Enumerator myenum = myaudit.GetEnumerator();

Enfin, vous pouvez utiliser une boucle pour naviguer dans la liste des informations d'audit. À chaque boucle, les différentes valeurs des propriétés sont imprimées sur la console.

while(myenum.MoveNext())
{
     Debug.WriteLine("DateTime - " + myenum.Current.dateTime + ", Type - " + myenum.Current.type + ", User - " +    myenum.Current.user + ", Email - " + myenum.Current.email + ", IP - " + myenum.Current.ip + ", Target - " + myenum.Current.target + ", Data - " + myenum.Current.data);
}

Résultats

Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous aurez exécuté votre code.

cSharpGetAuditOutput

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

La piste d'auditFermé Informations stockées dans un document signé concernant les signatures qui y ont été apposées. Ces informations comprennent, entre autres, le nom ou l’organisation du signataire, la date et l’heure de la signature, le certificat numérique à utiliser pour la validation du document et la chaîne de certificats à utiliser pour la validation du certificat. d'un document contient le certificat numérique utilisé pour signer, ainsi que l'image du bloc de signature, l'horodatage et les informations d'identification du signataire unique. Le document et les signatures électroniques qu'il contient sont scellés par une signature numérique afin de garantir l'intégrité et l'authenticité du document signé électroniquement. Particulièrement utile dans un processus à plusieurs signataires, OneSpan Sign horodate et verrouille indépendamment chaque signature et toute donnée saisie par chaque signataire indépendamment des autres. Ainsi, lorsque vous consultez la piste d'audit, même des années plus tard, vous savez clairement qui a signé quoi, dans quel ordre, à quel moment, etc.

Récupération d'une piste d'audit

Pour récupérer la piste d'audit d'un paquet, vous aurez besoin de l'icône PackageId qui vous est retourné lors de la création du paquet.

Requête HTTP

GET /api/packages/{packageId}/audit

En-têtes HTTP

Accept: application/json
Content-Type: application/json
Authorization: Basic api_key

Données utiles de la réponse

{
  "package-id": "c2e57376-7391-4559-8da9-5d0ed4a24c56",
  "audit-events": [
    {
      "type": "Signing Session For Signer",
      "date-time": "2016-04-20 14:14:51",
      "target": "signing url group",
      "user": "somegroup",
      "user-email": "[email protected]",
      "user-ip": "11.11.111.111",
      "data": "Signing session to signer : [email protected](somegroup"
    },
    {
      "type": "View",
      "date-time": "2016-04-20 14:14:54",
      "target": "doc1",
      "user": "somegroup",
      "user-email": "[email protected]",
      "user-ip": "11.11.111.111",
      "data": null
    },
    {
      "type": "Click To Sign",
      "date-time": "2016-04-20 14:23:31",
      "target": "doc1",
      "user": "somegroup",
      "user-email": "[email protected]",
      "user-ip": "11.11.111.111",
      "data": "Approval: FAPOezPt0H8E"
    },
    {
      "type": "View",
      "date-time": "2016-04-20 15:20:47",
      "target": "doc1",
      "user": "Haris Haidary",
      "user-email": "[email protected]",
      "user-ip": "11.11.111.111",
      "data": null
    },
    {
      "type": "View",
      "date-time": "2016-04-20 15:23:52",
      "target": "doc1",
      "user": "Haris Haidary",
      "user-email": "[email protected]",
      "user-ip": "11.11.111.111",
      "data": null
    },
    {
      "type": "View",
      "date-time": "2016-04-20 15:44:41",
      "target": "doc1",
      "user": "Haris Haidary",
      "user-email": "[email protected]",
      "user-ip": "11.11.111.111",
      "data": null
    },
    {
      "type": "View",
      "date-time": "2016-04-20 15:44:47",
      "target": "doc1",
      "user": "Haris Haidary",
      "user-email": "[email protected]",
      "user-ip": "11.11.111.111",
      "data": null
    }
  ]
}

Récupération d'une liste d'URL d'images pour le résumé des preuves IDV

Vous pouvez avoir besoin de récupérer une liste d'URL d'images pour les signataires utilisant la vérification d'identité (IDV). La liste résultante peut contenir les URL de l'image du document ou d'une image selfie.

Pour récupérer une liste d'URL d'images, vous aurez besoin du PackageId qui vous est renvoyé lors de la création du paquet.

Requête HTTP

GET /api/packages/{packageId}/audit/idv/dvrImageUrls

En-têtes HTTP

Accept: application/json
Content-Type: application/json
Authorization: Basic api_key

Données utiles de la réponse

[
    {
        "signerName": "Signer Name",
        "email": "[email protected]",
        "idvImages": {
            "<singer_id>": {
                "idvTransactionId": "<idv_tx_id_1>",
				"attemptNumber": <attemptNumber>,
                "imageInformationList": [
                    {
                        "type": "PassportDataPage",
                        "detail": "",
                        "url": "image url for download purpose"
                    }
                ]
            }
        }
    },
    {
        "signerName": "Signer Name",
        "email": "[email protected]",
        "idvImages": {
            "<singer_id>": {
                "idvTransactionId": "<idv_tx_id_2>",
				"attemptNumber": <attemptNumber>,
                "imageInformationList": [
                    {
                        "type": "PassportDataPage",
                        "detail": "",
                        "url": "image url for download purpose"
                    }
                ]
            }
        }
    },
    ......
]

Récupération d'une image de signataire pour le résumé des preuves IDV

Vous pouvez avoir besoin de récupérer l'image d'un signataire ayant utilisé la vérification d'identité (IDV). La liste résultante peut contenir les URL de l'image du document ou d'une image selfie.

Pour obtenir une liste d'URL d'images, vous aurez besoin du PackageId, de IDV Transaction ID et de Image URL qui se trouvent dans Récupération d'une liste d'URL d'images pour le résumé des preuves IDV .

Requête HTTP

GET /api/packages/{packageId}/audit/idv/dvrSignerImage?idvTransactionId={idvTransactionId}&imageUrl={imageUrl}

En-têtes HTTP

Authorization: Basic api_key

Données utiles de la réponse

Image requise, au format binaire.

Récupération d'un résumé des preuves IDV au format JSON

Le résumé des preuves IDV contient les éléments suivants :

  • Les informations personnelles du signataire

  • Informations sur les documents

  • Le résumé et les détails du résultat de la vérification

Requête HTTP

GET /api/packages/{packageId}/audit/idv

En-têtes HTTP

Accept: application/json
Content-Type: application/json
Authorization: Basic api_key

Données utiles de la réponse

{
    "package-id": "-IpfLqlL39APrbpZ3M_Nx9o6Iq0=",
    "idv-audit-trail": [
        {
            "signerName": "Signer Name",
			"signerId": "Signer Id",
            "idvSupplementalInformationMap": {
                "<idv_tx_id>": {
					"attemptNumber": <attemptNumber>,
                    "idVerificationAttemptWithResult": {
                        "result": "Passed",
                        "created": "2023-06-13 14:41:52.603",
                        "idVerificationAttempts": [
                            {
                                "matchType": "Full Name",
                                "submitted": "Submitted Signer Name",
                                "extracted": "Extracted Signer Name",
                                "score": "1.0",
                                "threshold": "0.8",
                                "affectStatus": "Yes",
                                "status": "Passed"
                            },
                            {
                                "matchType": "Expiry Date",
                                "submitted": "2022-10-10",
                                "extracted": "2024-10-10",
                                "score": "N/A",
                                "threshold": "N/A",
                                "affectStatus": "Yes",
                                "status": "Passed"
                            }
                        ]
                    },
                    "idVerificationPersonalInformationList": [
                        {
                            "zone": "MergedZones",
                            "firstName": "First Name",
                            "lastName": "Last Name",
                            "dob": "1980-10-10",
                            "gender": "Female",
                            "nationality": null,
                            "address": null
                        }
                    ],
                    "idVerificationDocInformationList": [
                        {
                            "zone": "MergedZones",
                            "type": "DriverLicense",
                            "issuingAuthority": "DVLA",
                            "issuingCountry": "GB",
                            "issuingState": null,
                            "nationality": null,
                            "number": "DriverLicense Number",
                            "identificationNumber": null,
                            "expiryDate": "2028-01-12",
                            "issueDate": "2018-01-12"
                        }
                    ]
                }
            }
        }
    ]
}

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

La piste d'auditFermé Informations stockées dans un document signé concernant les signatures qui y ont été apposées. Ces informations comprennent, entre autres, le nom ou l’organisation du signataire, la date et l’heure de la signature, le certificat numérique à utiliser pour la validation du document et la chaîne de certificats à utiliser pour la validation du certificat. d'un document contient le certificat numérique utilisé pour signer, ainsi que l'image du bloc de signature, l'horodatage et les informations d'identification du signataire unique. Le document et les signatures électroniques qu'il contient sont scellés par une signature numérique afin de garantir l'intégrité et l'authenticité du document signé électroniquement. Particulièrement utile dans un processus à plusieurs signataires, OneSpan Sign horodate et verrouille indépendamment chaque signature et toute donnée saisie par chaque signataire indépendamment des autres. Ainsi, lorsque vous consultez la piste d'audit, même des années plus tard, vous savez clairement qui a signé quoi, dans quel ordre, à quel moment, etc.

Tout d'abord, récupérez la liste des informations d'audit en utilisant la fonction encapsulée suivante. Utilisez votre packageId comme paramètre.

public List<TestAuditService.Audit> getAudit(String packageId)

Ensuite, vous pouvez utiliser une boucle pour naviguer dans la liste des informations d'audit. À chaque boucle, les différentes valeurs des propriétés sont imprimées sur la console.

List<TestAuditService.Audit> auditList = getAudit(packageId);
for(TestAuditService.Audit audit: auditList){
    	System.debug('DateTime - ' + audit.date_time + ', Type - ' + audit.type + ', User - ' +  audit.user + ', Email -' + audit.user_email + ', IP - ' + audit.user_ip + ', Target - ' + audit.target + ', Data - ' + audit.data);
}

Résultats

Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous aurez exécuté votre code.

Capture