Microsoft Dynamics CRM 2015에 대한 간단한 연결
게시 날짜: 2016년 11월
적용 대상: Dynamics CRM 2015
Microsoft Dynamics CRM 2015 및 Microsoft Dynamics CRM Online 2015 업데이트에 대한 개발자 확장은 연결 문자열의 개념을 사용하여 Microsoft Dynamics 365 서버에 연결합니다. 이것은 Microsoft SQL Server에 사용되는 연결 문자열의 개념과 비슷합니다. 연결 문자열은 ADO.NET 프레임워크의 자연스러운 부분이고, 최대한의 보안을 위해 구성 섹션을 암호화할 수 있는 기능을 포함하여 구성 파일에서 기본적인 지원을 제공합니다. 따라서 Microsoft Dynamics 365 연결이 배포 시간에 구성되고 응용 프로그램에서 하드 코딩되지 않는 강력한 모델을 사용할 수 있습니다.Microsoft Dynamics 365에 대한 개발자 확장의 모든 API는 이 항목에 나와 있는 것처럼 서버에 연결하기 위해 연결 문자를 사용하는 CrmOrganizationServiceContext 클래스에서 내부적으로 사용되는 CrmConnection 개체를 사용합니다.
프로젝트에 대한 app.config 또는 web.config 파일에 다음 예제와 같이 이 연결 문자열을 제공합니다.
<connectionStrings>
<add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>
.jpeg "System_CAPS_security") 보안 참고 |
|---|
app.config 또는 web.config 파일에 중요한 정보를 추가할 경우 정보를 보호하도록 계정 암호와 같은 적절한 보안 예방 조치를 취해야 합니다. |
이 항목의 내용
연결 문자열 만들기
연결 문자열 매개 변수
연결 문자열 예제
연결 문자열 만들기
연결 문자열은 CrmConnection 개체를 인스턴스화하는 데 사용되며 결과적으로 OrganizationService 개체 또는 CrmOrganizationServiceContext 개체를 인스턴스화하는 데 사용할 수 있습니다.
//Use the Microsoft Dynamics CRM Online connection string from the app.config file named "CRMOnline".
var connection = new CrmConnection("CRMOnline");
var service = new OrganizationService(connection);
var context = new CrmOrganizationServiceContext(connection);
app.config 파일 및 생성된 인라인과 별개로 CrmConnection을 다음과 같이 만들 수도 있습니다.
var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");
연결 문자열 매개 변수
연결 문자열의 기본 형식은 OLEDB 연결 문자열과 같습니다. 세미콜론으로 구분된 일련의 이름/값 쌍입니다. 다음 표에는 임의의 순서로 입력할 수 있는 지원되는 매개 변수가 나와 있습니다.
매개 변수 이름 |
설명 |
|---|---|
Server, Url, or Service Uri |
Microsoft Dynamics 365 서버의 URL을 지정합니다. URL은 http 또는 https일 수 있으며 포트 80을 통한 http 또는 포트 443을 통한 https일 경우 포트는 선택 사항입니다. 서버 URL은 일반적으로 http:// crm-server: port/organization-name 형식이거나 Microsoft Dynamics CRM Online의 경우 https:// organization-name.crm.dynamics.com입니다. 조직 이름이 필요합니다. |
Domain |
사용자 자격 증명을 확인하는 도메인을 지정합니다. |
Username or User ID |
자격 증명에 연결된 사용자의 ID 이름을 지정합니다. |
Password |
자격 증명에 연결된 사용자 이름의 암호를 지정합니다. |
Device ID or Device User Name |
사용자 정의 Microsoft 계정 장치 ID를 지정합니다. 비어 있지 않은 문자열일 수 있습니다. 이 장치 ID는 인증을 처음 실행할 때 장치 암호에 등록됩니다. 장치 ID와 암호가 이전에 등록된 값과 일치하지 않으면 인증에 실패합니다. 장치 ID는 CRM Online에만 적용됩니다. |
Device Password |
사용자 정의 Microsoft 계정 장치 암호를 지정합니다. 최소 여섯 자 이상이어야 합니다. 이 암호는 인증을 처음 실행할 때 장치 ID에 등록됩니다. 장치 ID와 암호가 이전에 등록된 값과 일치하지 않으면 인증에 실패합니다. 장치 암호는 CRM Online에만 적용됩니다. |
Timeout |
OrganizationServiceProxy 클래스의 Timeout 속성에 전달됩니다. |
Home Realm Uri |
OrganizationServiceProxy 클래스의 HomeRealmUri 속성에 전달됩니다. |
프록시 유형 활성화됨 |
기본적으로 True입니다. 이 매개 변수는 OrganizationService를 활성화하여 기본 Entity 유형 대신 프록시 유형을 반환합니다. |
Proxy Types Assembly |
Microsoft.Xrm.Client.CodeGeneration 확장으로 CrmSvcUtil.exe 도구를 사용하여 생성된 Microsoft Dynamics 365에서 프록시 유형이 포함된 어셈블리를 지정합니다. |
Caller ID |
OrganizationServiceProxy 클래스의 CallerId 속성에 전달됩니다. |
Service Configuration Instance Mode |
Static, PerName, PerRequest 또는 PerInstance로 설정할 수 있습니다.PerName 은 기본값입니다. IServiceConfiguration<TService>는 OrganizationService에 대해 만들어지는 횟수를 최적화하여 각 연결 문자열에 대해 하나씩만 만들어집니다. 가능한 다른 값에 대한 자세한 내용은 instanceMode 특성 지정을 참조하십시오. |
User Token Expiry Window |
새로운 사용자 토큰을 검색할 때 오프셋으로 사용되는 hh:mm:ss 형식의 TimeSpan을 지정합니다. 예를 들어 이 매개 변수가 "00:10:00"으로 설정된 경우 실제로 토큰이 만료되기 전에 새로운 사용자 토큰은 10분 검색됩니다. |
연결 문자열 예제
다음 예제에서는 통합된 온-프레미스 인증을 사용하는 연결 문자열을 보여 줍니다.
Url=http://crm.contoso.com/xrmContoso;
다음 예제에서는 Active Directory 인증을 사용하는 연결 문자열을 보여 줍니다.
Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode
다음 예제에서는 Microsoft Dynamics CRM Online에 연결하기 위해 Microsoft 계정를 사용하는 연결 문자열을 보여 줍니다.
Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode
다음 예제에서는 Microsoft Dynamics CRM Online에 연결하기 위해 Microsoft Online Services를 사용하는 연결 문자열을 보여 줍니다.
Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode;
참고 항목
샘플: Microsoft Dynamics CRM을 사용하여 간소화된 연결 빠른 시작
Microsoft Dynamics CRM 2015용 개발자 확장
코드 생성 도구 확장을 사용하여 코드 생성(Dynamics CRM 2015)
Dynamics CRM 2015용 포털 연습
© 2017 Microsoft. All rights reserved. 저작권 정보