Cadastro E-mail Office365

De Wiki NBS
Ir para navegação Ir para pesquisar

Seta-topo.png

Voltar para à Página principal > Diversos > Específicos > Cadastro E-mail Office365

Apresentação

Neste manual será exemplificado o passo a passo para a obtenção das credenciais de autenticação OAUTH2.0 no portal Microsoft Azure (E-mail Office365)

A NBS está em constante aprimoramento dos seus processos de negócio, objetivando a melhoria dos serviços e a satisfação dos clientes

Configurando o envio de E-mail

Para utilizar a autenticação “oauth2.0” no envio de e-mail, via SMTP, é necessário termos em mãos as seguintes credenciais:

  • ID do cliente;
  • Segredo do cliente;
  • Porta do Localhost;
  • Endpoint do token;
  • Endpoint de autorização;

Essas credenciais são obtidas dentro do portal Microsoft Azure, local da criação do “Registro de aplicativo”, conforme será exemplificado abaixo.

Cadastro email 365 - Portal Microsoft Azure.png Execute os seguintes passos para a criação do Registro de aplicativo:
  1. Acesse o Microsoft Azure na seguinte URL: https://portal.azure.com/#home
  2. Dentre as opções de Serviço Azure exibidas, selecione a opção: "Azure Active Directory".
Cadastro Email 365 - Portal Microsoft Azure - Registro de Aplicativos.png Acesse a opção: “Registros de aplicativo”.
Cadastro Email 365 - Portal Microsoft Azure - Registro de Aplicativos - Novo Aplicativo.png Acesse a aba: “Novo registro”.
Cadastro Email 365 - Portal Microsoft Azure - Registro de Aplicativos - Novo Aplicativo - Registrar Aplicativo.png Ao acessar a página de registro, preencha os seguintes campos:
  • Nome;
    • Informe um nome para identificar o usuário;
  • Tipos de conta com suporte;
    • Selecione a opção: “Contas somente neste diretório organizacional”;
  • URI de redirecionamento;
    • Selecione a opção: “Web” e informe a URL: http://localhost:3017/, com o número de porta opcional, que não seja utilizado pelo servidor.

Importante: Para este exemplo, utilizamos a porta com o valor 3017. Guarde esse número da porta, pois será necessário inserir esse dado no gerenciador de NFS-e e NF-e.

  • Clique no botão: “Registrar”.

Inclusão do Segredo

Nesta sessão será exemplificado como efetuar a inclusão de um novo segredo.

