Jetons d’authentification

Prev Next

Java SDK

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

Un jeton d’authentification est utilisé pour obtenir une session valide pour un utilisateur particulier du système. Ce sujet présente les types suivants de jetons d’authentification :

  • userAuthToken

  • senderAuthToken

  • signerAuthToken

  • singleUseSignerAuthToken.

À l’exception de signerAuthToken , ces jetons sont tous à usage unique. Le délai d’expiration par défaut pour tous ces jetons est de 30 minutes.

Une fonction optionnelle de jeton d’authentification de l’expéditeur est également disponible. Auparavant, lorsque vous demandiez un jeton d’authentification de l’expéditeur, vous deviez spécifier un identifiant de transaction. Le jeton d’authentification de l’expéditeur alors généré pouvait être utilisé pour accéder à cette transaction spécifique ou à toute autre transaction disponible pour l’expéditeur. En utilisant un jeton d’authentification de l’expéditeur, vous pouvez également restreindre les droits d’accès de l’expéditeur uniquement à la transaction utilisée pour la générer. Pour activer cette fonctionnalité, contactez notre Support Team.

Le Code

Jetons d’authentification utilisateur

Un jeton d’authentification utilisateur est un jeton qui peut être utilisé pour obtenir une session pour un utilisateur ayant un accès complet au compte. Le code suivant créera un jeton d’authentification utilisateur :

 // Generate a user authentication token using the eSignLive client
String userAuthToken = eslClient
    .getAuthenticationTokensService()  // Access the authentication tokens service
    .createUserAuthenticationToken();  // Create a new user authentication token

En utilisant le jeton d’authentification utilisateur, vous pouvez accéder à votre compte OneSpan Sign en construisant l’URL suivante :

https://sandbox.esignlive.com/auth?authenticationToken={userToken}&target=https://sandbox.esignlive.com/a/dashboard

Jetons d’authentification de l’expéditeur

Un jeton d’authentification de l’expéditeur est un jeton qui peut être utilisé pour obtenir une session pour un expéditeur ayant accès uniquement à un paquet spécifique. Le code suivant créera un jeton d’authentification de l’expéditeur :

// Generate a sender authentication token using the eSignLive client
String senderAuthToken = eslClient
    .getAuthenticationTokensService()  // Access the authentication tokens service
    .createsenderAuthenticationToken(packageId);  // Create a new sender authentication token for the specified package

En utilisant le jeton d’authentification de l’expéditeur, vous pouvez accéder au package en construisant l’URL suivante :

https://sandbox.esignlive.com/auth?senderAuthenticationToken={senderToken}&target=https://sandbox.esignlive.com/a/transaction/{packageId}/designer

Jetons d’authentification signataires

Un jeton d’authentification du signataire est un jeton qui peut être utilisé pour obtenir une session pour un signataire ayant accès à l’expérience du signataire. Le code suivant créera un jeton d’authentification du signataire :

// Generate a signer authentication token using the eSignLive client
String signerAuthToken = eslClient
    .getAuthenticationTokensService()  // Access the authentication tokens service
    .createSignerAuthenticationToken(packageId, signerId);  // Create a new signer authentication token for the specified package and signer

Le jeton signataire ci-dessus peut être utilisé plusieurs fois. Vous pouvez également créer un jeton signataire avec une seule utilisation :

// Generate a single-use authentication token for a signer
String singleUseToken = eslClient
    // Access the authentication tokens service from the client
    .getAuthenticationTokensService()
    // Create a single-use authentication token for the specified signer in the given package
    .createSignerAuthenticationTokenForSingleUse(packageId, signerId, signerSessionFields);

En utilisant le jeton d’authentification du signataire, vous pouvez obtenir une session de signature en construisant l’URL suivante :

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

.NET SDK

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

Un jeton d’authentification est utilisé pour obtenir une session valide pour un utilisateur particulier du système. Ce sujet présente les types suivants de jetons d’authentification :

  • userAuthToken

  • senderAuthToken

  • signerAuthToken

  • singleUseSignerAuthToken.

À l’exception de signerAuthToken , ces jetons sont tous à usage unique. Le délai d’expiration par défaut pour tous ces jetons est de 30 minutes.

Une fonction optionnelle de jeton d’authentification de l’expéditeur est également disponible. Auparavant, lorsque vous demandiez un jeton d’authentification de l’expéditeur, vous deviez spécifier un identifiant de transaction. Le jeton d’authentification de l’expéditeur alors généré pouvait être utilisé pour accéder à cette transaction spécifique ou à toute autre transaction disponible pour l’expéditeur. En utilisant un jeton d’authentification de l’expéditeur, vous pouvez également restreindre les droits d’accès de l’expéditeur uniquement à la transaction utilisée pour la générer. Pour activer cette fonctionnalité, contactez notre Support Team.

Le Code

Jetons d’authentification utilisateur

Un jeton d’authentification utilisateur est un jeton qui peut être utilisé pour obtenir une session pour un utilisateur ayant un accès complet au compte. Le code suivant créera un jeton d’authentification utilisateur :

