- 18 Nov 2024
- 6 Minutes à lire
- SombreLumière
- PDF
Jetons d’authentification
- Mis à jour le 18 Nov 2024
- 6 Minutes à lire
- SombreLumière
- PDF
Java SDK.NET SDKREST APIAPEX SDK
Java SDK
Pour télécharger l’exemple de code complet, consultez notre site Code Share .
Un jeton d’authentification est utilisé pour obtenir une session valide pour un utilisateur particulier du système. Cette rubrique présente les types de jetons d’authentification suivants :
userAuthToken
senderAuthToken
signerAuthToken
singleUseSignerAuthToken.
À l’exception de signerAuthToken, ces jetons sont tous à usage unique. Le délai d’expiration par défaut de tous ces jetons est de 30 minutes.
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 disposant d’un accès complet au compte. Le code suivant crée 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
À l’aide du jeton d’authentification de l’utilisateur, vous pouvez accéder à votre compte OneSpan Sign en créant 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 :
// 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
À l’aide du jeton d’authentification de l’expéditeur, vous pouvez accéder au package en créant l’URL suivante :
https://sandbox.esignlive.com/auth?authenticationToken={senderToken}&target=https://sandbox.esignlive.com/a/transaction/{packageId}
Jetons d’authentification du signataire
Un jeton d’authentification de signataire est un jeton qui peut être utilisé pour obtenir une session pour un signataire ayant accès à la Signer Experience. 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 de signataire ci-dessus peut être utilisé plusieurs fois. Vous pouvez également créer un jeton de signataire à usage unique :
// 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);
À l’aide du jeton d’authentification du signataire, vous pouvez obtenir une session de signature en créant l’URL suivante :
https://sandbox.esignlive.com/access?sessionToken={signerAuthToken}
Kit de développement logiciel (SDK) .NET
Pour télécharger l’exemple de code complet, consultez notre site Code Share .
Un jeton d’authentification est utilisé pour obtenir une session valide pour un utilisateur particulier du système. Cette rubrique présente les types de jetons d’authentification suivants :
userAuthToken
senderAuthToken
signerAuthToken
singleUseSignerAuthToken.
À l’exception de signerAuthToken, ces jetons sont tous à usage unique. Le délai d’expiration par défaut de tous ces jetons est de 30 minutes.
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 disposant d’un accès complet au compte. Le code suivant crée un jeton d’authentification utilisateur :
string userAuthToken = eslClient
.AuthenticationTokenService
.CreateUserAuthenticationToken();
À l’aide du jeton d’authentification de l’utilisateur, vous pouvez accéder à votre compte OneSpan Sign en créant 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));
À l’aide du jeton d’authentification de l’expéditeur, vous pouvez accéder à la transaction en créant l’URL suivante :
https://sandbox.esignlive.com/auth?authenticationToken={senderToken}&target=https://sandbox.esignlive.com/a/transaction/{packageId}
Jetons d’authentification du signataire
Un jeton d’authentification de signataire est un jeton qui peut être utilisé pour obtenir une session pour un signataire ayant accès à la Signer Experience. Le code suivant créera un jeton d’authentification du signataire :
string signerAuthToken = eslClient
.AuthenticationTokenService
.CreateSignerAuthenticationToken(new PackageId(packageId), signerId);
Le jeton de signataire ci-dessus peut être utilisé plusieurs fois. Vous pouvez également créer un jeton de signataire à usage unique :
string singleUseToken = eslClient
.AuthenticationTokensService
.CreateSignerAuthenticationTokenForSingleUse(packageId, signerId, signerSessionFields);
À l’aide du jeton d’authentification du signataire, vous pouvez obtenir une session de signature en créant l’URL suivante :
https://sandbox.esignlive.com/access?sessionToken={signerAuthToken}
REST API
Pour télécharger l’exemple de code complet, consultez notre site Code Share .
Un jeton d’authentification est utilisé pour obtenir une session valide pour un utilisateur particulier du système. Cette rubrique présente les types de jetons d’authentification suivants :
userAuthToken
senderAuthToken
signerAuthToken
singleUseSignerAuthToken.
À l’exception de signerAuthToken, ces jetons sont tous à usage unique. Le délai d’expiration par défaut de tous ces jetons est de 30 minutes.
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 disposant d’un accès complet au compte. Le code suivant crée un jeton d’authentification utilisateur :
Requête HTTP
POST /api/authenticationTokens/user
En-têtes HTTP
Accept: application/json
Pour une description complète de chaque champ, consultez le tableau Charge utile de la demande ci-dessous.
Charge utile de réponse
{
"value": "MjY0MjQ4MzgtMTJlOS00MzhjLTgzODMtMzJmMGNiZTg3ODBl"
}
À l’aide du jeton d’authentification de l’utilisateur, vous pouvez accéder à votre compte OneSpan Sign en créant 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
Charge utile de la demande
{
"packageId": "5vjLRY5MWrDJ6MzRAEyCKOy5IH0="
}
Charge utile de réponse
{
"value": "MjY0MjQ4MzgtMTJlOS00MzhjLTgzODMtMzJmMGNiZTg3ODBl"
}
À l’aide du jeton d’authentification de l’expéditeur, vous pouvez accéder à la transaction en créant l’URL suivante :
https://sandbox.esignlive.com/auth?authenticationToken={senderToken}&target=https://sandbox.esignlive.com/a/transaction/{packageId}
Jetons d’authentification du signataire
Un jeton d’authentification de signataire est un jeton qui peut être utilisé pour obtenir une session pour un signataire ayant accès à la Signer Experience. 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
Charge utile de la 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 de signataire ci-dessus peut être utilisé plusieurs fois. Vous pouvez également créer un jeton de signataire à usage unique :
Requête HTTP
POST /api/authenticationTokens/signer/singleUse
En-têtes HTTP
Accept: application/json
Content-Type: application/json
Charge utile de la demande
{ "packageId":"s-wy6PFASBlAKfnLJjcbzoaMyTg=","signerId":"cd9lbzvjgblygdncdz3x@esignlive.com"
Charge utile de réponse
{
"packageId": "s-wy6PFASBlAKfnLJjcbzoaMyTg=","signerId": "cd9lbzvjgblygdncdz3x@esignlive.com"
}
À l’aide du jeton d’authentification du signataire, vous pouvez obtenir une session de signature en créant l’URL suivante :
https://sandbox.esignlive.com/access?sessionToken={signerAuthToken}
Tableau des données utiles de la demande
Propriété | Type | Modifiable | Obligatoire | Faire défaut | Exemples de valeurs |
---|---|---|---|---|---|
packageID | corde | Non | Non | n/a | 5vjLRY5MWrDJ6MzRAEyCKOy5IH0= |
signerId | corde | Oui | Non | n/a | 8B734331-BC5B-4843-9784-D4ECE4B7DC22 |
valeur | corde | Non | Non | n/a | ZDNmMDNiNGUtNGYxOC00YWZiLTkwMmUtNWE5YmIwZTRjZDg1 |
APEX SDK
Pour télécharger l’exemple de code complet, consultez notre site Code Share .
Un jeton d’authentification est utilisé pour obtenir une session valide pour un utilisateur particulier du système. Cette rubrique présente les types de jetons d’authentification suivants :
userAuthToken
senderAuthToken
signerAuthToken
singleUseSignerAuthToken.
À l’exception de signerAuthToken, ces jetons sont tous à usage unique. Le délai d’expiration par défaut de tous ces jetons est de 30 minutes.
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 disposant d’un accès complet au compte. Le code suivant crée un jeton d’authentification utilisateur :
public String createUserAuthenticationToken() {
// Your implementation here
}
À l’aide du jeton d’authentification de l’utilisateur, vous pouvez accéder à votre compte OneSpan Sign en créant 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 :
public String createSenderAuthenticationToken(String packageId) {
// Your implementation here
}
À l’aide du jeton d’authentification de l’expéditeur, vous pouvez accéder à la transaction en créant l’URL suivante :
https://sandbox.esignlive.com/auth?authenticationToken={senderToken}&target=https://sandbox.esignlive.com/a/transaction/{packageId}
Jetons d’authentification du signataire
Un jeton d’authentification de signataire est un jeton qui peut être utilisé pour obtenir une session pour un signataire ayant accès à la Signer Experience. Le code suivant créera un jeton d’authentification du signataire :
public String createSignerAuthenticationTokenForMultiUse(String packageId, String signerId)
Le jeton de signataire ci-dessus peut être utilisé plusieurs fois. Vous pouvez également créer un jeton de signataire à usage unique :
public String createSignerAuthenticationTokenForMultiUse(String packageId, String signerId) {
// Your implementation here
}
L’ID du signataire dans cette fonction peut également être remplacé par l’E-mail du signataire. À l’aide du jeton d’authentification du signataire, vous pouvez obtenir une session de signature en créant l’URL suivante :
https://sandbox.esignlive.com/access?sessionToken={signerAuthToken}