Delen via

CrmServiceClient-constructors gebruiken om verbinding te maken met Dynamics 365

  • Artikel

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Om verbinding te maken met Microsoft Dynamics 365, wordt een exemplaar gemaakt van de klasse CrmServiceClient en wordt vervolgens een van de constructors gebruikt om verbinding te maken. Alle oproepen voor Dynamics 365 die CrmServiceClient gebruiken, zijn thread-veilig.

Naast de constructors die in dit onderwerp worden vermeld, kunt u ook verbindingsreeksen gebruiken met CrmServiceClient om verbinding te maken met Dynamics 365.Meer informatie:Verbinding maken met Dynamics 365 door middel van verbindingsreeksen in XRM-tooling

In dit onderwerp

Verbinding met Dynamics 365 maken via OrganizationServiceProxy

Verbinding met Dynamics 365 maken via OrganizationWebProxyClient

Verbinding maken met Dynamics 365 (online) (Office 365)

Verbinding maken met Dynamics 365 (online) (Office 365) via OAuth

Verbinding maken met Dynamics 365 on-premises (Active Directory)

Verbinding maken met Dynamics 365 Internet Facing Deployment (IFD)

Verbinding maken met Dynamics 365 Internet Facing Deployment (IFD) via OAuth

Verbinding maken met Dynamics 365 (op claims gebaseerd)

Uw verbindingsstatus bepalen

Verbinding met Dynamics 365 maken via OrganizationServiceProxy

Gebruik de volgende constructor om verbinding te maken met Dynamics 365 met het door de gebruiker opgegeven OrganizationServiceProxy-exemplaar.

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceProxy>);

Verbinding met Dynamics 365 maken via OrganizationWebProxyClient

Gebruik de volgende constructor om verbinding te maken met Dynamics 365 met het door de gebruiker opgegeven OrganizationWebProxyClient-exemplaar. Deze constructor is geïntroduceerd in Microsoft Dynamics 365 (online en on-premises).

CrmServiceClient crmSvc = new CrmServiceClient(<orgWebProxyClient>);

Verbinding maken met Dynamics 365 (online) (Office 365)

Gebruik de volgende constructor om verbinding te maken met uw Dynamics 365 (online)-exemplaar in Office 365.

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

Geldige waarden voor de parameter <CrmRegion> zijn: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND en NorthAmerica2. Als u dit instelt op String.Empty, worden op servers in alle regio's gezocht naar de Dynamics 365-organisatie. Voor de parameter <OrgName> kunt u de unieke of de beschrijvende naam opgeven.

De volgende parameters zijn optioneel: useUniqueInstance, useSsl en orgDetail.

Verbinding maken met Dynamics 365 (online) (Office 365) via OAuth

Gebruik de volgende constructor met het protocol OAuth om verbinding te maken met uw Dynamics 365 (online)-exemplaar in Office 365.OAuth-ondersteuning wordt geïntroduceerd in Microsoft Dynamics 365 (online en on-premises).

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

Deze constructor gebruikt Microsoft Azure Active Directory Authentication Library (ADAL) voor verificatie van gebruikers. Als de gebruikersreferenties (gebruikersnaam en wachtwoord) niet worden opgegeven, vraagt ADAL de gebruiker de referenties op te geven, afhankelijk van de vraag of de parameter PromptBehavior (optioneel) in de constructor is opgegeven. ADAL verifieert de referenties met het protocol OAuth, verkrijgt toegang en vernieuwt tokens van Azure Active Directory. Vervolgens wordt het toegangstoken gebruikt om aanvragen in Dynamics 365 te maken.

Geldige waarden voor de parameter <CrmRegion> zijn: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND en NorthAmerica2. Als u dit instelt op String.Empty, worden server in al deze regio's doorzocht voor de Dynamics 365-organisatie. Voor de parameter <OrgName> kunt u de unieke of de beschrijvende naam opgeven.

Verbinding maken met Dynamics 365 on-premises (Active Directory)

Gebruik de volgende constructor om verbinding te maken met een lokaal exemplaar met Active Directory-verificatie.

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

