Configura una fuente de Microsoft Dataverse para CDC

Datastream te permite transmitir datos modificados desde un entorno de Microsoft Dataverse a un destino compatible, como BigQuery o Cloud Storage. Para preparar tu fuente, registra un cliente de OAuth 2.0 en Microsoft Entra ID, configura un usuario de la aplicación Dataverse y permite las direcciones IP públicas de Datastream si es necesario.

Antes de comenzar

Antes de comenzar a configurar Dataverse para usarlo con Datastream, debes hacer lo siguiente:

  • Tener acceso a una suscripción activa de Microsoft Azure con permisos para administrar Azure Active Directory (AAD) y Dataverse
  • Tener un entorno de Dataverse activo
  • Tener conocimientos para navegar y cambiar la configuración en Microsoft Azure Portal, Dataverse y Dynamics 365
  • Tener permisos para registrar aplicaciones en AAD y crear o asignar roles en Dataverse

Configura un entorno de Microsoft Dataverse para usarlo con Datastream

Para establecer una conexión entre tu entorno de Dataverse y Datastream, debes autenticarte con el flujo de credenciales de cliente de OAuth 2.0. Para ello, debes registrar una aplicación en AAD y configurar un usuario de la aplicación en Dataverse.

Registra una aplicación en Azure Active Directory

Dataverse usa AAD para la autenticación. Para registrar una aplicación, sigue estos pasos:

  1. Accede a Azure Portal con una cuenta de administrador.
  2. En el portal, ve a Azure Active Directory > Registros de apps > Nuevo registro.

  3. Registra la aplicación:

    1. En Nombre de la aplicación, proporciona el nombre de tu aplicación, por ejemplo, DatastreamDataverseConnector.
    2. Selecciona el tipo de cuenta, por lo general, Cuentas en este directorio de la organización solo.
    3. Haz clic en Registrar.

  4. Después del registro, copia el ID de aplicación (cliente) y el ID de directorio (usuario) de la página Descripción general a una ubicación segura para usarlos más adelante. Estos IDs son necesarios para el perfil de conexión de Datastream.

  5. Genera el secreto del cliente:

    1. En la configuración de la aplicación registrada, ve a Certificados y secretos > Nuevo secreto del cliente.
    2. Proporciona una descripción y establece una fecha de vencimiento para tu secreto.
    3. Haz clic en Agregar.

  6. Copia el valor secreto generado, ya que solo se muestra una vez. Necesitas el secreto cuando creas el perfil de conexión de Datastream.

  7. Asigna permisos de API:

    1. Ve a Permisos de API > Agregar un permiso.
    2. Selecciona APIs de Microsoft > Dynamics CRM.
    3. Selecciona Permisos de aplicación.
    4. Haz clic en Otorgar consentimiento del administrador para tu directorio.

Configura el usuario de la aplicación Dataverse

Crea un usuario de la aplicación en Dataverse para representar la aplicación AAD.

  1. Accede a tu entorno de Microsoft Dataverse con privilegios de administrador.
  2. Ve a Configuración > Seguridad > Usuarios.
  3. Cambia la vista de Usuarios habilitados a Usuarios de la aplicación.
  4. Haz clic en Nuevo para crear un usuario de la aplicación nuevo.
  5. Pega el ID de aplicación (cliente) copiado de AAD en el campo ID de aplicación. Otros detalles, como el Nombre de usuario , se propagan automáticamente.
  6. Guarde el registro.

  7. Asigna roles de seguridad:

    1. Abre el registro de usuario de la aplicación recién creado.
    2. Haz clic en Administrar roles.
    3. Asigna los roles de seguridad adecuados que otorgan los permisos de lectura necesarios para las tablas que quieres que Datastream replique. Recomendamos usar un rol personalizado con los permisos de lectura mínimos necesarios en las tablas específicas en lugar de un rol amplio, como Administrador del sistema. Asegúrate de que el rol tenga acceso para leer los metadatos de la tabla.

Restricciones de IP

Si tu entorno o red de Dataverse tiene restricciones de direcciones IP, asegúrate de que las direcciones IP públicas de Datastream puedan conectarse a la URL de tu entorno de Dataverse (por ejemplo, ORGANIZATION_NAME.crm.dynamics.com).

¿Qué sigue?