string userAuthToken = eslClient
    .AuthenticationTokenService
    .CreateUserAuthenticationToken();

En utilisant le jeton d’authentification utilisateur, vous pouvez accéder à votre compte OneSpan Sign en construisant l’URL suivante :

https://sandbox.esignlive.com/auth?authenticationToken={userToken}&target=https://sandbox.esignlive.com/a/dashboard

Jetons d’authentification de l’expéditeur

Un jeton d’authentification de l’expéditeur est un jeton qui peut être utilisé pour obtenir une session pour un expéditeur ayant accès uniquement à un package spécifique. Le code suivant créera un jeton d’authentification de l’expéditeur :

 string senderAuthToken = eslClient
    .AuthenticationTokenService
    .CreateSenderAuthenticationToken(new PackageId(packageId));

En utilisant le jeton d’authentification de l’expéditeur, vous pouvez accéder à la transaction en construisant l’URL suivante :

https://sandbox.esignlive.com/auth?senderAuthenticationToken={senderToken}&target=https://sandbox.esignlive.com/a/transaction/{packageId}/designer

Jetons d’authentification signataires

Un jeton d’authentification du signataire est un jeton qui peut être utilisé pour obtenir une session pour un signataire ayant accès à l’expérience du signataire. Le code suivant créera un jeton d’authentification du signataire :

string signerAuthToken = eslClient
    .AuthenticationTokenService
    .CreateSignerAuthenticationToken(new PackageId(packageId), signerId);

Le jeton signataire ci-dessus peut être utilisé plusieurs fois. Vous pouvez également créer un jeton signataire avec une seule utilisation :

string singleUseToken = eslClient
    .AuthenticationTokensService
    .CreateSignerAuthenticationTokenForSingleUse(packageId, signerId, signerSessionFields);

En utilisant le jeton d’authentification du signataire, vous pouvez obtenir une session de signature en construisant l’URL suivante :

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

REST API

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

Un jeton d’authentification est utilisé pour obtenir une session valide pour un utilisateur particulier du système. Ce sujet présente les types suivants de jetons d’authentification :

  • userAuthToken

  • senderAuthToken

  • signerAuthToken

  • singleUseSignerAuthToken.

À l’exception de signerAuthToken , ces jetons sont tous à usage unique. Le délai d’expiration par défaut pour tous ces jetons est de 30 minutes.

Une fonction optionnelle de jeton d’authentification de l’expéditeur est également disponible. Auparavant, lorsque vous demandiez un jeton d’authentification de l’expéditeur, vous deviez spécifier un identifiant de transaction. Le jeton d’authentification de l’expéditeur alors généré pouvait être utilisé pour accéder à cette transaction spécifique ou à toute autre transaction disponible pour l’expéditeur. En utilisant un jeton d’authentification de l’expéditeur, vous pouvez également restreindre les droits d’accès de l’expéditeur uniquement à la transaction utilisée pour la générer. Pour activer cette fonctionnalité, contactez notre Support Team.

Le Code

Jetons d’authentification utilisateur

Un jeton d’authentification utilisateur est un jeton qui peut être utilisé pour obtenir une session pour un utilisateur ayant un accès complet au compte. Le code suivant créera un jeton d’authentification utilisateur :

Requête HTTP

POST /api/authenticationTokens/user

En-têtes HTTP

Accept: application/json   
Authorization: Basic api_key 

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

Charge utile de réponse

{
    "value": "MjY0MjQ4MzgtMTJlOS00MzhjLTgzODMtMzJmMGNiZTg3ODBl"
}

En utilisant le jeton d’authentification utilisateur, vous pouvez accéder à votre compte OneSpan Sign en construisant l’URL suivante :

https://sandbox.esignlive.com/auth?authenticationToken={userToken}&target=https://sandbox.esignlive.com/a/dashboard

Jetons d’authentification de l’expéditeur

Un jeton d’authentification de l’expéditeur est un jeton qui peut être utilisé pour obtenir une session pour un expéditeur ayant accès uniquement à un package spécifique. Le code suivant créera un jeton d’authentification de l’expéditeur :

Requête HTTP

POST /api/authenticationTokens/sender

En-têtes HTTP

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

Charge utile de demande

{
    "packageId": "5vjLRY5MWrDJ6MzRAEyCKOy5IH0="
}

Charge utile de réponse

{
     "packageId": "5vjLRY5MWrDJ6MzRAEyCKOy5IH0=""value": "MjY0MjQ4MzgtMTJlOS00MzhjLTgzODMtMzJmMGNiZTg3ODBl"
}

En utilisant le jeton d’authentification de l’expéditeur, vous pouvez accéder à la transaction en construisant l’URL suivante :

https://sandbox.esignlive.com/auth?senderAuthenticationToken={senderToken}&target=https://sandbox.esignlive.com/a/transaction/{packageId}/designer

Jetons d’authentification signataires

Un jeton d’authentification du signataire est un jeton qui peut être utilisé pour obtenir une session pour un signataire ayant accès à l’expérience du signataire. Le code suivant créera un jeton d’authentification du signataire :

