OneSpan Sign Developer: Demande de compte et réinitialisation de mot de passe

Duo Liang, août 29, 2018

Dans notre blog précédent, "Retrieve Sender Packages", nous avons discuté des concepts autour et les différences entre les propriétaires de comptes et les membres de compte (Senders). En tant que propriétaire de compte, l'ajout d'expéditeurs avec différents e-mails est très utile, car il leur accorde la possibilité d'envoyer et de gérer des transactions séparément. Ici, nous allons examiner de plus près comment inviter / créer un expéditeur à votre compte principal.

L'image suivante vous montre comment inviter un expéditeur en utilisant une méthode REST ou SDK :

8-30-1

Note:

Le message d'erreur le plus courant que vous pouvez rencontrer est : 

"messageKey":"error.validation.senderAlreadyMemberOfAnother","message":"Sender is already a member of another account.","code":400,"name":"Validation Error"

Parce que dans un environnement portail unique, comme Sandbox US V11, un e-mail ne peut devenir un expéditeur sous un seul compte principal. Par conséquent, cette erreur se produit parce que vous invitez un compte de messagerie qui est déjà devenu un propriétaire de compte ou un membre du compte.

Mais il sera bien si vous êtes prêt à aller vivre sur la production et de créer des expéditeurs avec le même e-mail dans le nouvel environnement. Selon la restriction dont nous avons parlé ci-dessus, le Sandbox et LE PROD sont des environnements différents, de sorte que les comptes sont mutuellement indépendants.

"INVITED" vs "ACTIVE"

Dans l'exemple ci-dessus, nous avons invité un nouvel expéditeur à notre compte avec le statut de "INVITED" qui est un flux de travail standard pour ajouter un expéditeur. Alors que dans OneSpan Sign, vous pouvez également sauter l'e-mail d'invitation et ajouter un expéditeur directement avec le statut "ACTIVE" lorsque vous n'avez pas besoin de vos expéditeurs pour définir leur mot de passe et leur profil de base. Nous expliquerons ces deux concepts séparément.

INVITÉ: Le statut INVITÉ est un statut en attente, et OneSpan Sign enverra un e-mail à votre e-mail invité incitant l'expéditeur à remplir certaines informations utilisateur de base, telles que le prénom, le nom de famille et le mot de passe. Une fois ces informations communiquées, le statut du nouvel expéditeur changera en « ACTIVE ».

Note:

Les prénoms et les noms de famille que OneSpan Sign avait initialement dans le fichier seront écrasés par tout ce que l'utilisateur entre réellement quand ils sont invités.

ACTIVE : Au lieu de créer un expéditeur avec le statut INVITED, vous pouvez définir directement le statut de votre expéditeur sur ACTIVE sans demander d'informations utilisateur et les inciter à créer un mot de passe. Cela ne limitera pas la fonctionnalité du compte, vous pouvez toujours récupérer la clé API de l'expéditeur et appeler les API pour votre expéditeur. La principale différence entre ces deux approches est qu'un expéditeur immédiatement réglé sur ACTIVE n'aura pas de mot de passe réglé. Cela empêche l'expéditeur de se connecter au portail Web actuellement.

Pour envoyer l'e-mail d'invitation manuellement, vous pouvez appeler l'API suivante :

POST /api/account/senders/roleIDMD/invite

Pour d’autres gestions sur Les expéditeurs, vous pouvez avoir un chèque sur Senders Guide.

Réinitialisation du mot de passe

Lorsque vous avez besoin de réinitialisation de votre mot de passe, vous pouvez cliquer sur « Oublié votre mot de passe » à votre page de connexion Web Portal et entrer un e-mail de compte. En réponse, un e-mail de réinitialisation de mot de passe sera envoyé. Avec OneSpan Sign, nous disposons d'une interface API pour ceci :

Demande HTTP

POST /api/account/senders/roleIDMD/resetpassword

En-têtes HTTP

Accepter : application/json

Autorisation: api_key de base

Note:

Cette API est juste pour l'envoi d'un e-mail de réinitialiser à l'adresse e-mail de l'expéditeur. Il ne changera pas votre mot de passe directement.

Contrairement au portail Web, vous pouvez envoyer un e-mail de réinitialise à n'importe quel compte. Avec cette API, vous ne pouvez envoyer un e-mail de réinitialise aux expéditeurs sous votre propriétaire de compte et non pas votre compte principal ou les expéditeurs sous d'autres comptes.

Les modèles de messagerie pour l'invitation de compte et la demande de mot@onespande passe-repos peuvent être personnalisés si vous contactez notre équipe de support à sign.support.com.

En plus de réinitialiser le mot de passe de email, vous pouvez également modifier votre mot de passe à votre tableau de bord d'interface web. La section Mot de passe de la page « Mon compte » vous permet de modifier le mot de passe de votre compte en donnant le mot de passe actuel.

8-30-2

Si vous avez des questions concernant ce blog ou toute autre chose concernant l'intégration de OneSpan Sign dans votre application, visitez les Forums communautairesdes développeurs . Vos commentaires sont importants pour nous!