다음을 통해 공유

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>
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입니다.

  • AD 및 IFD는 Dynamics 365 온-프레미스 인스턴스에 대해서만 허용됩니다.

  • OAuth는 Dynamics 365(온라인) 온-프레미스 인스턴스에 대해서만 허용됩니다.

  • Office365는 Dynamics 365(온라인) 인스턴스에 대해서만 허용됩니다.

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

자격 증명이 제공되지 않았을 때 자격 증명을 요구할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • Always: 항상 사용자 자격 증명을 지정하라는 메시지가 나타납니다.

  • Auto: 로그인 컨트롤 인터페이스에 프롬프트를 표시할지 여부를 선택할 수 있도록 합니다.

  • Never: 사용자 자격 증명을 지정하라는 메시지를 표시하지 않습니다. 연결 메서드를 사용할 때 사용자 인터페이스가 없다면 이 값을 사용해야 합니다.

이 매개 변수는 인증 유형이 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. 저작권 정보