OneSpan Sign Developers : Gestion des pièces jointes des signataires

OneSpan Sign propose une fonction remarquable qui permet aux signataires de télécharger des pièces jointes pendant le processus de signature. Cela permet non seulement aux signataires, mais aussi aux expéditeurs de consulter la pièce jointe et de conclure la transaction.

Dans ce billet de blog, nous allons voir comment un expéditeur peut mandater un signataire pour qu'il ajoute une pièce jointe à la transaction. Sans plus attendre, plongeons dans le vif du sujet !

Création d'une demande de pièce jointe

Tout d'abord, nous allons démontrer trois méthodes dans le SDK et l'API RESTful pour modifier le bloc du signataire et demander une pièce jointe lors de la création de la transaction.

Dans le SDK Java :

.withSigner(SignerBuilder.newSignerWithEmail("[email protected]")
  .withFirstName("John")
 .withLastName("Doe")
 .withCustomId("Signer1")
 .withAttachmentRequirement(AttachmentRequirementBuilder.newAttachmentRequirementWithName("Permis de conduire")
	 .withDescription("Veuillez télécharger une copie de votre permis de conduire.")
	 .isRequiredAttachment()
	 .build()))

Dans le SDK .NET :

.WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]")
    .WithFirstName("John")
    .WithLastName("Doe")
    .WithCustomId("Signer1")
    .WithAttachmentRequirement(AttachmentRequirementBuilder.NewAttachmentRequirementWithName("Permis de conduire")
        .WithDescription("Veuillez télécharger une copie de votre permis de conduire.")
        .IsRequiredAttachment()
        .Build()))

Via l'API RESTful :

{
  "id" : "Signer1",
  "name" : "Signer1",
  "index" : 1,
  "attachmentRequirements" : [
    {
      "description" : "Veuillez télécharger une copie scannée de votre permis de conduire",
      "required" : vrai,
      "name" : "Permis de conduire"
    }
  ],
  "signers" : [
    {
      "firstName" : "John",
      "lastName" : "Smith",
      "email" : "[email protected]"
    }
  ]
}

Vous avez la possibilité de spécifier un nom et une description du téléchargement de fichier que vous demandez. Le nom et la description ne doivent pas dépasser 255 caractères chacun. En outre, vous pouvez déterminer si la pièce jointe est obligatoire. Alors que la description et l'exigence sont facultatives, l'identifiant de la pièce jointe est généré automatiquement par le système OSS et ne peut pas être modifié.

Autoriser les types de téléchargement

Votre sécurité étant une préoccupation majeure, OneSpan Sign propose une liste de blocage globale, interdisant certains types de téléchargement tels que "EXE", "DLL", "MSI", "DMG", "SO". En outre, si vous avez besoin de types de fichiers spécifiques, vous pouvez établir une liste d'autorisation dans votre compte.

Par exemple, si votre intégration n'attend qu'une copie d'image, vous pouvez définir votre liste d'autorisation pour inclure "JPG", "JPEG", "PNG", et ainsi empêcher tous les autres types de fichiers d'être téléchargés.

La liste blanche par défaut inclut PDF, DOC, DOCX, RTF, ODT, JPG, JPEG, PNG, BMP, TXT, TIFF, TIF, GIF, XLS, XLSX. N'hésitez pas à contacter notre équipe d'assistance pour des ajustements personnalisés.

Limitation des fichiers par pièce jointe

Lorsque plusieurs fichiers sont téléchargés pour une seule pièce jointe, ces fichiers seront ensuite téléchargés sous la forme d'un fichier zip. Si votre intégration ne peut pas décompresser ces fichiers, vous avez désormais la possibilité de définir un nombre maximum de fichiers à télécharger. Si la limite est fixée à 1, tout téléchargement ultérieur pour la même pièce jointe déclenchera ce message d'erreur :

Cette limite est un paramètre de paquet qui s'applique à toutes les pièces jointes associées :

"settings" > "ceremony" > "maxAttachmentFiles" : 1

Les utilisateurs ad hoc peuvent ajuster la valeur directement dans le panneau des paramètres de la transaction ou du modèle.

La taille maximale d'une pièce jointe est de 16 Mo :

Rejoignez la communauté des développeurs OneSpan

En conclusion, OneSpan Sign offre une plateforme robuste et sécurisée pour la gestion des pièces jointes des signataires, améliorant ainsi votre expérience des transactions numériques. Si vous avez des questions sur ce blog ou sur l'intégration de OneSpan Sign dans votre application, visitez les forums de la communauté des développeurs. Vos commentaires nous intéressent !