Procedura dettagliata: registrare un plug-in che riconosce Azure con lo strumento per la registrazione di CRM

  • Articolo

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

La procedura dettagliata illustra come configurare Servizio di controllo di accesso (ACS) di Microsoft Azure Active Directory e registrare un passaggio di endpoint del servizio utilizzando lo strumento per la registrazione dei plug-in. Dopo la configurazione, Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online possono pubblicare il contesto di esecuzione dell'operazione corrente in un endpoint della soluzione di Microsoft Azure. Per questa procedura dettagliata, il passaggio è registrato per pubblicare il contesto di esecuzione del messaggio CreateRequest per un'entità Account nel Bus di servizio di Microsoft Azure.

I prerequisiti seguenti devono essere completati prima di iniziare questa procedura dettagliata:

Passaggi

Questa procedura dettagliata contiene le operazioni seguenti:

  1. Connessione al server Microsoft Dynamics CRM

  2. Creare una configurazione dell'endpoint del servizio

  3. Configura ACS

  4. Registrare un passaggio di endpoint del servizio per un evento

  5. Verificare la registrazione degli endpoint

Connessione al server Microsoft Dynamics CRM

Eseguire la procedura seguente per connettersi al server Microsoft Dynamics 365 utilizzando lo strumento per la registrazione dei plug-in.

  1. Eseguire lo strumento Plug-in Registration.

  2. Selezionare Crea nuova connessione.

  3. Nella finestra di dialogo Accesso, selezionare il pulsante di opzione del tipo di distribuzione che corrisponde al server di Microsoft Dynamics 365 a cui si intende registrare un endpoint del servizio. Il pulsante di opzione Locale include una distribuzione IFD, il pulsante Online è relativo al provider Windows Live di Microsoft Dynamics CRM Online e il pulsante Office 365 è relativo al provider Microsoft Online Services di Microsoft Dynamics CRM Online.

    Modulo di accesso per una distribuzione online

    Modulo di accesso per una distribuzione online
    Finestra di accesso per una distribuzione locale

    Modulo di accesso per una distribuzione locale

  4. Se si seleziona Visualizza sempre l'elenco delle organizzazioni disponibili, verrà presentato un elenco di organizzazioni a cui appartiene l'utente dopo avere selezionato Accedi. Ciò consente di scegliere l'organizzazione a cui si desidera registrare l'endpoint del servizio. In caso contrario, viene utilizzata l'organizzazione predefinita.

  5. Immettere le informazioni indicate sul server e l'account di accesso, quindi selezionare Accedi.

Creare una configurazione dell'endpoint del servizio

Attenersi alla procedura seguente per registrare un endpoint del servizio di Microsoft Azure.

  1. Selezionare la scheda dell'organizzazione a cui si desidera registrare un endpoint del servizio.

  2. Nella barra degli strumenti della scheda, selezionare Registra, quindi su Registra nuovo endpoint del servizio.

  3. Compilare la finestra di dialogo Registrazione endpoint di servizio con le informazioni relative alla soluzione come illustrato nella figura riportata di seguito e descritto nella tabella seguente. Verificare che il contratto specificato sia uguale a quello utilizzato dall'applicazione listener della soluzione.

    Creare un endpoint servizio

    Elemento interfaccia utente

    description

    Nome (campo)

    Nome per la registrazione dell'endpoint del servizio.

    Descrizione (campo)

    Descrizione della registrazione dell'endpoint.

    Spazio dei nomi soluzione (campo)

    Nome dello spazio dei nomi del servizio della soluzione.

    Percorso (campo)

    Percorso del progetto. Ad esempio, dato un URL dell'endpoint del servizio di https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo, il percorso è TwoWayService/Demo.

    Contratto (menu a discesa)

    Contratto dell'endpoint. Un'applicazione listener deve utilizzare questo contratto per leggere il messaggio pubblicato. Per ulteriori informazioni, vedere Scrivere un listener per una soluzione Microsoft Azure.

    Attestazione (menu a discesa)

    Attestazioni da inviare a Microsoft Azure. Utilizzare Nessuno per l'attestazione standard. Specificare UserId o UserInfo per inviare informazioni aggiuntive sull'utente connesso.

    Modalità federata (casella di controllo)

    Selezionare questa casella per utilizzare la modalità federata.

    ID (campo)

    Campo non modificabile compilato automaticamente con l'ID della configurazione dell'endpoint.

    Salva e configura ACS (pulsante)

    Salva la configurazione immessa e automatizza il processo di configurazione di ACS. Offre un modo interattivo per realizzare quanto descritto nell'argomento Procedura dettagliata: Configurare il servizio ACS di Microsoft Azure per l'integrazione con Microsoft Dynamics CRM 2015.

    Salva e verifica autenticazione (pulsante)

    Salva la configurazione immessa e verifica che ACS sia configurato correttamente.

    Salva (pulsante)

    Salva la configurazione immessa e chiude la finestra di dialogo.

  4. Se non è ancora stata configurata l'integrazione di ACS con Microsoft Dynamics 365 e si desidera eseguire tale operazione mediante lo strumento per la registrazione dei plug-in, selezionare Salva e configura (ACS), quindi seguire le istruzioni nella sezione successiva della procedura dettagliata. Se è già stato configurato ACS, selezionare Salva e verifica autenticazione o Salva e seguire le istruzioni in Registrare un passaggio di endpoint del servizio per un evento.

