Configura un'origine Microsoft Dataverse per CDC

Datastream consente di eseguire lo streaming dei dati di modifica da un ambiente Microsoft Dataverse a una destinazione supportata, come BigQuery o Cloud Storage. Per preparare l'origine, registra un client OAuth 2.0 in Microsoft Entra ID, configura un utente dell'applicazione Dataverse e consenti gli indirizzi IP pubblici di Datastream, se necessario.

Prima di iniziare

Prima di iniziare a configurare Dataverse per l'utilizzo con Datastream, devi:

  • Avere accesso a un abbonamento Microsoft Azure attivo con le autorizzazioni per gestire Azure Active Directory (AAD) e Dataverse.
  • Avere un ambiente Dataverse attivo.
  • Avere familiarità con la navigazione e la modifica delle impostazioni nel portale di Microsoft Azure, in Dataverse e in Dynamics 365.
  • Disporre delle autorizzazioni per registrare le applicazioni in AAD e creare o assegnare ruoli in Dataverse.

Configurare un ambiente Microsoft Dataverse per l'utilizzo con Datastream

Per stabilire una connessione tra l'ambiente Dataverse e Datastream, devi eseguire l'autenticazione utilizzando il flusso delle credenziali client OAuth 2.0. Per farlo, devi registrare un'applicazione in AAD e configurare un utente dell'applicazione in Dataverse.

Registrare un'applicazione in Azure Active Directory

Dataverse utilizza AAD per l'autenticazione. Per registrare un'applicazione, segui questi passaggi:

  1. Accedi al portale di Azure con un account amministratore.
  2. Nel portale, vai ad Azure Active Directory > Registrazioni app > Nuova registrazione.

  3. Registra l'applicazione:

    1. In Nome applicazione, fornisci il nome dell'applicazione, per esempio, DatastreamDataverseConnector.
    2. Seleziona il tipo di account, in genere Solo account in questa directory dell'organizzazione.
    3. Fai clic su Registra.

  4. Dopo la registrazione, copia l'ID applicazione (client) e l'ID directory (tenant) dalla pagina Panoramica in una posizione sicura per un utilizzo futuro. Questi ID sono necessari per il profilo di connessione Datastream.

  5. Genera il client secret:

    1. Nelle impostazioni dell'applicazione registrata, vai a Certificati e secret > Nuovo client secret.
    2. Fornisci una descrizione e imposta una data di scadenza per il secret.
    3. Fai clic su Aggiungi.

  6. Copia il valore del secret generato, perché viene visualizzato una sola volta. Avrai bisogno del secret quando crei il profilo di connessione Datastream.

  7. Assegna le autorizzazioni API:

    1. Vai ad Autorizzazioni API > Aggiungi un'autorizzazione.
    2. Seleziona API Microsoft > Dynamics CRM.
    3. Seleziona Autorizzazioni applicazione.
    4. Fai clic su Concedi il consenso amministratore per la directory.

Configurare l'utente dell'applicazione Dataverse

Crea un utente dell'applicazione in Dataverse per rappresentare l'applicazione AAD.

  1. Accedi al tuo ambiente Microsoft Dataverse con privilegi amministrativi.
  2. Vai a Impostazioni > Sicurezza > Utenti.
  3. Modifica la visualizzazione da Utenti abilitati a Utenti dell'applicazione.
  4. Fai clic su Nuovo per creare un nuovo utente dell'applicazione.
  5. Incolla l'ID applicazione (client) copiato da AAD nel campo ID applicazione. Altri dettagli, come il Nome utente , vengono compilati automaticamente.
  6. Salva il record.

  7. Assegna i ruoli di sicurezza:

    1. Apri il record dell'utente dell'applicazione appena creato.
    2. Fai clic su Gestisci ruoli.
    3. Assegna i ruoli di sicurezza appropriati che concedono le autorizzazioni di lettura necessarie per le tabelle che vuoi che Datastream replichi. Ti consigliamo di utilizzare un ruolo personalizzato con le autorizzazioni in lettura minime richieste per le tabelle specifiche anziché un ruolo ampio, come Amministratore di sistema. Assicurati che il ruolo abbia accesso alla lettura dei metadati della tabella.

Limitazioni IP

Se l'ambiente o la rete Dataverse ha limitazioni per gli indirizzi IP, assicurati che gli indirizzi IP pubblici di Datastream siano autorizzati a connettersi all'URL dell'ambiente Dataverse (ad esempio, ORGANIZATION_NAME.crm.dynamics.com).

Passaggi successivi