Mise en œuvre de la capture de signature

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

Dans OneSpan Sign, les signataires ne seront invités à apposer leur signature qu'une seule fois par défaut. Si la transaction nécessite plusieurs signatures sur le document, OneSpan Sign reproduira automatiquement la première signature dessinée pour toutes les signatures suivantes. Toutefois, vous avez la possibilité d'exiger de votre signataire qu'il dessine sa signature sur toute signature de capture donnée. Ce sujet se concentrera sur l'application de la capture de signature au niveau de la signature.

Si vous souhaitez appliquer cette règle au niveau de la transaction, ce qui obligerait à redessiner toutes les signatures de capture, consultez les Paramètres de l'expérience du signataire.

Appliquer la signature par capture

Pour activer cette fonction, il suffit d'ajouter l'option enableEnforceCaptureSignature() à votre créateur de signature, comme indiqué ci-dessous :

Signature enforceCaptureSignature = SignatureBuilder.captureFor("signer1@example.com")
    .onPage(0)
    .atPosition(100, 200)
    .enableEnforceCaptureSignature()
    .build();

Notez ce qui suit :

• Par défaut, enforceCaptureSignature est défini comme « faux » au niveau de la transaction et de la signature. Cela signifie que vous ne devez rien faire si vous ne voulez pas utiliser cette fonction.

• Contrairement au paramètre « vrai » enforceCaptureSignature au niveau de la transaction, qui oblige le signataire à capturer sa signature à chaque approbation, au niveau de la signature, enforceCaptureSignature n'oblige le signataire à capturer sa signature que lorsque l'approbation contient le paramètre « vrai ».

Résultats

Dans cet exemple, nous avons trois approbations où seule la deuxième signature a été marquée comme « appliquer la capture ». Voici ce que vous verrez après la signature de la transaction :

Pour la deuxième signature, comme nous avons activé le paramètre enforceCaptureSignature, vous verrez que la signature diffère de la première et qu'elle écrase en même temps les données de signature mises en cache. Par conséquent, la signature nouvellement capturée se réplique automatiquement lorsque le signataire signe le troisième champ.

.NET SDK

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

Dans OneSpan Sign, les signataires ne seront invités à apposer leur signature qu'une seule fois par défaut. Si la transaction nécessite plusieurs signatures sur le document, OneSpan Sign reproduira automatiquement la première signature dessinée pour toutes les signatures suivantes. Toutefois, vous avez la possibilité d'exiger de votre signataire qu'il dessine sa signature sur toute signature de capture donnée. Ce sujet se concentrera sur l'application de la capture de signature au niveau de la signature.

Si vous souhaitez appliquer cette règle au niveau de la transaction, ce qui obligerait à redessiner toutes les signatures de capture, consultez les Paramètres de l'expérience du signataire.

Appliquer la signature par capture

Pour activer cette fonction, il suffit d'ajouter l'option enableEnforceCaptureSignature() à votre créateur de signature, comme indiqué ci-dessous :

Signature enforceCaptureSignature = SignatureBuilder.CaptureFor("signer1@example.com")
    .WithId(new SignatureId("Signature1"))
    .OnPage(0)
    .AtPosition(100, 200)
    .EnableEnforceCaptureSignature()
    .Build();

Notez ce qui suit :

• Par défaut, enforceCaptureSignature est défini comme « faux » au niveau de la transaction et de la signature. Cela signifie que vous ne devez rien faire si vous ne voulez pas utiliser cette fonction.

• Contrairement au paramètre « vrai » enforceCaptureSignature au niveau de la transaction, qui oblige le signataire à capturer sa signature à chaque approbation, au niveau de la signature, enforceCaptureSignature n'oblige le signataire à capturer sa signature que lorsque l'approbation contient le paramètre « vrai ».

Résultats

Dans cet exemple, nous avons trois approbations où seule la deuxième signature a été marquée comme « appliquer la capture ». Voici ce que vous verrez après la signature de la transaction :

Pour la deuxième signature, comme nous avons activé le paramètre enforceCaptureSignature, vous verrez que la signature diffère de la première et qu'elle écrase en même temps les données de signature mises en cache. Par conséquent, la signature nouvellement capturée se réplique automatiquement lorsque le signataire signe le troisième champ.