Hiermee wordt een Active Directory-verificatie uitgevoerd op basis van het opgegeven domein. Geef voor de parameter <Server> de hostnaam van uw Dynamics 365-server op, bijvoorbeeld: crmtest. Voor de parameter <OrgName> kunt u de unieke of de beschrijvende naam opgeven.

De volgende parameters zijn optioneel: useUniqueInstance, useSsl en orgDetail.

Verbinding maken met Dynamics 365 Internet Facing Deployment (IFD)

Gebruik de volgende constructor om verbinding te maken met een Dynamics 365 IFD-exemplaar .

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

Hiermee wordt een op claims gebaseerde verificatie uitgevoerd op basis van het opgegeven lokale domein. Dit is handig voor klanten die AD FS gebruiken en hun Dynamics 365-server als claims hebben geconfigureerd, waarbij de gebruikerspopulatie in hetzelfde AD FS-domein leeft als de Dynamics 365-server. Geef voor de parameter <Server> de hostnaam van uw Dynamics 365-server op, bijvoorbeeld: crmtest. Voor de parameter <OrgName> kunt u de unieke of de beschrijvende naam opgeven.

De volgende parameters zijn optioneel: useUniqueInstance, useSsl en orgDetail.

Verbinding maken met Dynamics 365 Internet Facing Deployment (IFD) via OAuth

Gebruik de volgende constructor met het protocol OAuth in Active Directory Federation Services (AD FS) in Windows Server 2012 R2 om verbinding te maken met een Dynamics 365 IFD-exemplaar . Deze constructor werkt alleen als de computer waarop Microsoft Dynamics 365 Server is geïnstalleerd, is geconfigureerd om AD FS 2.2 te gebruiken als de STS (Security Token Service).OAuth-ondersteuning voor het maken van verbinding met een Dynamics 365 IFD-exemplaar wordt geïntroduceerd in 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);

De waarden clientId en redirectUri voor de toepassing die OAuth ondersteunt, moeten op de IFD-server worden geregistreerd.

Als de gebruikersreferenties (gebruikersnaam en wachtwoord) niet worden opgegeven, vraagt ADAL de gebruiker de referenties op te geven, afhankelijk van de vraag of de parameter PromptBehavior (optioneel) in de constructor is opgegeven. ADAL verifieert de gebruiker met het beveiligingstoken van AD FS en gebruikt het token om acties uit te voeren in Dynamics 365.

Verbinding maken met Dynamics 365 (op claims gebaseerd)

Gebruik de volgende constructor om op claims gebaseerde verificatie te gebruiken.

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

Hiermee wordt een op claims gebaseerde verificatie uitgevoerd voor het opgegeven thuisdomein. Dit is handig voor klanten die AD FS gebruiken en hun Dynamics 365-server als claims hebben geconfigureerd, waarbij de gebruikerspopulatie in hetzelfde AD FS-domein leeft als de Dynamics 365-server. Geef voor de parameter <Server> de hostnaam van uw Dynamics 365-server op, bijvoorbeeld: crmtest. Voor de parameter <OrgName> kunt u de unieke of de beschrijvende naam opgeven.

Uw verbindingsstatus bepalen

Om te bepalen of het verbindingsverzoek is geslaagd, controleert u de waarde van de eigenschap CrmServiceClient.IsReady. Indien true, is de verbinding geslaagd en kunt u meteen aan het werk. Controleer anders de waarden van CrmServiceClient.LastCrmError en CrmServiceClient.LastCrmException-eigenschappen voor de oorzaak van de verbindingsfout.

Zie ook

AuthenticationType
Verbinding maken met Dynamics 365 door middel van verbindingsreeksen in XRM-tooling
PowerShell-cmdlets gebruiken voor XRM-tooling om verbinding met Dynamics 365 te maken
XRM-tooling gebruiken om acties uit te voeren in Dynamics 365
Voorbeeld: Aan de slag voor Microsoft Dynamics 365
Windows clienttoepassingen maken met de XRM-hulpprogramma's

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht