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

Duo Liang, 29 de Agosto de 2018
Thumbnail

En nuestro blog anterior, " Recuperar paquetes de remitente ", Discutimos los conceptos y las diferencias entre Dueños de cuenta y Miembros de la cuenta (remitentes) . Como propietario de una cuenta, agregar remitentes con diferentes correos electrónicos es muy útil, ya que les otorga la capacidad de enviar y manejar transacciones por separado. Aquí, veremos más de cerca cómo invitar / crear un remitente a su cuenta principal.

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

8-30-1

Nota:

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

{"messageKey": "error.validation.senderAlreadyMemberOfAnother", "mensaje": "El remitente ya es miembro de otra cuenta", "código": 400, "nombre": "Error de validación"}

Porque en un entorno de portal único, como Sandbox US V11, un correo electrónico solo puede convertirse en remitente en 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 o miembro de la cuenta.

Pero estará bien si está listo para comenzar la producción y crear remitentes con el mismo correo electrónico en el nuevo entorno. Según la restricción que mencionamos anteriormente, Sandbox y PROD son entornos diferentes, por lo que las cuentas son independientes entre sí.

"INVITADO" vs "ACTIVO"

En el ejemplo anterior, invitamos a un nuevo remitente a nuestra cuenta con el estado "INVITADO", que es un flujo de trabajo estándar para agregar un remitente. Mientras esté en OneSpan Sign, también puede omitir el correo electrónico de invitación y agregar 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.

INVITADO: El estado INVITADO es un estado pendiente, y OneSpan Sign enviará un correo electrónico a su correo electrónico invitado solicitando al remitente que complete cierta información básica del usuario, como nombre, apellido y contraseña. Después de enviar esta información, el estado del nuevo remitente cambiará a "ACTIVO".

Nota:

Los nombres y apellidos que OneSpan Sign originalmente tenía en el archivo serán sobrescritos por lo que el usuario ingrese realmente cuando sean invitados.

ACTIVO: en lugar de crear un remitente con el estado INVITADO, puede establecer directamente el estado del remitente en ACTIVO sin solicitar información del usuario y solicitarles que creen una contraseña. Hacerlo no limitará la funcionalidad de la cuenta, aún 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 remitente configurado inmediatamente como ACTIVO no tendrá una contraseña establecida. Esto evita que el remitente inicie sesión en el Portal web actualmente.

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

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

Para otra administración de remitentes, puede verificar Guía de remitentes .

Restablecimiento de contraseña

Cuando necesite restablecer su contraseña, puede hacer clic en "Olvidó su contraseña" en la página de inicio de sesión del portal web e ingresar un correo electrónico de cuenta. En respuesta, se enviará un correo electrónico de restablecimiento de contraseña. Con OneSpan Sign, tenemos una interfaz API para esto:

Solicitud HTTP

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

Encabezados HTTP

Aceptar: aplicación / json

Autorización: Basic api_key

Nota:

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

A diferencia del portal web, puede enviar un correo electrónico de restablecimiento a cualquier cuenta. Con esta API, solo puede enviar un correo electrónico de restablecimiento a los remitentes bajo el propietario de su cuenta y no a su cuenta principal o remitentes bajo otras cuentas.

Las plantillas de correo electrónico para ambos Invitación de cuenta y Solicitud de descanso de contraseña se puede personalizar si contacta con nuestro equipo de soporte en sign.support @onespan .com.

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

8-30-2

Si tiene alguna pregunta sobre este blog o cualquier otra cosa relacionada con la integración de OneSpan Sign en su aplicación, visite el Foros de la comunidad de desarrolladores . ¡Sus comentarios nos importan!