Requête HTTP

POST /api/authenticationTokens/signer/multiUse

En-têtes HTTP

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

Charge utile de demande

{
    "packageId": "5vjLRY5MWrDJ6MzRAEyCKOy5IH0=","signerId": "8b734331-bc5b-4843-9784-d4ece4b7dc22"
}

Charge utile de réponse

{
    "packageId": "5vjLRY5MWrDJ6MzRAEyCKOy5IH0=","signerId": "8b734331-bc5b-4843-9784-d4ece4b7dc22",
    "value": "ZDNmMDNiNGUtNGYxOC00YWZiLTkwMmUtNWE5YmIwZTRjZDg1"
}

Le jeton signataire ci-dessus peut être utilisé plusieurs fois. Vous pouvez également créer un jeton signataire avec une seule utilisation :

Requête HTTP

POST /api/authenticationTokens/signer/singleUse

En-têtes HTTP

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

Charge utile de demande

 {   "packageId":"s-wy6PFASBlAKfnLJjcbzoaMyTg=","signerId":"cd9lbzvjgblygdncdz3x@esignlive.com"   } 

Charge utile de réponse

{
    "packageId": "s-wy6PFASBlAKfnLJjcbzoaMyTg=","signerId": "cd9lbzvjgblygdncdz3x@esignlive.com"
}

En utilisant le jeton d’authentification du signataire, vous pouvez obtenir une session de signature en construisant l’URL suivante :

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

Table des charges utiles de requêtes

Propriété

Type

Modifiable

Obligatoire

Par défaut

Valeurs d’échantillonnage

packageID

Corde

Non

Non

N/D

5vjLRY5MWrDJ6MzRAEyCKOy5IH0=

signerId

Corde

Oui

Non

N/D

8b734331-bc5b-4843-9784-d4ece4b7dc22

Valeur

Corde

Non

Non

N/D

ZDNmMDNiNGUtNGYxOC00YWZiLTkwMmUtNWE5YmIwZTRjZDg1

APEX SDK

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

Un jeton d’authentification est utilisé pour obtenir une session valide pour un utilisateur particulier du système. Ce sujet présente les types suivants de jetons d’authentification :

  • userAuthToken

  • senderAuthToken

  • signerAuthToken

  • singleUseSignerAuthToken.

À l’exception de signerAuthToken , ces jetons sont tous à usage unique. Le délai d’expiration par défaut pour tous ces jetons est de 30 minutes.

Une fonction optionnelle de jeton d’authentification de l’expéditeur est également disponible. Auparavant, lorsque vous demandiez un jeton d’authentification de l’expéditeur, vous deviez spécifier un identifiant de transaction. Le jeton d’authentification de l’expéditeur alors généré pouvait être utilisé pour accéder à cette transaction spécifique ou à toute autre transaction disponible pour l’expéditeur. En utilisant un jeton d’authentification de l’expéditeur, vous pouvez également restreindre les droits d’accès de l’expéditeur uniquement à la transaction utilisée pour la générer. Pour activer cette fonctionnalité, contactez notre Support Team.

Le Code

Jetons d’authentification utilisateur

Un jeton d’authentification utilisateur est un jeton qui peut être utilisé pour obtenir une session pour un utilisateur ayant un accès complet au compte. Le code suivant créera un jeton d’authentification utilisateur :

 public String createUserAuthenticationToken() {
    // Your implementation here
}

En utilisant le jeton d’authentification utilisateur, vous pouvez accéder à votre compte OneSpan Sign en construisant l’URL suivante :

https://sandbox.esignlive.com/auth?authenticationToken={userToken}&target=https://sandbox.esignlive.com/a/dashboard

Jetons d’authentification de l’expéditeur

Un jeton d’authentification de l’expéditeur est un jeton qui peut être utilisé pour obtenir une session pour un expéditeur ayant accès uniquement à un paquet spécifique. Le code suivant créera un jeton d’authentification de l’expéditeur :

public String createsenderAuthenticationToken(String packageId) {
    // Your implementation here
}

En utilisant le jeton d’authentification de l’expéditeur, vous pouvez accéder à la transaction en construisant l’URL suivante :

https://sandbox.esignlive.com/auth?senderAuthenticationToken={senderToken}&target=https://sandbox.esignlive.com/a/transaction/{packageId}/designer

Jetons d’authentification signataires

Un jeton d’authentification du signataire est un jeton qui peut être utilisé pour obtenir une session pour un signataire ayant accès à l’expérience du signataire. Le code suivant créera un jeton d’authentification du signataire :

 public String createSignerAuthenticationTokenForMultiUse(String packageId, String signerId) 

Le jeton signataire ci-dessus peut être utilisé plusieurs fois. Vous pouvez également créer un jeton signataire avec une seule utilisation :

public String createSignerAuthenticationTokenForMultiUse(String packageId, String signerId) {
    // Your implementation here
}

L’identifiant du signataire dans cette fonction peut également être remplacé par Email du signataire. En utilisant le jeton d’authentification du signataire, vous pouvez obtenir une session de signature en construisant l’URL suivante :

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