Stockage des données de session de signature
  • 27 Feb 2025
  • 5 Minutes à lire
  • Sombre
    Lumière
  • PDF

Stockage des données de session de signature

  • Sombre
    Lumière
  • PDF

Résumé de l’article

SDK Java.NET SDKAPI RESTAPEX SDK

SDK Java

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

Lors de la création d'une session de signature, des données supplémentaires peuvent être enregistrées dans le cadre du résumé de la preuve. Pour ce faire, des champs de session supplémentaires sont transmis à chaque signataire lors de la création de la session de signature. Ces champs sont enregistrés dans le résumé de la preuve, et sont stockés dans les détails de la signature de vos documents signés.

Pour créer des données de session

Si vous avez besoin d'une comparaison avec la procédure de création d'objets de base, ou si c'est la première fois que vous créez une transaction, consultez la rubrique Création et envoi d'une transaction.

Après avoir créé votre paquet, vous devez créer un nouvel objet Carte avec vos paires clé/valeur. Le code suivant permet d'effectuer ce qui suit :

Map<String, String> signerSessionFields = new LinkedHashMap<>();
signerSessionFields.put("Transaction ID", "1234567890");
signerSessionFields.put("Login Token", "8888888888888");

Ensuite, utilisez le AuthenticationTokensService pour créer un jeton d'authentification du signataire à l'aide de l'packageid, l'signer id et le champ de session. Le code suivant permet d'effectuer ce qui suit :

final String signerAuthenticationToken = eslClient
    .getAuthenticationTokensService()
    .createSignerAuthenticationToken(packageId.getId(), "signer1", signerSessionFields);

Finalement, construisez l'URL de la session de signature en utilisant le jeton d'authentification du signataire. Le code suivant permet d'effectuer ce qui suit :

 System.out.println("https://sandbox.esignlive.com/access?sessionToken=" + signerAuthenticationToken); 

Résultats

Une fois que vous avez ouvert une session pour votre signataire et que le paquet a été complété, vous pouvez télécharger le résumé des preuves pour visualiser les champs de votre session.

.NET SDK

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

Lors de la création d'une session de signature, des données supplémentaires peuvent être enregistrées dans le cadre du résumé de la preuve. Pour ce faire, des champs de session supplémentaires sont transmis à chaque signataire lors de la création de la session de signature. Ces champs sont enregistrés dans le résumé de la preuve, et sont stockés dans les détails de la signature de vos documents signés.

Le code

Si vous avez besoin d'une comparaison avec la procédure de création d'objets de base, ou si c'est la première fois que vous créez une transaction, consultez la rubrique Création et envoi d'une transaction.

Après avoir créé votre paquet, vous devez créer un nouvel objet avec vos paires clé/valeur IDictionary avec vos paires clé/valeur. Le code suivant permet d'effectuer ce qui suit :

IDictionary<string, string> signerSessionFields = new Dictionary<string, string>();
signerSessionFields.Add("Transaction ID", "1234567890");
signerSessionFields.Add("Login Token", "8888888888888");

Ensuite, utilisez le AuthenticationTokensService pour créer un jeton d'authentification du signataire à l'aide de l'packageid, l'signer id et le champ de session. Le code suivant permet d'effectuer ce qui suit :

var signerAuthenticationToken = eslClient
    .AuthenticationTokenService
    .CreateSignerAuthenticationToken(packageId, "signer1", signerSessionFields);

Finalement, construisez l'URL de la session de signature en utilisant le jeton d'authentification du signataire. Le code suivant permet d'effectuer ce qui suit :

 Debug.WriteLine("https://sandbox.esignlive.com/access?sessionToken=" + signerAuthenticationToken); 

Résultats

Une fois que vous avez ouvert une session pour votre signataire et que le paquet a été complété, vous pouvez télécharger le résumé des preuves pour visualiser les champs de votre session.

API REST

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

