Roteiro para configuração do OAuth2 – Microsoft

De acordo com o comunicado emitido pela Microsoft, a partir de 01/10/2022 os acessos às contas de e-mail Microsoft realizados no formato usuário/senha pelos aplicativos poderão ser desativados. De acordo com o informativo, estes aplicativos deverão utilizar a tecnologia OAuth2 para realizar a conexão.

O roteiro abaixo tem por objetivo fornecer aos clientes o passo-a-passo de como configurar esse novo modo de autenticação da Microsoft no eDocs.

O que deve ser feito?

Abaixo, segue o passo-a-passo para realizar o processo de atualização dos protocolos:

• Atualize o eDocs para a versão 5.8.13.61 ou superior. É necessário que este procedimento seja feito usando o mesmo usuário configurado no serviço do eDocs
• Ao final do processo de atualização, automaticamente será aberta a tela do Configurador do eDocs. Caso o eDocs já esteja na versão correta, ou seja, 5.8.13.61 ou superior, o Configurador poderá ser aberto a partir da pasta de instalação do eDocs acessando Configurador > Senior.SapiensNfe.Configurador.exe
• Na tela inicial do Configurador, vá para a guia E-mail. Insira o endereço de e-mail que será usado no eDocs para envio/recebimento no campo Conta e-mail e clique no botão Autorizar Outlook
  
  
• Esta etapa permite que o eDocs se conecte com a conta da Microsoft. Para saber quais contas de e-mail estão configuradas no eDocs, acesse as telas de Configurações Gerais, de Empresas e Filiais
• Caso seja utilizada mais de uma conta Microsoft no eDocs, este processo deve ser repetido para cada conta
• Ao registrar uma nova conta de e-mail da Microsoft, será feito o redirecionamento para a página de autenticação da Microsoft, conforme a imagem abaixo:
  
  
  
• Caso sua conta de e-mail não seja apresentada nesta tela, clique na opção Use outra conta para logar na conta desejada e nas telas seguintes insira o endereço de e-mail e a senha, respectivamente
  
  
  
  
• Após isso, será apresentada uma tela pedindo a confirmação de acesso à conta e o usuário deverá confirmar clicando na opção Sim
  
  
• Após confirmar o acesso à conta Microsoft, uma mensagem de confirmação será exibida no configurador do eDocs, sinalizando o sucesso da operação
  
  
  
• Eventualmente a Microsoft poderá exibir um alerta informando que o app eDocs ainda não foi verificado devido ao fato de estar em processo de homologação. Quando isso ocorrer será apresentada uma tela pedindo a confirmação de acesso à conta e o usuário deverá confirmar
• Com as contas de e-mail devidamente registradas na Microsoft, o modo de autenticação deverá ser atualizado nos cadastros do eDocs que estejam usando contas Microsoft. Deve-se revisar as parametrizações de Empresa, Filial e Geral, tanto para envio quanto para recebimento de e-mail, conforme demonstrado abaixo:
  
  
  
  
  

• Importante

  O eDocs permite a comunicação tanto com o servidor POP quanto com o IMAP. Porém, ao selecionar o Tipo de comunicação desejada, é necessário garantir que o e-mail esteja parametrizado para utilizar a forma de comunicação configurada, caso contrário, mesmo se o teste de conexão retornar com sucesso no eDocs, os e-mails não serão integrados pela rotina de recebimento. Estas configurações devem ser verificados internamente com o responsável pela administração do Servidor de e-mail da empresa.

  

• Por fim, deve-se testar a conexão e, em caso de sucesso, clicar no botão Salvar
  • Caso as parametrizações tenham sido feitas corretamente, o teste retornará com sucesso e bastará salvar as configurações para efetivar o procedimento
  • Caso algum passo que envolve o registro da conta na Microsoft não tenha sido executado, uma mensagem de erro com as orientações será exibida. Nesse caso, sugerimos a revisão das etapas anteriores

  Nota

  • A partir da execução desse procedimento para autenticação Microsoft, torna-se necessário que o serviço do eDocs seja inicializado para que a rotina de envio/recebimento de e-mails funcione corretamente
  • Esse procedimento só precisa ser executado no servidor onde o serviço do eDocs está sendo executado
  • O token de validação do OAuth2 pode apresentar um prazo de validade de acordo com o servidor do e-mail