Botao Atencao2.png Atenção:
  • Será necessário que o usuário copie algumas informações para a padronização da NF-e / NFS-e, sugerimos que utilize algum aplciativo de texto (Bloco de Notas, WorldPad, Notepad++, World, etc.
Cadastro Email 365 - Portal Microsoft Azure - Registro de Aplicativos - Novo Aplicativo - Registro do Aplicativo - Nome Identificador1.png Em seguida, acesse a aba “Visão geral” do aplicativo, dentro a opção “Credenciais de cliente”, clique em “Adicionar um certificado ou segredo”.
Cadastro Email 365 - Portal Microsoft Azure - Registro de Aplicativos - Novo Aplicativo - Registro do Aplicativo - Nome Identificador - Novo Segredo.png Clique na opção “Novo segredo do cliente”.
Cadastro Email 365 - Portal Microsoft Azure - Registro de Aplicativos - Novo Aplicativo - Registro do Aplicativo - Nome Identificador - Novo Segredo - Adiciona Segredo.png Execute os seguintes passos:
  • Informe uma Descrição para o segredo;
  • Selecione o período de Duração do segredo.
  • Ao final, clique no botão abaixo “Adicionar”
Cadastro Email 365 - Portal Microsoft Azure - Registro de Aplicativos - Novo Aplicativo - Registro do Aplicativo - Nome Identificador - Novo Segredo - Adiciona Segredo - Segredo do cliente.png Importante:, Copie o Valor do segredo e guarde-o, pois ele aparecerá uma única vez. Será necessário inserir esse dado no gerenciador de NFS-e e NF-e.

Pontos de Extremidade

Retorne à página inicial do registro do aplicativo. Se necessário, atualize a página para que o registro apareça listado.

ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Vis%C3%A3o_Geral.png Ao clicar no aplicativo, o usuário terá acesso às credenciais do aplicativo (opção: “Visão geral”)
  • Copie o valor do campo “ID do aplicativo (cliente)” e guarde-o.
    • Será necessário inserir esse dado no gerenciador de NFS-e e NF-e.
  • Em seguida, clique na opção “Pontos de extremidade”.
ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Vis%C3%A3o_Geral_-_Pontos_de_Extremidade.png Efetue a cópia das informações dos seguintes campos:
  • Endpoint de autorização - “Ponto de extremidade de autorização Oauth 2.0 (v2)”.
  • Endpoint de token - “Ponto de extremidade do token Oauth 2.0 (v2)”.
    • Copie as URL’s, guarde-as, pois será necessário inserir esses dois dados no gerenciador de NFS-e e NF-e.
  • Ao finalizar, feche a aba.

Permissões de API's

ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Permiss%C3%B5es_de_APIs.png Ao retornar à página inicial “Visão geral” do aplicativo, acesse a opção lateral esquerda e clique em “Permissões de APIs”.
ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Permiss%C3%B5es_de_APIs_-_Adicionar_Permiss%C3%A3o.png Clique na aba “Adicionar uma permissão”.

Solicitar permissões de API

Nesta sessão o usuário irá efetuar a inclusão de permissões para o uso do API.

ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Permiss%C3%B5es_de_APIs_-_Adicionar_Permiss%C3%A3o_-_Microsoft_Graph.png Acesse a aba APIs da Microsoft e clique na opção: “Microsoft Graph”.
ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Permiss%C3%B5es_de_APIs_-_Adicionar_Permiss%C3%A3o_-_Microsoft_Graph_-_Permiss%C3%B5es_delegadas.png Selecionea opção: “Permissões delegadas” e selecione as seguintes permissões:
  • email,
  • IMAP.AccessAsUser.All,
  • offline_access,
  • openid,
  • SMTP.Send,
  • User.Read.

Ao finalizar, clique no botão: “Adicionar permissões”.

ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Permiss%C3%B5es_de_APIs_-_Solicitar_Permissoes_de_API.png Acesse novamente a opção: “Adicionar uma permissão”.
  • Selecione a aba:
    • “APIs que a minha organização usa”
  • Selecione o campo:
    • “Office 365 Exchange Online”.
ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Permiss%C3%B5es_de_APIs_-_Solicitar_Permissoes_de_API_-_Permiss%C3%B5es_de_aplicativo.png
  • Selecione a opção:
    • “Permissões de aplicativo”
  • Localize o campo:
    • “SMTP”
  • Selecione a permissão:
    • “SMTP.SendAsApp”
  • Ao finalizar, clique no botão
    • “Adicionar permissões”.
ligação=Arquivo:Cadastro_Email_365_-_Portal_Microsoft_Azure_-_Permiss%C3%B5es_de_APIs_-_Solicitar_Permissoes_de_API_-_Permiss%C3%B5es_de_aplicativo_-_Permiss%C3%B5es_Configuradas.png Ao finalizar, as permissões deve ser visualizadas como na imagem ao lado.
  • Acesse a opção: “Conceder consentimento do administrador”
  • Clique em “Sim” para confirmar a ação.

Atenção: Caso essa opção não esteja habilitada, será necessário que o e-mail administrador libere a permissão para esse e-mail específico. Feita a liberação por meio do e-mail administrador, saia da conta e entre novamente.

  • Ao efetuar o procedimento, a opção “Conceder consentimento do administrador” estará habilitada para executar a ação acima

Configuração do parâmetro SMTP_AUTH através do e-mail Administrador

Nesta sessão o usuário fará a parametrização do consentimento do Administrador, ou seja, a configuração no e-mail do administrador, ao executar os passos abaixo (quando necessário).

O objetivo é que, ao final, o parâmetro “SMTP_AUTH” esteja selecionado para essa conta de e-mail especificada.

  • Link de acesso: https://admin.microsoft.com/#/homepage
  • Na aba lateral esquerda, clique em “Mostrar tudo”.
  • Selecione “Usuários”.
  • Selecione “Usuários ativos”.
  • Busque e Selecione o e-mail utilizado para o envio de Notas Fiscais.
  • Com o e-mail selecionado, clique na aba “E-mail”.
  • Na seção “E-mail Aplicativos”, escolha a opção “Gerenciar Aplicativos de E-mail”.
  • Marque o parâmetro “SMTP_AUTH”.
  • Salve a nova configuração.

O procedimento descrito acima está no gif  ao final do artigo abaixo, na seção “IMAP and SMTP permissions”.

Link de acesso:

https://docs.emailengine.app/setting-up-oauth2-with-outlook/#:~:text=Navigate%20to%20Configuration%2D%3EOAuth2.,the%20type%20of%20the%20app.&text=Use%20the%20Application%20Id%20and,used%20when%20registering%20the%20application

Ao final deste processo, você terá obtido cinco dados:

  • ID do cliente
  • Segredo do cliente
  • Porta do Localhost
  • Endpoint do token
  • Endpoint de autorização.

Esses dados deverão ser inseridos na aba “E-mail Oauth2.0”, tanto na NFS-e e NF-e.

Configurando a NFS-e

Gerenciador de NFS-e

Nesta sessão o usuário fará a parametrização do Gerenciador da NFS-e.

ligação=Arquivo:Cadastro_Email_365_-_NFSe_Service_-_Configura%C3%A7%C3%A3o.png Ao acessar o Gerenciador NFS-e, acesse a opção: “Configuração”.
ligação=Arquivo:Cadastro_Email_365_-_NFSe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros.png Acesse a opção: “Parâmetros”
ligação=Arquivo:Cadastro_Email_365_-_NFSe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros_-_Par%C3%A2metros_das_Empresas.png
  • Clique na aba “Parâmetros das empresas”.
  • Selecione a empresa específica.
  • Em seguida, clique na seta que aponta para a direita.
ligação=Arquivo:Cadastro_Email_365_-_NFSe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros_-_Par%C3%A2metros_das_Empresas_-_Aba_Email_OAuth2.01.png Importante: A configuração abaixo irá permitir que seja feita a autenticação Oauth 2.0 - Multifator.

Selecione a aba “E-mail OAuth2.0” e preencha os campos com as informações previamente salvas, conforme abaixo.

Atenção: Clique nos hiperlink acima para ser direcionado para a sessão explicativa correspondente.

ligação=Arquivo:Cadastro_Email_365_-_NFSe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros_-_Par%C3%A2metros_das_Empresas_-_Aba_Email_OAuth2.0_-_Tela_Informativa.png Para salvar as informações inseridas, clique no botão “Salvar”.

O sistema exibirá a Tela Informativa ao lado ao término do processo.

E-mail Automático

Nesta sessão o usuário fará a parametrização do e-mail automático.

ligação=Arquivo:Cadastro_Email_365_-_NFSe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros_-_Par%C3%A2metros_das_Empresas_-_Aba_Email_Autom%C3%A1tico.png Acesse a aba “E-mail automático” e preencha os campos abaixo.
  • Marque a caixa de seleção “Email automático”;
  • O campo “Servidor Email” deve ser preenchido com “smtp.office365.com”;
  • O campo “Porta” deve ser preenchido com “587”;
  • Os campos “Usuário Email” e “Login” devem ser preenchidos com o e-mail do remetente;
  • Marque a caixa de seleção “Requer SSL”
  • Preencha o campo “Senha Email”;
  • Insira a mensagem do corpo do e-mail em “Msg Email”.
ligação=Arquivo:Cadastro_Email_365_-_NFSe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros_-_Par%C3%A2metros_das_Empresas_-_Aba_Email_Autom%C3%A1tico_-_Tela_Informativa.png Para salvar as informações inseridas, clique no botão “Salvar”.

O sistema exibirá a Tela Informativa ao lado ao término do processo.

Aba Serviço E-mail/Arquivo

Nesta sessão o usuário fará a parametrização do envio de nota.

ligação=Arquivo:Cadastro_Email_365_-_NFSe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros_-_Par%C3%A2metros_das_Empresas_-_Aba_Servi%C3%A7o_Email-Arquivo.png Na aba “Serviço E-mail/Arquivo”, o usuário fará a seleção da opção de envio da nota (XML, PDF, ou ambos).

Para salvar as alterações, clique no botão Salvar.

Configurando a NF-e

Gerenciador de NF-e

Nesta sessão o usuário fará a parametrização do Gerenciador da NF-e (inclusão de dados), para que seja possível efetuar a autenticação Oauth 2.0 - Multifator.

ligação=Arquivo:Cadastro_Email_365_-_NFe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros.png Clique em “Configurações”. Em seguida, clique em “Parâmetros”.
ligação=Arquivo:Cadastro_Email_365_-_NFe_-_Configura%C3%A7%C3%A3o_-_Par%C3%A2metros_-_Aba_Email_OAuth_2.0_-_Bot%C3%A3o_Salvar.png Dentro da tela da configuração dos parâmetros, clique na seta para a direita e, selecione a aba “E-mail OAuth2.0” e preencha os campos:
  • ID do Cliente;
  • Segredo do Cliente;
  • Porta do Localhost;
  • Endpoint do Token;
  • Endpoint de Autorização.

Ao finalizar o processo, clique no botão: “Salvar”.

Voltar para à Página principal > Diversos > Específicos > Cadastro E-mail Office365

Disponível em “https://ajuda.nbsi.com.br:84/index.php?title=Cadastro_E-mail_Office365&oldid=40010”