CrmServiceClient 구축자를 사용하여 Dynamics 365에 연결
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Microsoft Dynamics 365에 연결하려면 CrmServiceClient 클래스의 인스턴스를 만든 후 연결할 생성자 중 하나를 사용합니다.CrmServiceClient 클래스를 사용한 모든 Dynamics 365 호출은 스레드가 안전합니다.
이 주제에서 언급된 구축자와 상관 없이 CrmServiceClient와 함께 연결 문자열을 사용하여 Dynamics 365에 연결할 수도 있습니다.추가 정보:XRM 도구의 연결 문자열을 사용하여 Dynamics 365에 연결
이 항목의 내용
OrganizationServiceProxy를 사용하여 Dynamics 365에 연결
OrganizationWebProxyClient를 사용하여 Dynamics 365에 연결
Dynamics 365(온라인)(Office 365)에 연결
OAuth를 사용하여 Dynamics 365(온라인)(Office 365)에 접속
Dynamics 365 온-프레미스(Active Directory)에 연결
Dynamics 365 IFD(인터넷 연결 배포)에 연결
OAuth를 사용하여 Dynamics 365 IFD(인터넷 연결 배포)에 연결
Dynamics 365에 연결(클레임 기반)
연결 상태 확인
OrganizationServiceProxy를 사용하여 Dynamics 365에 연결
사용자 제공 OrganizationServiceProxy 인스턴스를 사용하여 다음 구축자를 이용하여 Dynamics 365에 연결하십시오.
CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceProxy>);
OrganizationWebProxyClient를 사용하여 Dynamics 365에 연결
사용자 제공 OrganizationWebProxyClient 인스턴스를 사용하여 다음 구축자를 이용하여 Dynamics 365에 연결하십시오. 이 구축자는 Microsoft Dynamics 365(온라인 및 온-프레미스)에 소개되어 있습니다.
CrmServiceClient crmSvc = new CrmServiceClient(<orgWebProxyClient>);
Dynamics 365(온라인)(Office 365)에 연결
다음 구축자를 이용하여 Office 365의 Dynamics 365(온라인) 인스턴스에 연결하십시오.
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>, isOffice365:true);
<CrmRegion> 파라미터의 유효한 값: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND 및 NorthAmerica2. 이것을 String.Empty으로 설정하면 Dynamics 365 조직을 위해 모든 지역의 서버를 검색할 것입니다.<OrgName> 매개 변수의 경우 고유하거나 친숙한 이름을 지정할 수 있습니다.
다음 파라미터는 옵션입니다: useUniqueInstance, useSsl 및 orgDetail.
OAuth를 사용하여 Dynamics 365(온라인)(Office 365)에 접속
다음 구축자를 이용하여 OAuth 프로토콜을 사용해 Office 365에서 Dynamics 365(온라인) 인스턴스에 연결하십시오.OAuth 지원은 Microsoft Dynamics 365(온라인 및 온-프레미스)에 도입되어 있습니다.
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, <orgDetail>,
<userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, <externalOrgWebProxyClient>, PromptBehavior.Auto);
이 구축자는 Microsoft Azure Active Directory Authentication Library (ADAL)를 사용하여 사용자를 인증합니다. 사용자 자격 증명(사용자 이름과 암호)이 지정되지 않은 경우, ADAL은 구축자에 지정된 PromptBehavior 파라미터(옵션)에 따라 자격 증명을 제공하도록 사용자에게 알립니다. ADAL은 OAuth 프로토콜을 이용하여 자격 증명을 인증하고, 액세스 권한을 취득하며 Azure Active Directory의 토큰을 새로 고침한 다음, 액세스 토큰을 사용하여 Dynamics 365에 요청합니다.
<CrmRegion> 파라미터의 유효한 값: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND 및 NorthAmerica2.String.Empty로 설정하면 Dynamics 365 조직의 모든 지역에 있는 서버를 검색합니다.<OrgName> 매개 변수의 경우 고유하거나 친숙한 이름을 지정할 수 있습니다.
Dynamics 365 온-프레미스(Active Directory)에 연결
다음 구축자를 이용하여 Active Directory 인증으로 온-프레미스 인스턴스에 접속하십시오.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.AD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);
지정한 도메인을 기반으로 Active Directory 인증을 실행합니다.<Server> 파라미터의 경우, Dynamics 365 서버의 호스트 이름을 지정하십시오, 예컨대 crmtest.<OrgName> 매개 변수의 경우 고유하거나 친숙한 이름을 지정할 수 있습니다.
다음 파라미터는 옵션입니다: useUniqueInstance, useSsl 및 orgDetail.
Dynamics 365 IFD(인터넷 연결 배포)에 연결
다음 구축자를 이용하여 의 Dynamics 365 IFD 인스턴스에 연결하십시오.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);
그러면 지정된 로컬 도메인에 근거하여 클레임 기반 인증이 실행됩니다.AD FS를 사용하는 고객에게 유용하며 Dynamics 365 서버를 클레임으로 구성하여 많은 사용자가 Dynamics 365 서버와 동일한 AD FS 도메인에 밀집됩니다.<Server> 파라미터의 경우, Dynamics 365 서버의 호스트 이름을 지정하십시오, 예컨대 crmtest.<OrgName> 매개 변수의 경우 고유하거나 친숙한 이름을 지정할 수 있습니다.
다음 파라미터는 옵션입니다: useUniqueInstance, useSsl 및 orgDetail.
OAuth를 사용하여 Dynamics 365 IFD(인터넷 연결 배포)에 연결
다음 구축자를 이용하여 Windows Server 2012 R2의 AD FS(Active Directory Federation Services)에서 OAuth 프로토콜을 사용해 Dynamics 365 IFD 인스턴스에 연결하십시오. 이 구축자가 작동하려면 Microsoft Dynamics 365 Server가 설치된 컴퓨터가 보안 토큰 서비스(STS)로 AD FS 2.2를 사용하도록 구성되어 있어야 합니다.Dynamics 365 IFD 인스턴스에 연결하기 위한 OAuth 지원은 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);
OAuth를 지원하는 애플리케이션을 위한 clientId 및 redirectUri 값이 IFD 서버에 등록되어 있어야 합니다.
사용자 자격 증명(사용자 이름과 암호)이 지정되지 않은 경우, ADAL은 구축자에 지정된 PromptBehavior 파라미터(옵션)에 따라 자격 증명을 제공하도록 사용자에게 알립니다. ADAL은 AD FS의 보안 토큰을 사용하여 사용자를 인증하고, 그 토큰을 사용하여 Dynamics 365에서 작업을 수행합니다.
Dynamics 365에 연결(클레임 기반)
다음 구축자를 이용하여 클레임 기반 인증을 사용하십시오.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");
그러면 지정된 홈 도메인에 근거하여 클레임 기반 인증이 실행됩니다.AD FS를 사용하는 고객에게 유용하며 Dynamics 365 서버를 클레임으로 구성하여 많은 사용자가 Dynamics 365 서버와 동일한 AD FS 도메인에 밀집됩니다.<Server> 파라미터의 경우, Dynamics 365 서버의 호스트 이름을 지정하십시오, 예컨대 crmtest.<OrgName> 매개 변수의 경우 고유하거나 친숙한 이름을 지정할 수 있습니다.
연결 상태 확인
연결 요청이 성공적이었는지 확인하려면 CrmServiceClient.IsReady 속성의 값을 확인합니다.참인 경우, 연결이 성공적이고 귀하는 작업할 준비가 된 것입니다. 그렇지 않으면 CrmServiceClient의 값을 체크하십시오. 연결 실패의 원인에 대한 LastCrmError 및 CrmServiceClient.LastCrmException 속성.
참고 항목
AuthenticationType
XRM 도구의 연결 문자열을 사용하여 Dynamics 365에 연결
XRM 도구에 PowerShell cmdlets를 사용하여 Dynamics 365에 연결
XRM 도구를 사용하여 Dynamics 365에서 작업 실행
샘플: Microsoft Dynamics 365용 빠른 시작
XRM 도구를 사용하여 클라이언트 응용 프로그램 빌드
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보