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

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

La piste d’audit 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 uniques du signataire. Le document et les signatures électroniques qu’il contient sont inviolables avec une signature numérique pour garantir l’intégrité et l’authenticité de l’enregistrement signé électroniquement. Particulièrement pertinent dans un processus à plusieurs signataires, OneSpan Sign horodate et verrouille indépendamment chaque signature et toutes les données saisies par chaque signataire indépendamment des autres. Ainsi, lorsque vous examinez la piste d’audit, même des années plus tard, il est clair 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 à l’aide de votre API_Key et de votre API_URL. Pour ce faire, le code suivant :

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 );

Le API_URL 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/api

Pour plus d’informations, reportez-vous à la Environment URLs and IP Addresses.

Ensuite, créez un objet PackageId à l’aide d’une chaîne PackageId statique. Normalement, cela devrait être généré dynamiquement, mais pour cet exemple, une valeur statique est utilisée. Pour ce faire, le code suivant :

PackageId packageId = new PackageId("PACKAGE_ID");

Créez ensuite la 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 de propriété 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 avez exécuté votre code.

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

La piste d’audit 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 uniques du signataire. Le document et les signatures électroniques qu’il contient sont inviolables avec une signature numérique pour garantir l’intégrité et l’authenticité de l’enregistrement signé électroniquement. Particulièrement pertinent dans un processus à plusieurs signataires, OneSpan Sign horodate et verrouille indépendamment chaque signature et toutes les données saisies par chaque signataire indépendamment des autres. Ainsi, lorsque vous examinez la piste d’audit, même des années plus tard, il est clair 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 à l’aide de votre API_Key et de votre API_URL. Pour ce faire, le code suivant :

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

Le API_URL 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 plus d’informations, reportez-vous à la Environment URLs and IP Addresses.

Ensuite, créez un objet PackageId à l’aide d’une chaîne PackageId statique. Normalement, cela devrait être généré dynamiquement, mais pour cet exemple, une valeur statique est utilisée. Pour ce faire, le code suivant :

PackageId packageId = new PackageId("PACKAGE_ID");

Créez ensuite la 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 de propriété 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 avez exécuté votre code.

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

La piste d’audit 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 uniques du signataire. Le document et les signatures électroniques qu’il contient sont inviolables avec une signature numérique pour garantir l’intégrité et l’authenticité de l’enregistrement signé électroniquement. Particulièrement pertinent dans un processus à plusieurs signataires, OneSpan Sign horodate et verrouille indépendamment chaque signature et toutes les données saisies par chaque signataire indépendamment des autres. Ainsi, lorsque vous examinez la piste d’audit, même des années plus tard, il est clair 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 package, vous aurez besoin du PackageId, qui vous est renvoyé lors de la création du package.

Requête HTTP

GET /api/packages/{packageId}/audit

En-têtes HTTP

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

Charge utile de 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": "9fe0d028-0572-4731-8520-99191340d78f@groups.esignlive.com",
      "user-ip": "11.11.111.111",
      "data": "Signing session to signer : 9fe0d028-0572-4731-8520-99191340d78f@groups.esignlive.com(somegroup"
    },
    {
      "type": "View",
      "date-time": "2016-04-20 14:14:54",
      "target": "doc1",
      "user": "somegroup",
      "user-email": "9fe0d028-0572-4731-8520-99191340d78f@groups.esignlive.com",
      "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": "9fe0d028-0572-4731-8520-99191340d78f@groups.esignlive.com",
      "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": "esl.signer1@example.com",
      "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": "esl.signer1@example.com",
      "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": "esl.signer1@example.com",
      "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": "esl.signer1@example.com",
      "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 devrez peut-être récupérer une liste d’URL d’image pour les signataires qui utilisent la vérification d’identité (IDV). La liste résultante peut être les URL de l’image du document ou une image selfie.

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

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

Charge utile de réponse

[
    {
        "signerName": "Signer Name",
        "email": "signerEmail@mailinator.com",
        "idvImages": {
            "<singer_id>": {
                "idvTransactionId": "<idv_tx_id_1>",
				"attemptNumber": <attemptNumber>,
                "imageInformationList": [
                    {
                        "type": "PassportDataPage",
                        "detail": "",
                        "url": "image url for download purpose"
                    }
                ]
            }
        }
    },
    {
        "signerName": "Signer Name",
        "email": "signerEmail@mailinator.com",
        "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 devrez peut-être récupérer une image d’un signataire qui a utilisé la vérification d’identité (IDV). La liste résultante peut être les URL de l’image du document ou une image selfie.

Pour récupérer une liste d’URL d’image, vous aurez besoin du PackageId, de l’ID de transaction IDV et de l’URL de l’image qui se trouve par Retrieving a list of image URLs for IDV Evidence Summary .

Requête HTTP

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

En-têtes HTTP

Authorization: Basic api_key

Charge utile de réponse

L’image requise, au format binaire.

Récupération d’un résumé de preuves IDV au format JSON

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

• Les informations personnelles du signataire

• Informations sur le document

• 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

Charge utile de 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 de code complet, consultez notre site Code Share .

La piste d’audit 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 uniques du signataire. Le document et les signatures électroniques qu’il contient sont inviolables avec une signature numérique pour garantir l’intégrité et l’authenticité de l’enregistrement signé électroniquement. Particulièrement pertinent dans un processus à plusieurs signataires, OneSpan Sign horodate et verrouille indépendamment chaque signature et toutes les données saisies par chaque signataire indépendamment des autres. Ainsi, lorsque vous examinez la piste d’audit, même des années plus tard, il est clair qui a signé quoi, dans quel ordre, à quel moment, etc.

Tout d’abord, récupérez la liste des informations d’audit à l’aide de 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 de propriété 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 avez exécuté votre code.