Utilizzare le stringhe di connessione negli strumenti XRM per connettersi a Dynamics 365

  • Articolo

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Con Microsoft Dynamics 365 (online e locale), gli strumenti XRM ti consentono di accedere all'istanza di Dynamics 365 utilizzando le stringhe di connessione. È simile al concetto di stringhe di connessione utilizzate con Microsoft SQL Server. Le stringhe di connessione dispongono del supporto nativo nei file di configurazione, inclusa la possibilità di crittografare le sezioni di configurazione per la massima sicurezza. Questo ti consente di configurare le connessioni Dynamics 365 in fase di distribuzione senza codice del tipo hardcoded nell'applicazione per connetterti all'istanza di Dynamics 365.

In questo argomento

Creare una stringa connessione

Parametri della stringa di connessione

Esempi di stringhe di connessione

Determinare lo stato della connessione

Creare una stringa connessione

Questa stringa di connessione deve essere specificata nel file app.config o web.config del progetto, come illustrato nell'esempio seguente.

<connectionStrings>
    <add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
</connectionStrings>
System_CAPS_security Sicurezza Nota

Se si aggiungono informazioni riservate al file app.config o web.config, ad esempio una password dell'account, assicurarsi di adottare le precauzioni di sicurezza appropriate per proteggerle.

Dopo aver creato la stringa di connessione, usala per creare un oggetto CrmServiceClient.

//Use the connection string named "MyCRMServer"
//from the configuration file
CrmServiceClient crmSvc = new CrmServiceClient(ConfigurationManager.ConnectionStrings["MyCRMServer"].ConnectionString);

Nota

Dovrai utilizzare la seguente direttiva using nel codice per fare riferimento allo spazio dei nomi System.Configuration per accedere alla stringa di connessione nel codice: using System.Configuration;

Dopo aver creato un oggetto CrmServiceClient, potrai utilizzare tale oggetto per eseguire azioni in Dynamics 365.Ulteriori informazioni:Utilizzare strumenti XRM per eseguire azioni in Dynamics 365

Parametri della stringa di connessione

La stringa di connessione contiene una serie di coppie nome-valore separate da punti e virgola. Nella tabella seguente sono elencati i parametri supportati, che possono essere immessi in qualsiasi ordine.

Nome parametro

Descrizione

ServiceUri, Service Uri, Url, or Server

Specifica l'URL per Server Microsoft Dynamics 365. L'URL può utilizzare il protocollo http o https e la porta è facoltativa. La porta predefinita è 80 per il protocollo http e 443 per il protocollo https. L'URL del server è in genere nel formato http://crm-server:port/nome-organizzazione per Dynamics 365 locale e https://nome-organizzazione.crm.dynamics.com per Dynamics 365 (online).

Il nome dell'organizzazione è obbligatorio. Puoi specificare il nome descrittivo o il nome univoco dell'organizzazione per eseguire la connessione.

Esempio: http://contoso/test, http://contoso:5555/test, https://contoso/test, https://test.crm.dynamics.com o http://10.10.10.2/test.

Domain

Specifica il dominio che verifica le credenziali degli utenti.

UserName, User Name, UserId, or User Id

Specifica il nome di identificazione dell'utente associato con le credenziali.

Password

Specifica la password per il nome utente associato con le credenziali.

HomeRealmUri o URI dell'area di autenticazione principale

Specifica l'URI dell'area di autenticazione principale.

AuthenticationType o AuthType

Specifica il tipo di autenticazione per la connessione all'istanza di Dynamics 365. I valori validi sono: AD, IFD (AD FS abilitato), OAuth o Office365.

  • AD e IFD sono consentiti solo per le istanze di Dynamics 365 locale.

  • OAuth e consentito per Dynamics 365 (online) e le istanze locali.

  • Office365 è consentito solo per le istanze di Dynamics 365 (online).

RequireNewInstance

