English
Español
Roteiro para configuração do Microsoft Entra ID (Graph API)
O tipo de conta Microsoft Graph API do eDocs utiliza o fluxo OAuth2 Client Credentials do Microsoft Entra ID, que permite ao serviço acessar a caixa de e-mail sem necessidade de login interativo.
O roteiro abaixo orienta o administrador no registro da aplicação no portal Microsoft e na configuração no eDocs.
Nota
Diferente do fluxo OAuth2 (Microsoft) já existente (que usa autenticação delegada com janela de login do usuário), o fluxo Client Credentials não abre navegador nem exige interação.
O que você pode fazer:
O administrador do tenant Microsoft deve executar os passos abaixo antes de configurar a conta no eDocs.
Criar a aplicação (App Registration) no Microsoft Entra ID
Criar aplicação no Microsoft Entra ID
- Acesse o portal Azure com uma conta de administrador do tenant.
- No menu de serviços, selecione Microsoft Entra ID.
- No menu lateral, selecione App registrations e clique em New registration.
- Informe um nome para a aplicação, por exemplo: eDocs - Recebimento NFe.
- Em Supported account types, selecione Accounts in this organizational directory only (single tenant).
- Deixe Redirect URI em branco (não é necessário para Client Credentials).
- Clique em Register.
Após o registro, a página Overview da aplicação exibirá os valores de Application (client) ID e Directory (tenant) ID. Esses valores serão utilizados nos campos Client ID e Tenant ID do eDocs.
Criar o Client Secret
Criar Client Secret
- Na aplicação registrada, selecione Certificates & secrets no menu lateral.
- Na aba Client secrets, clique em New client secret.
- Informe uma descrição (por exemplo, eDocs Secret) e selecione o prazo de validade.
- Clique em Add.
- Copie imediatamente o valor gerado na coluna Value. Este valor não poderá ser recuperado depois de sair da página.
Este valor será utilizado no campo Client Secret do eDocs.
Importante
Client Secrets têm prazo de validade. Agende a renovação antes do vencimento para evitar interrupção no recebimento de e-mails.
Conceder a permissão Mail.ReadWrite
Conceder permissão Mail.ReadWrite
- Na aplicação registrada, selecione API permissions no menu lateral.
- Clique em Add a permission, selecione Microsoft Graph e, em seguida, Application permissions.
- Procure por Mail.ReadWrite, marque a permissão e clique em Add permissions.
- De volta à tela de permissões, clique em Grant admin consent for [seu tenant] e confirme.
O status da permissão Mail.ReadWrite deve ficar como Granted for [seu tenant].
Importante
A permissão deve ser do tipo Application (não Delegated). O fluxo Client Credentials não opera em nome de um usuário específico e depende de permissões de aplicação concedidas pelo administrador do tenant.
Configurar a conta no eDocs
Configurar conta no eDocs
- No eDocs, acesse Configurações > Empresas > Recebimento > E-mail e clique em Novo (ou edite uma conta existente).
- No campo Tipo, selecione Microsoft Graph API. Os campos específicos de POP/IMAP ficam ocultos e os campos OAuth2 são exibidos.
- No campo Usuário, informe o endereço da Shared Mailbox (exemplo: nfe@empresa.com.br).
- No campo Tenant ID, cole o valor Directory (tenant) ID copiado na etapa da criação da aplicação.
- No campo Client ID, cole o valor Application (client) ID copiado na etapa da criação da aplicação.
- No campo Client Secret, cole o valor copiado na etapa de concessão da permissão.
- Clique em Testar conexão e verifique se a mensagem "Teste realizado com sucesso" é exibida.
- Clique em Salvar.
English
Español
