XRM 도구의 연결 문자열을 사용하여 Dynamics 365에 연결
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Microsoft Dynamics 365(온라인 및 온-프레미스)을 사용하면 연결 문자열을 사용하여 XRM 도구로 Dynamics 365 인스턴스에 연결할 수 있습니다. 이것은 Microsoft SQL Server에 사용되는 연결 문자열의 개념과 비슷합니다. 연결 문자열은 최대한의 보안을 위해 구성 섹션을 암호화할 수 있는 기능을 포함하여 구성 파일에서 기본적인 지원을 제공합니다. 연결 문자열을 사용하면 배포 시 Dynamics 365 연결을 구성할 수 있고, 응용 프로그램에서 Dynamics 365 인스턴스에 어렵지 않게 연결할 수 있습니다.
이 항목의 내용
연결 문자열 만들기
연결 문자열 매개 변수
연결 문자열 예제
연결 상태 확인
연결 문자열 만들기
다음 예제와 같이 프로젝트에 대한 app.config 또는 web.config 파일에 연결 문자열을 지정합니다.
<connectionStrings>
<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
</connectionStrings>
.jpeg "System_CAPS_security") 보안 참고 |
|---|
app.config 또는 web.config 파일에 중요한 정보를 추가할 경우 정보를 보호하도록 계정 암호와 같은 적절한 보안 예방 조치를 취해야 합니다. |
연결 문자열을 만든 후 이를 CrmServiceClient 개체를 만드는 데 사용할 수 있습니다.
//Use the connection string named "MyCRMServer"
//from the configuration file
CrmServiceClient crmSvc = new CrmServiceClient(ConfigurationManager.ConnectionStrings["MyCRMServer"].ConnectionString);
참고
코드의 연결 문자열(using System.Configuration;)에 액세스 하려면 코드의 다음 using 지시문을 사용하여 System.Configuration 네임스페이스를 참조해야 합니다.
CrmServiceClient 개체를 만든 다음 개체를 사용하여 Dynamics 365에서 작업을 수행할 수 있습니다.추가 정보:XRM 도구를 사용하여 Dynamics 365에서 작업 실행
연결 문자열 매개 변수
연결 문자열에는 세미콜론으로 구분하는 일련의 이름=값 쌍이 담겨 있습니다. 다음 표에는 임의의 순서로 입력할 수 있는 지원되는 매개 변수가 나와 있습니다.
매개 변수 이름 |
설명 |
|---|---|
ServiceUri, Service Uri, Url, or Server |
Microsoft Dynamics 365 Server의 URL을 지정합니다. URL은 http 또는 https 프로토콜을 사용할 수 있으며 포트는 선택 사항입니다. 기본 포트는 http 프로토콜의 경우 80, https 프로토콜의 경우 443입니다. 서버 URL은 일반적으로 Dynamics 365 온-프레미스에 대해 http://crm-server:port/조직-이름 및 https://조직-이름형식입니다.Dynamics 365(온라인)에 대해 crm.dynamics.com입니다. '조직-이름'은 필수 항목입니다. 연결할 조직에 원하는 고유 이름을 지정할 수 있습니다. 예: http://contoso/test, http://contoso:5555/test, https://contoso/test, https://test.crm.dynamics.com , 또는 http://10.10.10.2/test. |
Domain |
사용자 자격 증명을 확인하는 도메인을 지정합니다. |
UserName, User Name, UserId, or User Id |
자격 증명에 연결된 사용자의 ID 이름을 지정합니다. |
Password |
자격 증명에 연결된 사용자 이름의 암호를 지정합니다. |
HomeRealmUri 또는 홈 영역 URI |
홈 영역 URI를 지정합니다. |
AuthenticationType 또는 AuthType |
Dynamics 365 인스턴스에 연결하는 인증 형식을 지정합니다. 유효한 값은 AD, IFD(AD FS 사용), OAuth, 또는 Office365입니다.
|
RequireNewInstance |
연결이 계속 활성일 때 다시 호출하면 기존 연결을 재사용할지 여부를 지정합니다. 기본값은 false이며 기존 연결이 다시 사용됩니다.true로 설정하면 시스템에서 고유한 연결을 만듭니다. |
ClientId, AppId 또는 ApplicationId |
응용 프로그램을 Microsoft Azure Active Directory 또는 Active Directory Federation Services(AD FS)에 등록할 때 할당된 ClientID를 지정합니다. 이 매개 변수는 인증 유형이 OAuth로 지정될 때만 적용할 수 있습니다. |
RedirectUri 또는 ReplyUrl |
Microsoft Azure Active Directory 또는 Active Directory Federation Services(AD FS)에 등록한 응용 프로그램의 리디렉션 URI를 지정합니다. 이 매개 변수는 인증 유형이 OAuth로 지정될 때만 적용할 수 있습니다. |
TokenCacheStorePath |
사용자 토큰 캐시를 저장할 위치에 대한 전체 경로를 지정합니다. 실행 중인 프로세스는 지정된 경로에 액세스할 수 있어야 합니다. 이 경로를 설정하고 구성하는 것은 프로세스 책임입니다. 이 매개 변수는 인증 유형이 OAuth로 지정될 때만 적용할 수 있습니다. |
LoginPrompt |
자격 증명이 제공되지 않았을 때 자격 증명을 요구할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
이 매개 변수는 인증 유형이 OAuth로 지정될 때만 적용할 수 있습니다. |
연결 문자열 예제
다음 예제는 다양한 배포 및 인증 시나리오에 대해 연결 문자열을 사용하는 방법을 보여줍니다.
통합 온-프레미스 인증
<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
온-프레미스 인증을 사용하여 명명된 계정
<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test; Domain=CONTOSO; Username=jsmith; Password=passcode" />
Office 365를 사용하여 명명된 계정
<add name="MyCRMServer" connectionString="AuthType=Office365;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso.crm.dynamics.com"/>
인증 요청을 위해 UX를 사용하는 Office 365에서 명명된 계정을 사용한 OAuth
<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"/>
인증 요청을 위해 UX를 사용하는 Dynamics 365 온-프레미스에서 명명된 계정을 사용한 OAuth
<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
<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" />
연결 상태 확인
연결 요청이 성공적이었는지 확인하려면 CrmServiceClient.IsReady 속성의 값을 확인합니다.참인 경우, 연결이 성공적이고 귀하는 작업할 준비가 된 것입니다. 그렇지 않으면 연결 오류 원인에 대해 CrmServiceClient. LastCrmError 및 CrmServiceClient.LastCrmException 속성의 값을 확인합니다.
참고 항목
CrmServiceClient
XRM 도구를 사용하여 클라이언트 응용 프로그램 빌드
CrmServiceClient 구축자를 사용하여 Dynamics 365에 연결
XRM 도구를 사용하여 Dynamics 365에서 작업 실행
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보