OneSpan Sign Developer: Invitación a la cuenta y restablecimiento de la contraseña

En nuestro blog anterior, "Recuperar paquetes de remitentes", hablamos de los conceptos en torno a los propietarios de cuentas y los miembros de cuentas (remitentes) y de las diferencias entre ellos. Como propietario de una cuenta, añadir remitentes con diferentes correos electrónicos es muy útil, porque les otorga la capacidad de enviar y gestionar transacciones por separado. Aquí veremos con más detalle cómo invitar/crear un remitente a tu cuenta principal.

La siguiente imagen muestra cómo invitar a un remitente utilizando un método REST o SDK:

Nota:

El mensaje de error más común que puede encontrar es

{"messageKey": "error.validation.senderAlreadyMemberOfAnother", "message": "El remitente ya es miembro de otra cuenta.", "code":400, "name": "Validation Error"}

Porque en un entorno de portal único, como el Sandbox US V11, un correo electrónico sólo puede convertirse en remitente bajo una cuenta principal. Por lo tanto, este error se produce porque está invitando a una cuenta de correo electrónico que ya se ha convertido en propietario de la cuenta o en miembro de la misma.

Pero estará bien si usted está listo para ir en vivo en la producción y crear remitentes con el mismo correo electrónico en el nuevo entorno. Según la restricción de la que hablamos anteriormente, el Sandbox y el PROD son entornos diferentes, por lo que las cuentas son mutuamente independientes.

"INVITADO" frente a "ACTIVO"

En el ejemplo anterior, hemos invitado a un nuevo remitente a nuestra cuenta con el estado "INVITED", que es un flujo de trabajo estándar para añadir un remitente. En OneSpan Sign, también puede omitir el correo electrónico de invitación y añadir un remitente directamente con el estado "ACTIVO" cuando no necesite que sus remitentes establezcan su contraseña y perfil básico. Explicaremos estos dos conceptos por separado.

INVITED: El estado INVITED es un estado pendiente, y OneSpan Sign enviará un correo electrónico a su correo electrónico invitado solicitando al remitente que rellene alguna información básica del usuario, como el nombre, el apellido y la contraseña. Una vez enviada esta información, el estado del nuevo remitente cambiará a "ACTIVO".

Nota:

El nombre y los apellidos que OneSpan Sign tenía originalmente en el archivo serán sobrescritos por lo que el usuario introduzca realmente cuando sea invitado.

ACTIVO: En lugar de crear un remitente con el estado INVITED, puede establecer directamente el estado de su remitente en ACTIVO sin solicitar la información del usuario ni pedirle que cree una contraseña. Hacerlo no limitará la funcionalidad de la cuenta, todavía puede recuperar la clave API del remitente y llamar a las API de su remitente. La principal diferencia entre estos dos enfoques es que un emisor configurado inmediatamente como ACTIVO no tendrá una contraseña establecida. Esto impide que el remitente se conecte al Portal Web actualmente.

Para enviar el correo electrónico de invitación manualmente, puede llamar a la siguiente API:

POST /api/account/senders/{roleID}/invite

Para otras gestiones sobre los remitentes, puede consultar la Guía de remitentes.

Restablecimiento de la contraseña

Si necesita restablecer su contraseña, puede hacer clic en "Ha olvidado su contraseña" en la página de inicio de sesión del portal web e introducir un correo electrónico de la cuenta. En respuesta, se enviará un correo electrónico para restablecer la contraseña. Con OneSpan Sign, disponemos de una interfaz API para ello:

Petición HTTP

POST /api/account/senders/{roleID}/resetpassword

Encabezados HTTP

Aceptar: application/json

Autorización: Clave api básica

Nota:

Esta API es sólo para enviar un correo electrónico de restablecimiento a la dirección de correo electrónico del remitente. No cambiará tu contraseña directamente.

A diferencia de lo que ocurre en el Portal Web, puede enviar un correo electrónico de restablecimiento a cualquier cuenta. Con esta API, sólo puede enviar un correo electrónico de restablecimiento a los remitentes bajo el propietario de su cuenta y no a su cuenta principal o a los remitentes bajo otras cuentas.

Las plantillas de correo electrónico tanto para la invitación a la cuenta como para la solicitud de restablecimiento de contraseña pueden personalizarse si se pone en contacto con nuestro equipo de asistencia en [email protected].

Además de restablecer la contraseña desde el correo electrónico, también puede cambiar su contraseña en el panel de control de la interfaz web. La sección Contraseña de la página "Mi cuenta" le permite cambiar la contraseña de su cuenta indicando la contraseña actual.

Si tiene alguna pregunta sobre este blog o cualquier otra cosa relacionada con la integración de OneSpan Sign en su aplicación, visite los foros de la comunidad de desarrolladores. Su opinión nos importa