Share via

Utiliser les chaînes de connexion des outils XRM pour se connecter à Dynamics 365

  • Article

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Avec Microsoft Dynamics 365 (Online et local), les outils XRM permettent de vous connecter à votre instance de Dynamics 365 à l'aide de chaînes de connexion. C’est similaire au concept des chaînes de connexion utilisées avec Microsoft SQL Server. Les chaînes de connexion assurent une prise en charge native dans les fichiers de configuration, notamment la capacité d'encoder les sections de configuration pour un maximum de sécurité. Cela vous permet de configurer les connexions Dynamics 365 au moment du déploiement sans les coder en dur dans votre application pour vous connecter à votre instance de Dynamics 365.

Contenu de la rubrique

Créer une chaîne de connexion

Paramètres de la chaîne de connexion

Exemples de chaîne de connexion

Déterminer l’état de votre connexion

Créer une chaîne de connexion

Vous spécifiez la chaîne de connexion dans le fichier app.config ou web.config de votre projet, comme illustré dans l'exemple suivant.

<connectionStrings>
    <add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
</connectionStrings>
System_CAPS_security Sécurité Remarque

Si vous ajoutez les informations sensibles au fichier app.config ou web.config, par exemple un mot de passe de compte, veillez à prendre les précautions qui s’imposent pour protéger les informations.

Après avoir créé la chaîne de connexion, vous l'utilisez pour créer un objet CrmServiceClient.

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

Notes

Vous devrez utiliser la directive using suivante dans votre code pour référencer l'espace de noms System.Configuration et accéder à la chaîne de connexion dans votre code : using System.Configuration;

Après avoir créé un objet CrmServiceClient, vous pouvez l'utiliser pour exécuter des actions dans Dynamics 365.Pour plus d'informations :Utiliser les outils XRM pour exécuter des actions dans Dynamics 365

Paramètres de la chaîne de connexion

La chaîne de connexion contient une série de paires nom=valeur séparées par des points-virgules. Le tableau suivant répertorie les paramètres pris en charge. Ils peuvent être saisis dans n’importe quel ordre.

Nom du paramètre

Description

ServiceUri, Service Uri, Url, or Server

Spécifie l'URL de Microsoft Dynamics 365 Server. L'URL peut utiliser le protocole http ou https, et le port est facultatif. Le port par défaut est 80 pour le protocole http et 443 pour le protocole https. L'URL du serveur est généralement au format http://crm-server:port/nom-organisation pour Dynamics 365 local et https://nom-organisation.crm.dynamics.com pour Dynamics 365 (en ligne).

Le nom d'organisation est nécessaire. Vous pouvez spécifier le nom convivial ou le nom unique de l'organisation à laquelle vous vous connectez.

Exemple : http://contoso/test, http://contoso:5555/test, https://contoso/test, https://test.crm.dynamics.com ou http://10.10.10.2/test.

Domain

Spécifie le domaine qui recherchera les informations d’identification.

UserName, User Name, UserId, or User Id

Spécifie le nom de l’ID d’utilisateur associé aux informations d’identification.

Password

Spécifie le mot de passe d’utilisateur associé aux informations d’identification.

HomeRealmUri ou URI du domaine d'accueil

Spécifie l'URI du domaine d'accueil.

AuthenticationType ou AuthType

Spécifie le type d'authentification pour se connecter à l'instance de Dynamics 365. Les valeurs valides vont : AD, IFD (AD FS activé), OAuth ou Office365.

  • AD et IFD sont autorisés uniquement pour les instances locales de Dynamics 365.

  • OAuth est autorisé pour Dynamics 365 (en ligne) et les instances locales.

  • Office365 est autorisé uniquement pour les instances de Dynamics 365 (en ligne).

RequireNewInstance

Spécifie s’il faut réutiliser une connexion existante en cas de rappel lorsque la connexion est toujours active. La valeur par défaut est false qui indique que la connexion existante est réutilisée. Si la valeur est true, le système sera contraint de créer une connexion unique.

ClientId, AppId ou ApplicationId

Spécifie le ClientID attribué lorsque vous avez enregistré votre application dans Microsoft Azure Active Directory ou Services ADFS (Active Directory Federation Services).

Ce paramètre n'est applicable que lorsque le type d'authentification est spécifié en tant que OAuth.

RedirectUri ou ReplyUrl

Spécifie l'URI de redirection de l'application que vous avez enregistrée dans Microsoft Azure Active Directory ou Services ADFS (Active Directory Federation Services).

Ce paramètre n'est applicable que lorsque le type d'authentification est spécifié en tant que OAuth.

TokenCacheStorePath

Spécifie le chemin d'accès complet à l'emplacement où le cache de jeton de l'utilisateur doit être stocké. Le processus d'exécution doit avoir accès au chemin d'accès spécifié. Il incombe aux processus de définir et de configurer ce chemin d'accès.

Ce paramètre n'est applicable que lorsque le type d'authentification est spécifié en tant que OAuth.

LoginPrompt

Spécifie si l'utilisateur est invité à fournir les informations d'identification si elles ne sont pas fournies. Les valeurs valides sont :

  • Always : invite toujours l'utilisateur à spécifier les informations d'identification.

  • Auto : permet à l'utilisateur de choisir si l'invite doit être affichée ou non dans l'interface de contrôle de la connexion.

  • Never : n'invite pas l'utilisateur à spécifier les informations d'identification. Si l'utilisation d'une méthode de connexion ne dispose pas d'une interface utilisateur, vous devez utiliser cette valeur.

Ce paramètre n'est applicable que lorsque le type d'authentification est spécifié en tant que OAuth.

Exemples de chaîne de connexion

Les exemples ci-dessous montrent comment utiliser les chaînes de connexion pour se connecter à différents déploiements et scénarios d'authentification.

Authentification locale intégrée

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

Compte nommé utilisant l'authentification locale

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

Compte nommé utilisant Office 365

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

OAuth utilisant un compte nommé dans Office 365 avec UX pour demander l'authentification

<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 utilisant un compte nommé dans Dynamics 365 local avec UX pour demander l'authentification

<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 utilisant un compte nommé avec la délégation à un sous-domaine

<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" />

Déterminer l’état de votre connexion

Pour déterminer si la demande de connexion a été réussie, vérifiez la valeur de la propriété CrmServiceClient.IsReady. Si la valeur est true, la connexion est réussie et vous êtes prêt à travailler. Sinon, vérifiez les valeurs des propriétés CrmServiceClient. LastCrmError et CrmServiceClient.LastCrmException pour déterminer la cause de la défaillance de la connexion.

Voir aussi

CrmServiceClient
Créer des applications clientes Windows à l’aide des outils XRM
Utiliser les constructeurs CrmServiceClient pour se connecter à Dynamics 365
Utiliser les outils XRM pour exécuter des actions dans Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright