Utiliser les chaînes de connexion des outils XRM pour se connecter à Dynamics 365
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>
.jpeg "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.
|
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 :
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