Configura ACS

Attenersi alle istruzioni di seguito per configurare Servizio di controllo di accesso (ACS) di Microsoft Azure Active Directory.

  1. Dopo aver selezionare Salva e configura ACS, viene visualizzata la finestra di dialogo Configurazione di ACS. Immetti i valori dati appropriati nei campi del modulo come descritto nella tabella riportata di seguito.

    Nome campo

    Descrizione

    Chiave di gestione

    Chiave di gestione per la soluzione. Puoi ottenere il valore di questa chiave dal Portale di gestione di Azure.

    Ottenere una chiave di gestione per uno spazio dei nomi del bus di servizio

    1. Accedi al portale Azure.

    2. Nel pane di sinistra selezionare Bus di servizio, quindi selezionare lo spazio dei nomi di destinazione nell'elenco.

    3. Selezionare Informazioni sulla connessione nella parte inferiore della pagina.

    4. Nella finestra di dialogo Accedi a informazioni di connessione viene visualizzata la Chiave predefinita. Si tratta della chiave di gestione.

    Nota

    Se hai modificato la chiave simmetrica, immetti tale chiave anziché la chiave predefinita nel campo Chiave di gestione. In caso contrario, potresti ricevere errori con una descrizione simile alla seguente: "ACS50012: Autenticazione non riuscita".

    File certificato

    File del certificato pubblico utilizzato per configurare Microsoft Dynamics 365 per l'integrazione con Microsoft Azure.

    Per Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015, puoi scaricare il file del certificato dal server. Nell'applicazione Web di Microsoft Dynamics 365 selezionare Impostazioni > Personalizzazioni, quindi selezionare Risorse per sviluppatori. Scaricare e salvare il file di certificato utilizzando il collegamento fornito sotto Certificato autorità emittente Bus di servizio di Microsoft Azure.

    Nome autorità emittente

    Nome dell'autorità emittente. Il nome deve essere lo stesso utilizzato per configurare Microsoft Dynamics 365 per l'integrazione con Microsoft Azure. Puoi ottenere il nome dell'autorità emittente dalla pagina Web Risorse per sviluppatori menzionata nella descrizione precedente.

    Per ulteriori informazioni, vedere Configurare l'integrazione di Azure con Microsoft Dynamics CRM 2015.

  2. Selezionare Configura ACS. Nell'area di output del modulo viene visualizzato un registro della procedura di configurazione.

  3. Scegliere Chiudi.

  4. Selezionare Salva e verifica autenticazione nella finestra di dialogo Registrazione endpoint di servizio. Una volta completata la verifica puoi chiudere le finestre di dialogo.

Registrare un passaggio di endpoint del servizio per un evento

Eseguire la procedura seguente per registrare un passaggio per un evento nell'endpoint del servizio.

  1. Selezionare l'endpoint del servizio registrato in precedenza nella visualizzazione ad albero dello strumento.

  2. Passare al menu Registro e selezionare Registra nuovo passaggio.

  3. Compilare la finestra di dialogo Registra nuovo passaggio per un evento di creazione dell'account come illustrato nella figura seguente.

    Crea un passaggio di endpoint servizio

  4. Selezionare Registra nuovo passaggio.

Microsoft Dynamics 365 ora pubblicherà il messaggio corrente contenente il contesto di esecuzione nel bus di servizio ogni volta che viene creato un account. Il post viene eseguito in modalità asincrona e non immediatamente.

Verificare la registrazione degli endpoint

Dopo la registrazione dell'endpoint è possibile verificarlo. Un listener deve essere in esecuzione o una coda deve essere disponibile nell'endpoint di destinazione per consentire il post del bus di servizio dal plug-in.

  1. Aprire l'applicazione Web di Microsoft Dynamics 365 per la stessa organizzazione in cui è stato registrato l'endpoint del servizio.

  2. Scegliere il pulsante CreaPulsante Crea, quindi scegliere Account.

  3. Immettere un nome dell'account, ad esempio Adventure Works Cycle, nel campo Nome account e quindi selezionare Salva.

  4. Attendere circa 10 minuti per effettuare il post del Bus di servizio di Microsoft Azure.

  5. Scegliere Impostazioni > Processi di sistema.

  6. Aprire il processo di sistema con lo stesso nome specificato per l'endpoint del servizio. Controllare lo stato per verificare se il post ha avuto esito positivo, è in attesa o ha avuto esito negativo.

Ora è possibile annullare la registrazione dell'endpoint, qualora lo si desidera, selezionandola nella visualizzazione ad albero dello strumento e quindi selezionare Annulla registrazione.

Vedere anche

Estensioni Azure per Microsoft Dynamics CRM 2015
Integrazione di Azure con Microsoft Dynamics CRM
Active Directory e autenticazione basata sulle attestazioni

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright