Portuguese English Spanish
Portuguese English Spanish

Criar uma aplicação no Microsoft Entra ID

Para habilitar a digitalização de documentos para o OneDrive pelo NDD Print Portal 360, cada empresa precisa ter um registro de aplicativo no tenant do Microsoft Entra ID correspondente.

O registro deve ser criado por um administrador do Microsoft Entra ID da empresa ou por alguém que tenha as permissões necessárias no tenant.

1. Registrar o aplicativo

  1. Acesse o portal do Azure

  2. Acesse Microsoft Entra ID > App registrations > New registration

{7163A2FA-4C72-4657-994D-72EF7BA43134}-20261021-185844.png
  1. No campo Name, informe um nome que ajude a identificar o aplicativo.

  2. Em Supported account types, selecione a opção para contas somente deste diretório organizacional (single tenant).

  3. Em Redirect URL, selecione a plataforma Web e informe a URL de callback válida para o ambiente.

  4. Clique em Register.

URL de redirecionamento

O caminho de callback é o mesmo para todos os ambientes:

/api/v1/cloud-scan/oauth/callback

A URL completa varia conforme o ambiente:

  • NDD Print 360 Portal Server (local):

    • Informe https://{host-publico}:{porta}/api/v1/cloud-scan/oauth/callback. Substitua {host-publico} pelo host público do ambiente e {porta} pela porta configurada para a API ITS. A porta sugerida é 4443, mas pode ser personalizada durante a instalação. Use a porta configurada no ambiente.

      • Exemplo: https://br-hmg-print01:4443/api/v1/cloud-scan/oauth/callback

  • NDD Print Portal 360 (nuvem/DC):

    • Use a URL fixa do DataCenter.

      • Para o DataCenter Europa, informe https://its-eu.nddprint.com/api/v1/cloud-scan/oauth/callback.

image-20261112-114028.png

2. Copiar os identificadores do aplicativo

Na página Overview do aplicativo, localize e copie os seguintes valores:

  • Application (client) ID: será informado no campo Client ID do NDD Print Portal 360.

  • Directory (tenant) ID: será informado no campo Tenant ID do NDD Print Portal 360.

Não utilizar o Object ID no lugar desses identificadores.

{99A01F61-EFCB-4C40-87FC-364D693F552C}-20261021-190254.png

3. Criar um Client Secret

  1. No menu do aplicativo, acesse Certificates & secrets

  2. Selecione New client secret

  3. Informe uma descrição e selecione o período de validade conforme a política da empresa.

  4. Clique em Add

{FA934A26-661A-4F91-935E-DC0AB9C352AD}-20261021-190340.png
  1. Copie o valor exibido na coluna Value e guarde-o em local seguro.

{0E7A5AB8-8525-4F3C-B36E-682634D9095C}-20261021-190356.png

No NDD Print Portal 360, informe o valor copiado no campo Client Secret.

Atenção: o segredo tem prazo de validade. Faça a renovação antes do vencimento e atualize o valor no NDD Print Portal 360. Se expirar, o teste de conexão poderá apresentar erro.

4. Conferir a URL de redirecionamento

  1. No menu do aplicativo, acesse Authentication (Preview) > Redirect URL configuration.

  2. Confirme se a plataforma está configurada como Web.

  3. Verifique se a URL cadastrada é exatamente igual à URL de callback válida para o ambiente, incluindo esquema, host, porta, caminho, uso de letras maiúsculas e minúsculas e barra final.

Para o NDD Print 360 Portal Server (local), confira se a porta corresponde à configurada no ambiente.

Para o NDD Print Portal 360 (nuvem/DC), use a URL fixa do DataCenter correspondente.

5. Configurar as permissões da API

  1. No menu, acesse API permissions.

  2. Selecione Add a permission > Microsoft Graph > Delegated permissions.

  3. Adicione as permissões abaixo:

openid

Autenticar o usuário e confirmar sua identidade.

profile

Solicitar informações básicas do perfil do usuário.

offline_access

Permite que o Portal 360 receba um token de atualização (refresh token) e renove a autenticação do usuário sem exigir um novo login. Esse recurso ajuda a manter a sessão e o cache de login ativos.

User.Read

Permite que o Portal leia as informações básicas do perfil do usuário autenticado para realizar o login via Microsoft e a autenticação necessária para a troca de PIN.

Files.ReadWrite

Ler e editar os arquivos que são de propriedade do usuário conectado.

  1. Selecione Grant admin consent para conceder o consentimento ao tenant, conforme a política da empresa.

{F4458F81-A7C5-490B-9FE6-CAFFF8EACE7A}-20261112-115216.png

6. Configurar o aplicativo no Portal 360

Configurações de Digitalização para nuvem

Last updated: