Desenvolvedor OneSpan Sign: convite de conta e redefinição de senha

Duo Liang, 29 de Agosto de 2018
Thumbnail

No nosso blog anterior, " Recuperar pacotes de remetentes ", Discutimos os conceitos ao redor e as diferenças entre Proprietários da conta e Membros da conta (remetentes) . Como proprietário da conta, adicionar remetentes com e-mails diferentes é muito útil, pois permite que eles enviem e manipulem transações separadamente. Aqui, veremos mais de perto como convidar / criar um remetente para sua conta principal.

A figura a seguir mostra como convidar um remetente usando um método REST ou SDK:

8-30-1

Nota:

A mensagem de erro mais comum que você pode encontrar é: 

{"messageKey": "error.validation.senderAlreadyMemberOfAnother", "message": "O remetente já é membro de outra conta.", "code": 400, "name": "Erro de validação"}

Como em um único ambiente de portal, como o Sandbox US V11, um email só pode se tornar remetente em uma conta principal. Portanto, esse erro ocorre porque você está convidando uma conta de email que já se tornou proprietário ou membro da conta.

Mas tudo bem se você estiver pronto para iniciar a produção e criar remetentes com o mesmo email no novo ambiente. De acordo com a restrição mencionada acima, o Sandbox e o PROD são ambientes diferentes, portanto as contas são independentes entre si.

"CONVIDADO" vs "ATIVO"

No exemplo acima, convidamos um novo remetente para nossa conta com o status de "CONVIDADO", que é um fluxo de trabalho padrão para adicionar um remetente. Enquanto estiver no OneSpan Sign, você também pode pular o email de convite e adicionar um remetente diretamente com o status "ATIVO" quando não precisar que seus remetentes definam sua senha e perfil básico. Vamos explicar esses dois conceitos separadamente.

CONVIDADO: O status CONVIDADO é um status pendente, e o OneSpan Sign enviará um email ao seu email convidado solicitando que o remetente preencha algumas informações básicas do usuário, como nome, sobrenome e senha. Após o envio dessas informações, o status do novo remetente será alterado para "ATIVO".

Nota:

O nome e o sobrenome que o OneSpan Sign originalmente possuía no arquivo serão substituídos pelo que o usuário realmente inserir quando for convidado.

ATIVO: em vez de criar um remetente com o status CONVIDADO, você pode definir diretamente o status do remetente como ATIVO sem solicitar informações do usuário e solicitar que ele crie uma senha. Isso não limitará a funcionalidade da conta. Você ainda pode recuperar a chave de API do remetente e chamar APIs para o remetente. A principal diferença entre essas duas abordagens é que um remetente definido imediatamente para ATIVO não terá uma senha definida. Isso impede que o remetente faça logon no Portal da Web atualmente.

Para enviar o email de convite manualmente, você pode chamar a seguinte API:

POST / api / conta / remetentes / {roleID} / invite

Para outro gerenciamento de remetentes, você pode verificar Guia de Remetentes .

Redefinição de senha

Quando você precisar redefinir sua senha, poderá clicar em "Esqueceu sua senha" na página de Login do Portal da Web e inserir um e-mail da conta. Em resposta, um email de redefinição de senha será enviado. Com o OneSpan Sign, temos uma interface de API para isso:

Solicitação HTTP

POST / api / conta / remetentes / {roleID} / resetpassword

Cabeçalhos HTTP

Accept: application / json

Autorização: básica api_key

Nota:

Essa API é apenas para enviar um email de redefinição para o endereço de email do remetente. Não mudará sua senha diretamente.

Ao contrário do Portal da Web, você pode enviar um email de redefinição para qualquer conta. Com esta API, você só pode enviar um e-mail de redefinição para remetentes sob o proprietário da sua conta e não para sua conta principal ou remetentes sob outras contas.

Os modelos de email para ambos Convite da conta e Solicitação de Restituição de Senha pode ser personalizado se você entrar em contato com nossa equipe de suporte em sign.support @onespan .com.

Além de redefinir a senha do E-mail, você também pode alterar sua senha no painel da interface da Web. A seção Senha da página "Minha conta" permite alterar a senha da sua conta, fornecendo a senha atual.

8-30-2

Se você tiver alguma dúvida sobre este blog ou qualquer outra coisa relacionada à integração do OneSpan Sign ao seu aplicativo, visite o Fóruns da comunidade de desenvolvedores . Seu feedback é importante para nós!