Questa guida illustra come registrare un'applicazione Azure AD in modo che BuiltWith possa autenticarsi con la tua istanza di Dynamics 365 e aggiornare automaticamente i lead. Sono necessari l'accesso come amministratore di Azure Active Directory e l'accesso come amministratore di sistema di Dynamics 365.
Passaggio 1: registrare una nuova app in Azure Active Directory
Accedi a portal.azure.com con il tuo account amministratore di Azure. Nel menu a sinistra seleziona Azure Active Directory , quindi seleziona Registrazioni app e fai clic su + Nuova registrazione .
Inserisci un nome, ad esempio BuiltWith Integration . In Tipi di account supportati, seleziona Account solo in questa directory organizzativa (tenant singolo) . Lascia vuoto il campo URI di reindirizzamento e fai clic su Registra .
Nella pagina di panoramica dell'app, copia l' ID dell'applicazione (client) e l' ID della directory (tenant) : saranno entrambi necessari quando immetterai le credenziali in BuiltWith.
Passaggio 2: configurare le autorizzazioni API per Dynamics 365
Nella registrazione dell'app, fai clic su Autorizzazioni API nel menu a sinistra, quindi su + Aggiungi un'autorizzazione . Seleziona Dynamics CRM (cerca in "API utilizzate dalla mia organizzazione" se non compare nell'elenco). Seleziona Autorizzazioni delegate , seleziona user_impersonation e fai clic su Aggiungi autorizzazioni .
Passaggio 3: creare un segreto client
Nella registrazione dell'app, fai clic su Certificati e segreti . In Segreti client, fai clic su + Nuovo segreto client , inserisci una descrizione, ad esempio BuiltWith , scegli un periodo di scadenza e fai clic su Aggiungi .
Copia immediatamente il valore segreto (la stringa lunga nella colonna Valore, non l'ID segreto). Questo valore viene mostrato solo una volta e verrà nascosto quando si esce dalla pagina.
Passaggio 4: Concedi il consenso dell'amministratore
Torna alle autorizzazioni API nella registrazione dell'app e fai clic su Concedi consenso amministratore per Fare clic su Sì per confermare. Una volta concesso il consenso, la colonna di stato dovrebbe mostrare un segno di spunta verde accanto a ciascuna autorizzazione.
Passaggio 5: aggiungere l'app come utente dell'applicazione Dynamics 365
Vai su admin.powerplatform.microsoft.com e seleziona il tuo ambiente. Vai su Impostazioni → Utenti + autorizzazioni → Utenti applicazione e clicca su + Nuovo utente app .
Fai clic su + Aggiungi un'app , cerca il nome di registrazione dell'app (integrazione BuiltWith) e selezionalo. Scegli la tua unità aziendale e fai clic su Crea .
Apri l'utente dell'applicazione appena creato e assegnagli il ruolo di sicurezza "Venditore" o un ruolo personalizzato che includa l'accesso in lettura e scrittura all'entità Lead. Il ruolo deve avere almeno i privilegi di "Crea", "Lettura", "Scrittura", "Aggiungi" e "Aggiungi a" sull'entità Lead.
Passaggio 6: immettere le credenziali in BuiltWith
Torna alla pagina di connessione BuiltWith Dynamics 365 e compila i seguenti campi:
ID client : l'ID dell'applicazione (client) copiato nel passaggio 1.
Segreto client : il valore segreto copiato nel passaggio 3 (non l'ID segreto).
ID tenant : l'ID della directory (tenant) copiato nel passaggio 1.
URL di Dynamics 365 : l'URL della tua istanza di Dynamics 365, ad esempio https://yourorg.crm.dynamics.com. Puoi trovarlo nell'interfaccia di amministrazione di Power Platform in Ambienti → il tuo ambiente → URL ambiente.
Fai clic su Salva . BuiltWith verificherà le credenziali con una chiamata di prova alla tua istanza di Dynamics 365. Una volta confermate, l'arricchimento dei lead inizierà automaticamente.
Se viene visualizzato un errore di autenticazione, verificare che il consenso dell'amministratore sia stato concesso nel passaggio 4 e che all'utente dell'applicazione sia stato assegnato il ruolo di sicurezza corretto nel passaggio 5.