Portuguese English Spanish
Portuguese English Spanish

Crear una aplicación en Microsoft Entra ID

Para habilitar la digitalización de documentos en OneDrive a través de NDD Print Portal 360, cada empresa debe tener un registro de aplicación en el tenant correspondiente de Microsoft Entra ID.

El registro debe crearlo un administrador de Microsoft Entra ID de la empresa o alguien que cuente con los permisos necesarios en el tenant.

1. Registrar la aplicación

  1. Accede al portal de Azure

  2. Accede a Microsoft Entra ID > App registrations > New registration

{7163A2FA-4C72-4657-994D-72EF7BA43134}-20261021-185844.png
  1. En el campo Name, introduce un nombre que ayude a identificar la aplicación.

  2. En Supported account types, selecciona la opción para cuentas únicamente de este directorio organizativo (single tenant).

  3. En Redirect URL, selecciona la plataforma Web e introduce la URL de callback válida para el entorno.

  4. Haz clic en Register.

URL de redireccionamiento

La ruta de callback es la misma para todos los entornos:

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

La URL completa varía según el entorno:

  • NDD Print 360 Portal Server (local):

    • Introduce https://{host-publico}:{puerto}/api/v1/cloud-scan/oauth/callback. Sustituye {host-publico} por el host público del ambiente y {puerto} por el puerto configurado para la API ITS. El puerto recomendado es 4443, pero se puede personalizar durante la instalación. Utiliza el puerto configurado en el entorno.

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

  • NDD Print Portal 360 (nube/DC):

    • Utiliza la URL fija del DataCenter.

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

image-20261112-114028.png

2. Copiar los identificadores de la aplicación

En la página Overview de la aplicación, busca y copia los siguientes valores:

  • Application (client) ID: se introducirá en el campo Client ID de NDD Print Portal 360.

  • Directory (tenant) ID: se introducirá en el campo Tenant ID de NDD Print Portal 360.

No utilices el Object ID en lugar de estos identificadores.

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

3. Crear un Client Secret

  1. En el menú de la aplicación, accede a Certificates & secrets

  2. Selecciona New client secret

  3. Introduce una descripción y selecciona el periodo de validez según la política de la empresa.

  4. Haz clic en Add

{FA934A26-661A-4F91-935E-DC0AB9C352AD}-20261021-190340.png
  1. Copia el valor que aparece en la columna Value y guárdalo en un lugar seguro.

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

En el NDD Print Portal 360, introduce el valor copiado en el campo Client Secret.

Atención: la clave tiene una fecha de caducidad. Renuévala antes de que caduque y actualiza el importe en el NDD Print Portal 360. Si caduca, la prueba de conexión podría dar error.

4. Comprobar la URL de redireccionamiento

  1. En el menú de la aplicación, accede a Authentication (Preview) > Redirect URL configuration.

  2. Comprueba que la plataforma esté configurada como Web.

  3. Comprueba que la URL registrada sea exactamente igual a la URL de callback válida para el entorno, incluyendo el esquema, el host, el puerto, la ruta, las mayúsculas y minúsculas, y la barra final.

Para el NDD Print 360 Portal Server (local), comprueba que el puerto coincida con el configurado en el entorno.

Para el NDD Print Portal 360 (nube/DC), utiliza la URL fija del DataCenter correspondiente.

5. Configurar los permisos de la API

  1. En el menú, accede a API permissions.

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

  3. Añade los siguientes permisos:

openid

Autenticar al usuario y confirmar su identidad.

profile

Solicitar información básica del perfil del usuario.

offline_access

Permite que el NDD Print Portal 360 reciba un token de actualización (refresh token) y renueve la autenticación del usuario sin necesidad de volver a iniciar sesión. Esta función ayuda a mantener activas la sesión y la caché de inicio de sesión.

User.Read

Permite que el NDD Print Portal 360 lea la información básica del perfil del usuario autenticado para realizar el inicio de sesión a través de Microsoft y la autenticación necesaria para el cambio de PIN.

Files.ReadWrite

Leer y editar los archivos que son propiedad del usuario conectado.

  1. Selecciona Grant admin consent para otorgar el consentimiento al tenant, de acuerdo con la política de la empresa.

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

6. Configurar la aplicación en el Portal 360

Configuración de digitalización para la nube

Last updated: