Cadastro E-mail Office365

Voltar para à Página principal > Cadastro E-mail 365

---

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.

	Execute os seguintes passos para a criação do Registro de aplicativo: Acesse o Microsoft Azure na seguinte URL: https://portal.azure.com/#home Dentre as opções de Serviço Azure exibidas, selecione a opção: "Azure Active Directory".
	Acesse a opção: “Registros de aplicativo”.
	Acesse a aba: “Novo registro”.
	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.

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.

	Em seguida, acesse a aba “Visão geral” do aplicativo, dentro a opção “Credenciais de cliente”, clique em “Adicionar um certificado ou segredo”.
	Clique na opção “Novo segredo do cliente”.
	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”
	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.

	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”.
	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

	Ao retornar à página inicial “Visão geral” do aplicativo, acesse a opção lateral esquerda e clique em “Permissões de APIs”.
	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.

	Acesse a aba APIs da Microsoft e clique na opção: “Microsoft Graph”.
	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”.
	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”.
	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”.
	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.

	Ao acessar o Gerenciador NFS-e, acesse a opção: “Configuração”.
	Acesse a opção: “Parâmetros”
	Clique na aba “Parâmetros das empresas”. Selecione a empresa específica. Em seguida, clique na seta que aponta para a direita.
	Selecione a aba “E-mail OAuth2.0” e preencha os campos com as informações previamente salvas, conforme abaixo. ID do Cliente; Informação gerada na sessão Pontos de Extremidade Segredo do Cliente; Informação gerada na sessão Inclusão do Segredo Porta do Localhost; Informação gerada na sessão Configurando o envio de E-mail Endpoint do Token; Informação gerada na sessão Pontos de Extremidade Endpoint de Autorização; Informação gerada na sessão Pontos de Extremidade Atenção: Clique nos hiperlink acima para ser direcionado para a sessão explicativa correspondente.
	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.

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”.

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.

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).

	Clique em “Configurações”. Em seguida, clique em “Parâmetros”.
	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 > Cadastro E-mail 365