API REST

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

Dans OneSpan Sign, les signataires ne seront invités à apposer leur signature qu'une seule fois par défaut. Si la transaction nécessite plusieurs signatures sur le document, OneSpan Sign reproduira automatiquement la première signature dessinée pour toutes les signatures suivantes. Toutefois, vous avez la possibilité d'exiger de votre signataire qu'il dessine sa signature sur toute signature de capture donnée. Ce sujet se concentrera sur l'application de la capture de signature au niveau de la signature.

Si vous souhaitez appliquer cette règle au niveau de la transaction, ce qui obligerait à redessiner toutes les signatures de capture, consultez les Paramètres de l'expérience du signataire.

Appliquer la signature par capture

L'exemple de demande ci-dessous vous montre comment définir enforceCaptureSignature : true au niveau de l'approbation.

Requête HTTP

POST /api/packages 

En-têtes HTTP

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

Données utiles de la demande

------WebKitFormBoundary1bNO60n7FqP5WO4t
Content-Disposition: form-data; name="file"; filename="enforce capture signature.pdf"
Content-Type: application/pdf
%PDF-1.5
%µµµµ
1 0 obj
<>>> endobj....

------WebKitFormBoundary1bNO60n7FqP5WO4t
Content-Disposition: form-data; name="payload"
{
  "documents": [
    {
      "approvals": [
        {
          "fields": [
            {
              "height": 50,
              "id": "Signature1",
              "left": 100,
              "page": 0,
              "subtype": "CAPTURE",
              "top": 100,
              "type": "SIGNATURE",
              "width": 200
            }
          ],
          "id": "Signature1",
          "role": "signer1"
        },
        {
          "fields": [
            {
              "height": 50,
              "id": "Signature2",
              "left": 100,
              "page": 0,
              "subtype": "CAPTURE",
              "top": 200,
              "type": "SIGNATURE",
              "width": 200
            }
          ],
          "id": "Signature2",
          "role": "signer1",
          "enforceCaptureSignature": true
        },
        {
          "fields": [
            {
              "height": 50,
              "id": "Signature3",
              "left": 100,
              "page": 0,
              "subtype": "CAPTURE",
              "top": 300,
              "type": "SIGNATURE",
              "width": 200
            }
          ],
          "id": "Signature3",
          "role": "signer1"
        }
      ],
      "name": "Document1",
      "id": "Document1"
    }
  ],
  "name": "test Enforce Capture at Signature Level",
  "roles": [
    {
      "id": "signer1",
      "signers": [
        {
          "email": "signer1@example.com",
          "firstName": "John",
          "id": "signer1",
          "lastName": "Smith"
        }
      ]
    }
  ],
  "type": "PACKAGE",
  "status": "SENT"
}
------WebKitFormBoundary1bNO60n7FqP5WO4t--

Pour une description complète de chaque champ, voir le tableau des données utiles de la demande ci-dessous.

Données utiles de la réponse

 {   "id": "Q6v0Tn_v62G5tfRY43VBE-TEbU4="   } 

Notez ce qui suit :

• Par défaut, enforceCaptureSignature est défini comme « faux » au niveau de la transaction et de la signature. Cela signifie que vous ne devez rien faire si vous ne voulez pas utiliser cette fonction.

• Contrairement au paramètre « vrai » enforceCaptureSignature au niveau de la transaction, qui oblige le signataire à capturer sa signature à chaque approbation, au niveau de la signature, enforceCaptureSignature n'oblige le signataire à capturer sa signature que lorsque l'approbation contient le paramètre « vrai ».

Résultats

Dans cet exemple, nous avons trois approbations où seule la deuxième signature a été marquée comme « appliquer la capture ». Voici ce que vous verrez après la signature de la transaction :

Pour la deuxième signature, comme nous avons activé le paramètre enforceCaptureSignature, vous verrez que la signature diffère de la première et qu'elle écrase en même temps les données de signature mises en cache. Par conséquent, la signature nouvellement capturée se réplique automatiquement lorsque le signataire signe le troisième champ.

Tableau des données utiles de la demande