Lors de la création d'une session de signature, des données supplémentaires peuvent être enregistrées dans le cadre du résumé de la preuve. Pour ce faire, des champs de session supplémentaires sont transmis à chaque signataire lors de la création de la session de signature. Ces champs sont enregistrés dans le résumé de la preuve, et sont stockés dans les détails de la signature de vos documents signés.

Si vous avez besoin d'une comparaison avec la procédure de création d'objets de base, ou si c'est la première fois que vous créez une transaction, consultez la rubrique Création et envoi d'une transaction.

Après avoir créé votre paquet, créez un jeton d'authentification du signataire avec les champs de session de la paire clé/valeur :

Requête HTTP

POST /api/authenticationTokens/signer/singleUse

En-têtes HTTP

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

Données utiles de la demande

{
    "packageId": "x31anVFrwliCsGQXLJoqv0GRZ1w=",
   "sessionFields": {
        "Transaction ID": "1234567890",
        "Login Token": "8888888888888"
    },
    "signerId": "signer1"
}

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

{
    "packageId": "x31anVFrwliCsGQXLJoqv0GRZ1w=",
   "signerId": "signer1",
    "value": "ZDNmMDNiNGUtNGYxOC00YWZiLTkwMmUtNWE5YmIwZTRjZDg1",
    "sessionFields": {
        "Transaction ID": "1234567890",
        "Login Token": "8888888888888"
    }
}

En plus de l'appel API ci-dessus, un nœud sessionFields peut être ajouté à toutes les autres API de création de jetons d'authentification. Pour obtenir plus d'informations, voir Jetons d'authentification.

Finalement, construisez l'URL de la session de signature en utilisant le jeton d'authentification du signataire. Le code suivant permet d'effectuer ce qui suit :

 https://sandbox.esignlive.com/access?sessionToken={signerAuthToken} 

Résultats

Une fois que vous avez ouvert une session pour votre signataire et que le paquet a été complété, vous pouvez télécharger le résumé des preuves pour visualiser les champs de votre session.

Tableau des données utiles de la demande

Propriété

Type

Modifiable

Requis

Par défaut

Exemples de valeurs

Idpaquet

chaîne de caractères

Oui

Non

s.o.

x31anVFrwliCsGQXLJoqv0GRZ1w=

IdSignataire

chaîne de caractères

Oui

Non

s.o.

signataire1

sessionFields

chaîne de caractères

Oui

Non

s.o.

ID de la transaction / 1234567890

APEX SDK

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

Lors de la création d'une session de signature, des données supplémentaires peuvent être enregistrées dans le cadre du résumé de la preuve. Pour ce faire, des champs de session supplémentaires sont transmis à chaque signataire lors de la création de la session de signature. Ces champs sont enregistrés dans le résumé de la preuve, et sont stockés dans les détails de la signature de vos documents signés.

Si vous avez besoin d'une comparaison avec la procédure de création d'objets de base, ou si c'est la première fois que vous créez une transaction, consultez la rubrique Création et envoi d'une transaction.

Après avoir créé votre paquet, vous devez créer un nouvel objet Carte avec vos paires clé/valeur. Le code suivant permet d'effectuer ce qui suit :

// Prepare session fields
Map<String, String> sessionFields = new HashMap<>();
sessionFields.put("username", "123");
sessionFields.put("password", "456");

Ensuite, utilisez la fonction encapsulée suivante pour créer un jeton d'authentification du signataire à l'aide de l'attribut packageid, signer id et les champs de session.

public String createSignerAuthenticationToken(
    String packageId, String signerId, Map<String, String> sessionFields
) 

Finalement, construisez l'URL de la session de signature en utilisant le jeton d'authentification du signataire. Le code suivant permet d'effectuer ce qui suit :

 public String buildRedirectToSigningForSigner(String authenticationToken) 

Résultats

Une fois que vous avez ouvert une session pour votre signataire et que le paquet a été complété, vous pouvez télécharger le résumé des preuves pour visualiser les champs de votre session.


Cet article vous a-t-il été utile ?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, facilitant la découverte de connaissances grâce à l’intelligence conversationnelle