Registrar la integración en Microsoft Entra ID

Nota: Este artículo se aplica a la integración de acciones de datos de Microsoft Dynamics 365.

Antes de añadir la integración de acciones de datos de Microsoft Dynamics 365, debe crear una aplicación en el centro de administración de Microsoft Entra. Registro de la aplicación:

  • Concede permisos para que la aplicación funcione.
  • Genera un ID de aplicación que se requiere para las credenciales cuando se añade la integración de acciones de datos de Microsoft Dynamics 365.

Registrar una aplicación en Microsoft Entra ID

Para registrar una aplicación en su tenant Microsoft Entra:

  1. Inicie sesión en el centro de administración de Microsoft Entra.
  2. Vaya a Entra ID > App registrations.
  3. Haga clic en Nuevo registro.
  4. Ingrese la siguiente informacion:
    • Nombre: El nombre de la aplicación, por ejemplo, integración de acciones de datos de Microsoft Dynamics 365.
    • Tipos de cuenta admitidos: Seleccione Cuentas sólo en este directorio de organización opción para un único inquilino.
      Nota: El campo Redirect URL no es utilizado por la integración de acciones de datos de Microsoft Dynamics 365 y no debe establecerse.
  5. Hacer clic Registrarse.

    La aplicación aparece en la lista de aplicaciones registradas.

Configurar la autenticación de la aplicación

Puede crear un secreto de cliente o cargar un certificado de confianza emitido por una autoridad de certificación.

Crear un secreto de cliente

  1. En App registrations, seleccione su aplicación.
  2. Seleccione Certificados y secretos > Secretos de cliente y haga clic en Nuevo secreto de cliente.
  3. Añade una descripción para el cliente.
  4. Introduzca una duración para la expiración del secreto de cliente. Elija la duración que se ajuste a la política de seguridad de su organización.
  5. Hacer clic Agregar.
  6. Anote el secreto de cliente Valor para utilizarlo en el código de su aplicación cliente.
    Nota: Este valor secreto no se vuelve a mostrar después de salir de esta página.

Cargar un certificado de confianza

Utilice o genere un certificado de confianza como se describe en la documentación de Microsoft y asegúrese de que la clave privada es accesible para la configuración de credenciales de integración en Genesys Cloud.

  1. En App registrations, seleccione su aplicación.
  2. Seleccione Certificados y secretos > Secretos de cliente.
  3. Hacer clic Subir certificado.
  4. Seleccione el archivo de certificado que desea cargar.
  5. Hacer clic Agregar.

Al cargar el certificado, se muestran la huella digital, la fecha de inicio y los valores de caducidad del certificado. Para obtener más información sobre el uso de un certificado de confianza, consulte Configurar la autenticación en la documentación de Microsoft Entra. 

Advertencia: Al utilizar un secreto de cliente o un certificado para integrar Microsoft Dynamics 365 con Genesys Cloud, es importante comprender que los secretos de cliente y los certificados caducan en función de la duración establecida durante la creación. Para evitar interrupciones, asegúrese de generar un nuevo secreto de cliente o cargar un nuevo certificado, y actualice las credenciales de integración antes de que caduquen.

Anote los siguientes detalles cuando registre la aplicación con uno de los tipos de credenciales:

  • Para el secreto cliente
    • Identificación de la solicitud
    • Secreto de cliente
  • Para el certificado
    • Identificación de la solicitud
    • Huella digital del certificado
    • Clave privada del certificado

Crear un usuario de aplicación

Cree un usuario de aplicación en Microsoft Dynamics 365 que represente una aplicación externa. Se utiliza para permitir el acceso seguro y no interactivo a la API por parte de las aplicaciones Azure registradas para integraciones.

Para crear un usuario de aplicación:

  1. Inicie sesión en el Centro de administración de la plataforma de energía.
  2. Seleccione Entornos en el panel de navegación y seleccione un entorno de la lista.
  3. Seleccione Ajustes.
  4. Seleccione Usuarios + permisos y, a continuación, Usuarios de aplicaciones.
  5. Para abrir la página Crear un nuevo usuario de aplicación, seleccione + Nuevo usuario de aplicación.
  6. Seleccione + Añadir una aplicación, elija la aplicación Microsoft Entra registrada que se creó para el usuario de la aplicación y, a continuación, seleccione Añadir.
  7. En Business Unit, seleccione una unidad de la lista.
  8. En Funciones de seguridad, seleccione las funciones que desea añadir al nuevo usuario de la aplicación.
  9. Haga clic en Guardar y, a continuación, en Crear.

El usuario de la aplicación creada se activa automáticamente por defecto. Un usuario de aplicación activa tiene acceso a los datos de su entorno en nombre del usuario que accede a la aplicación registrada.

Para más información, consulte los siguientes artículos de la documentación de Microsoft Entra:

    Próximo, agregar la integración.

    Para obtener más información sobre la integración, consulte Acerca de la integración de acciones de datos de Microsoft Dynamics 365.