Indica se riutilizzare una connessione esistente se richiamata mentre la connessione è ancora attiva. Il valore predefinito è false che indica che la connessione esistente viene riutilizzata. Se è impostato su true, forzerà il sistema a creare una connessione univoca.

ClientId, AppId o ApplicationId

Specifica ClientID assegnato al momento della registrazione dell'applicazione in Microsoft Azure Active Directory o Active Directory Federation Services (ADFS).

Questo parametro viene applicato solo quando il tipo di autenticazione è specificato come OAuth.

RedirectUri o ReplyUrl

Specifica un URI di reindirizzamento dell'applicazione registrata in Microsoft Azure Active Directory o Active Directory Federation Services (ADFS).

Questo parametro viene applicato solo quando il tipo di autenticazione è specificato come OAuth.

TokenCacheStorePath

Specifica il percorso completo della posizione in cui la cache token dell'utente deve essere archiviata. Il processo in esecuzione deve avere accesso al percorso specificato. È responsabilità dei processi impostare e configurare questo percorso.

Questo parametro viene applicato solo quando il tipo di autenticazione è specificato come OAuth.

LoginPrompt

Specifica se all'utente vengono richieste le credenziali, se non vengono fornite. I valori validi sono:

  • Always: richiede sempre all'utente di specificare le credenziali.

  • Auto: consente all'utente di selezionare nell'interfaccia di controllo accesso se visualizzare o meno la richiesta.

  • Never: non richiede mai all'utente di specificare le credenziali. Se si utilizza un metodo di connessione che non dispone di un'interfaccia utente, è necessario utilizzare questo valore.

Questo parametro viene applicato solo quando il tipo di autenticazione è specificato come OAuth.

Esempi di stringhe di connessione

Gli esempi seguenti illustrano come utilizzare le stringhe di connessione per la connessione alle distribuzioni e agli scenari di autenticazione diversi.

Autenticazione integrata locale

<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />

Account denominato utilizzando l'autenticazione locale

<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test; Domain=CONTOSO; Username=jsmith; Password=passcode" />

Account denominato utilizzando Office 365

<add name="MyCRMServer" connectionString="AuthType=Office365;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso.crm.dynamics.com"/>

OAuth utilizzando l'account denominato in Office 365 con UX per la richiesta di autenticazione

<add name="MyCRMServer" connectionString="AuthType=OAuth;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contosotest.crm.dynamics.com;AppId=<GUID>;RedirectUri =app://<GUID>;TokenCacheStorePath =c:\MyTokenCache;LoginPrompt=Auto"/>

OAuth utilizzando l'account denominato in Dynamics 365 locale con UX per la richiesta di autenticazione

<add name="MyCRMServer" connectionString="AuthType=OAuth;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso:8080/Test;AppId=<GUID>;RedirectUri=app://<GUID>;TokenCacheStorePath =c:\MyTokenCache;LoginPrompt=Auto"/>

IFD utilizzando un account denominato con la delega per un'area di autenticazione secondaria

<add name="MyCRMServer" connectionString="AuthType=IFD;Url=http://contoso:8080/Test; HomeRealmUri=https://server-1.server.com/adfs/services/trust/mex/;Domain=CONTOSO; Username=jsmith; Password=passcode" />

Determinare lo stato della connessione

Per determinare se la richiesta di connessione è riuscita, controllare il valore della proprietà CrmServiceClient.IsReady. Se true, la connessione ha esito positivo e si è pronti per l'utilizzo. In caso contrario, controllare i valori delle proprietà CrmServiceClient. LastCrmError e CrmServiceClient.LastCrmException per la causa dell'errore di connessione.

Vedere anche

CrmServiceClient
Compilare applicazioni client di Windows tramite gli strumenti XRM
Usare i costruttori di CrmServiceClient per connettere a Dynamics 365
Utilizzare strumenti XRM per eseguire azioni in Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright