Configura un'origine Microsoft Dataverse per CDC

Questa pagina descrive come configurare un ambiente Microsoft Dataverse per trasmettere dati di modifica a una destinazione supportata utilizzando Datastream.

Prima di iniziare

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

  • Avere accesso a un abbonamento Microsoft Azure attivo con 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 Microsoft Azure, in Dataverse e in Dynamics 365.
  • Disporre delle autorizzazioni per registrare applicazioni in AAD e creare o assegnare ruoli in Dataverse.

Configura 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. A questo scopo, è necessario 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 Azure con un account amministratore.
  2. Nel portale, vai a Azure Active Directory > Registrazioni app > Nuova registrazione.

  3. Registra l'applicazione:

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

  4. Dopo la registrazione, copia l'ID applicazione (client) e l'ID directory (tenant) dalla pagina Panoramica in una posizione sicura per utilizzarli in un secondo momento. Questi ID sono obbligatori 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. Devi fornire il 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 tua directory.

Configurare l'utente dell'applicazione Dataverse

Crea un utente 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. Cambia 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 utente 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 di lettura minime richieste per le tabelle specifiche anziché un ruolo generico, ad esempio Amministratore di sistema. Assicurati che il ruolo abbia accesso alla lettura dei metadati della tabella.

Limitazioni IP

Se il tuo ambiente o la tua rete Dataverse ha limitazioni per gli indirizzi IP, assicurati che gli indirizzi IP pubblici di Datastream possano connettersi all'URL del tuo ambiente Dataverse (ad esempio, ORGANIZATION_NAME.crm.dynamics.com).

Passaggi successivi