Utiliser les constructeurs CrmServiceClient 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

Pour se connecter à Microsoft Dynamics 365, vous créez une instance de la classe CrmServiceClient, puis utilisez l’un des constructeurs pour se connecter. Tous les appels à Dynamics 365 avec la classe CrmServiceClient sont thread-safe.

En plus des constructeurs répertoriés dans cette rubrique, vous pouvez également utiliser des chaînes de connexion avec CrmServiceClient pour vous connecter à Dynamics 365.Pour plus d'informations :Utiliser les chaînes de connexion des outils XRM pour se connecter à Dynamics 365

Contenu de la rubrique

Se connecter à Dynamics 365 à l’aide de OrganizationServiceProxy

Se connecter à Dynamics 365 à l’aide de OrganizationWebProxyClient

Se connecter à Dynamics 365 (en ligne) (Office 365)

Se connecter à Dynamics 365 (en ligne) (Office 365) avec OAuth

Se connecter à Dynamics 365 localement (Active Directory)

Se connecter au déploiement avec accès via Internet de Dynamics 365

Se connecter au déploiement avec accès via Internet de Dynamics 365 à l'aide d'OAuth

Se connecter à Dynamics 365 (basé sur les revendications)

Déterminer l’état de votre connexion

Se connecter à Dynamics 365 à l’aide de OrganizationServiceProxy

Utilisez le constructeur suivant pour vous connecter à Dynamics 365 à l’aide de l’instance OrganizationServiceProxy fournie par l’utilisateur.

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceProxy>);

Se connecter à Dynamics 365 à l’aide de OrganizationWebProxyClient

Utilisez le constructeur suivant pour vous connecter à Dynamics 365 à l’aide de l’instance OrganizationWebProxyClient fournie par l’utilisateur. Ce constructeur est présenté dans Microsoft Dynamics 365 (Online et local).

CrmServiceClient crmSvc = new CrmServiceClient(<orgWebProxyClient>);

Se connecter à Dynamics 365 (en ligne) (Office 365)

Utilisez le constructeur suivant pour vous connecter à votre instance Dynamics 365 (en ligne) dans Office 365.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>, isOffice365:true);

Les valeurs valides pour le paramètre <CrmRegion> sont : NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND et NorthAmerica2. Si vous le définissez sur String.Empty, il recherchera les serveurs dans toutes les régions de l’organisation Dynamics 365. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Les paramètres suivants sont facultatifs : useUniqueInstance, useSsl et orgDetail.

Se connecter à Dynamics 365 (en ligne) (Office 365) avec OAuth

Utilisez le constructeur suivant pour utiliser le protocole OAuth pour vous connecter à votre instance Dynamics 365 (en ligne) dans Office 365. La prise en charge d'OAuth est présentée dans Microsoft Dynamics 365 (Online et local).

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, <orgDetail>,
                  <userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, <externalOrgWebProxyClient>, PromptBehavior.Auto);

Ce constructeur utilise la Bibliothèque d'authentification Microsoft Azure Active Directory (ADAL) pour authentifier les utilisateurs. Si les informations d'identification de l'utilisateur (nom d'utilisateur et mot de passe) ne sont pas spécifiées, ADAL invite l'utilisateur à les fournir en fonction du paramètre PromptBehavior (facultatif) spécifié dans le constructeur. ADAL authentifie les informations d'identification à l'aide du protocole OAuth, obtient les jetons d'accès et d'actualisation d'Azure Active Directory, puis utilise le jeton d'accès pour adresser des demandes à Dynamics 365.

Les valeurs valides pour le paramètre <CrmRegion> sont : NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND et NorthAmerica2. Si vous le définissez avec String.Empty, il recherchera les serveurs dans toutes les régions de l’organisation Dynamics 365. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Se connecter à Dynamics 365 localement (Active Directory)

Utilisez le constructeur suivant pour vous connecter à une instance locale avec l'authentification Active Directory.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.AD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);

Il s’ensuivra l’exécution d’une authentification Active Directory basée sur le domaine spécifié. Pour le paramètre <Server>, spécifiez le nom d’hôte de votre serveur Dynamics 365, crmtest, par exemple. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Les paramètres suivants sont facultatifs : useUniqueInstance, useSsl et orgDetail.

Se connecter au déploiement avec accès via Internet de Dynamics 365

Utilisez le constructeur suivant pour vous connecter à une instance IFD de Dynamics 365.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);

Cette méthode exécute une authentification basée sur les revendications selon le domaine local spécifié. Cette fonction est utile pour les clients qui utilisent AD FS et ont configuré leur serveur Dynamics 365 en tant que revendications, où la population de l’utilisateur réside dans le même domaine AD FS que le serveur Dynamics 365. Pour le paramètre <Server>, spécifiez le nom d’hôte de votre serveur Dynamics 365, crmtest, par exemple. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

Les paramètres suivants sont facultatifs : useUniqueInstance, useSsl et orgDetail.

Se connecter au déploiement avec accès via Internet de Dynamics 365 à l'aide d'OAuth

Utilisez le constructeur suivant pour utiliser le protocole OAuth dans Active Directory Federation Services (AD FS) dans Windows Server 2012 R2 pour vous connecter à une instance IFD de Dynamics 365. Pour assurer le bon fonctionnement de ce constructeur, l'ordinateur sur lequel Microsoft Dynamics 365 Server est installé doit avoir été configuré pour utiliser AD FS 2.2 comme service d'émission de jeton de sécurité (STS). La prise en charge d'OAuth pour se connecter à une instance IFD de Dynamics 365 est présentée dans Dynamics 365.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<HomeRealm>", "<HostName>", "<Port>", "<OrgName>", useSsl:true, useUniqueInstance:false, 
                        <orgDetail>, <userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, externalOrgWebProxyClient, PromptBehavior.Auto);

Les valeurs clientId et redirectUri de l'application prenant en charge OAuth doivent être enregistrées dans le serveur IFD.

Si les informations d'identification de l'utilisateur (nom d'utilisateur et mot de passe) ne sont pas spécifiées, ADAL invite l'utilisateur à les fournir en fonction du paramètre PromptBehavior (facultatif) spécifié dans le constructeur. ADAL authentifie l'utilisateur à l'aide du jeton de sécurité d'AD FS, puis utilise le jeton pour effectuer des actions dans Dynamics 365.

Se connecter à Dynamics 365 (basé sur les revendications)

Utilisez le constructeur suivant pour utiliser l’authentification basée sur les revendications.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");

Cette méthode exécute une authentification basée sur les revendications sur l’accueil de domaine spécifié. Cette fonction est utile pour les clients qui utilisent AD FS et ont configuré leur serveur Dynamics 365 en tant que revendications, où la population de l’utilisateur réside dans le même domaine AD FS que le serveur Dynamics 365. Pour le paramètre <Server>, spécifiez le nom d’hôte de votre serveur Dynamics 365, crmtest, par exemple. Pour le paramètre <OrgName>, vous pouvez spécifier le nom unique ou le nom convivial.

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 identifier la cause de l'échec de la connexion.

Voir aussi

AuthenticationType
Utiliser les chaînes de connexion des outils XRM pour se connecter à Dynamics 365
Utiliser les applets de commande PowerShell pour que les outils XRM se connectent à Dynamics 365
Utiliser les outils XRM pour exécuter des actions dans Dynamics 365
Exemple : Démarrage rapide de Microsoft Dynamics 365
Créer des applications clientes Windows à l’aide des outils XRM

Microsoft Dynamics 365

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