클라이언트 연결의 SPN(서비스 사용자 이름)(OLE DB)

아티클
05/07/2013

이 항목에서는 클라이언트 응용 프로그램의 SPN(서비스 사용자 이름)을 지원하는 OLE DB 속성 및 멤버 함수에 대해 설명합니다. 클라이언트 응용 프로그램의 SPN에 대한 자세한 내용은 클라이언트 연결의 SPN(서비스 사용자 이름) 지원을 참조하십시오. 예제의 경우 통합 Kerberos 인증(OLE DB)을 참조하십시오.

공급자 초기화 문자열 키워드

다음과 같은 공급자 초기화 문자열 키워드가 OLE DB 응용 프로그램에서 SPN을 지원합니다. 다음 표에서 키워드 열의 값은 IDBInitialize::Initialize의 공급자 문자열에 사용됩니다. 설명 열의 값은 ADO 또는 IDataInitialize::GetDataSource를 사용하여 연결할 때 초기화 문자열에 사용됩니다.

키워드	설명	값
ServerSPN	서버 SPN	서버의 SPN입니다. 기본값인 빈 문자열을 지정하면 SQL Server Native Client는 공급자가 생성한 기본 SPN을 사용합니다.
FailoverPartnerSPN	장애 조치(Failover) 파트너 SPN	장애 조치(Failover) 파트너의 SPN입니다. 기본값인 빈 문자열을 지정하면 SQL Server Native Client는 공급자가 생성한 기본 SPN을 사용합니다.

데이터 원본 초기화 속성

DBPROPSET_SQLSERVERDBINIT 속성 집합의 다음 속성을 사용하여 응용 프로그램에서 SPN을 지정할 수 있습니다.

이름	유형	사용법
SSPROP_INIT_SERVERSPN	VT_BSTR, 읽기/쓰기	서버의 SPN을 지정합니다. 기본값인 빈 문자열을 지정하면 SQL Server Native Client는 공급자가 생성한 기본 SPN을 사용합니다.
SSPROP_INIT_FAILOVERPARTNERSPN	VT_BSTR, 읽기/쓰기	장애 조치(Failover) 파트너의 SPN을 지정합니다. 기본값인 빈 문자열을 지정하면 SQL Server Native Client는 공급자가 생성한 기본 SPN을 사용합니다.

데이터 원본 속성

DBPROPSET_SQLSERVERDATASOURCEINFO 속성 집합의 다음 속성을 사용하여 응용 프로그램에서 인증 방법을 검색할 수 있습니다.

이름	유형	사용법
SSPROP_INTEGRATEDAUTHENTICATIONMETHOD	VT_BSTR, 읽기 전용	연결에 사용된 인증 방법을 반환합니다. 응용 프로그램에 반환되는 값은 Windows에서 SQL Server Native Client에 반환하는 값입니다. 다음은 가능한 값입니다. NTLM 인증을 사용하여 연결을 열 때 반환되는 "NTLM" Kerberos 인증을 사용하여 연결을 열 때 반환되는 "Kerberos" 연결이 열려 있지만 인증 방법을 확인할 수 없는 경우에는 VT_EMPTY가 반환됩니다. 이 속성은 데이터 원본이 초기화된 경우에만 읽을 수 있습니다. 데이터 원본이 초기화되기 전에 이 속성을 읽으려고 하면 IDBProperties::GetProperies에서 DB_S_ERRORSOCCURRED 또는 DB_E_ERRORSOCCURRED가 반환되고 이 속성의 DBPROPSET_PROPERTIESINERROR에 DBPROPSTATUS_NOTSUPPORTED가 설정됩니다. 이 동작은 OLE DB 핵심 사양을 따르는 것입니다.
SSPROP_MUTUALLYAUTHENICATED	VT_BOOL, 읽기 전용	연결의 서버가 상호 인증되었으면 VARIANT_TRUE가 반환되고, 그렇지 않으면 VARIANT_FALSE가 반환됩니다. 이 속성은 데이터 원본이 초기화된 경우에만 읽을 수 있습니다. 데이터 원본이 초기화되기 전에 이 속성을 읽으려고 하면 IDBProperties::GetProperies에서 DB_S_ERRORSOCCURRED 또는 DB_E_ERRORSOCCURRED가 반환되고 해당하는 경우 이 속성의 DBPROPSET_PROPERTIESINERROR에 DBPROPSTATUS_NOTSUPPORTED가 설정됩니다. 이 동작은 OLE DB 핵심 사양을 따르는 것입니다. Windows 인증을 사용하지 않은 연결에 대해 이 특성을 쿼리하면 VARIANT_FALSE가 반환됩니다.

SSPROP_INTEGRATEDAUTHENTICATIONMETHOD

VT_BSTR, 읽기 전용

연결에 사용된 인증 방법을 반환합니다. 응용 프로그램에 반환되는 값은 Windows에서 SQL Server Native Client에 반환하는 값입니다. 다음은 가능한 값입니다.

NTLM 인증을 사용하여 연결을 열 때 반환되는 "NTLM"
Kerberos 인증을 사용하여 연결을 열 때 반환되는 "Kerberos"

연결이 열려 있지만 인증 방법을 확인할 수 없는 경우에는 VT_EMPTY가 반환됩니다.

이 속성은 데이터 원본이 초기화된 경우에만 읽을 수 있습니다. 데이터 원본이 초기화되기 전에 이 속성을 읽으려고 하면 IDBProperties::GetProperies에서 DB_S_ERRORSOCCURRED 또는 DB_E_ERRORSOCCURRED가 반환되고 이 속성의 DBPROPSET_PROPERTIESINERROR에 DBPROPSTATUS_NOTSUPPORTED가 설정됩니다. 이 동작은 OLE DB 핵심 사양을 따르는 것입니다.

SSPROP_MUTUALLYAUTHENICATED

VT_BOOL, 읽기 전용

연결의 서버가 상호 인증되었으면 VARIANT_TRUE가 반환되고, 그렇지 않으면 VARIANT_FALSE가 반환됩니다.

이 속성은 데이터 원본이 초기화된 경우에만 읽을 수 있습니다. 데이터 원본이 초기화되기 전에 이 속성을 읽으려고 하면 IDBProperties::GetProperies에서 DB_S_ERRORSOCCURRED 또는 DB_E_ERRORSOCCURRED가 반환되고 해당하는 경우 이 속성의 DBPROPSET_PROPERTIESINERROR에 DBPROPSTATUS_NOTSUPPORTED가 설정됩니다. 이 동작은 OLE DB 핵심 사양을 따르는 것입니다.

Windows 인증을 사용하지 않은 연결에 대해 이 특성을 쿼리하면 VARIANT_FALSE가 반환됩니다.

SPN에 대한 OLE DB API 지원

다음 표에서는 클라이언트 연결에서 SPN을 지원하는 OLE DB 멤버 함수에 대해 설명합니다.

멤버 함수	설명
IDataInitialize::GetDataSource	pwszInitializationString에는 새 키워드인 ServerSPN 및 FailoverPartnerSPN이 포함될 수 있습니다.
IDataInitialize::GetInitializationString	SSPROP_INIT_SERVERSPN 및 SSPROP_INIT_FAILOVERPARTNERSPN이 기본값이 아닌 경우 ppwszInitString을 통해 ServerSPN 및 FailoverPartnerSPN에 대한 키워드 값으로 초기화 문자열에 포함됩니다. 기본값인 경우에는 초기화 문자열에 포함되지 않습니다.
IDBInitialize::Initialize	데이터 원본 초기화 속성에서 DBPROP_INIT_PROMPT를 설정하여 프롬프트를 활성화한 경우 OLE DB 로그인 대화 상자가 표시됩니다. 이를 통해 주 서버 및 해당 장애 조치(Failover) 파트너 모두에 대한 SPN이 입력되도록 할 수 있습니다. DPPROP_INIT_PROVIDERSTRING에 공급자 문자열이 설정되어 있으면 해당 문자열이 새 키워드인 ServerSPN과 FailoverPartnerSPN을 인식하고 해당 값을 사용하여(있는 경우) SSPROP_INIT_SERVER_SPN 및 SSPROP_INIT_FAILOVER_PARTNER_SPN을 초기화합니다. IDBInitialize::Initialize를 호출하기 전에 IDBProperties::SetProperties를 호출하여 SSPROP_INIT_SERVER_SPN 및 SSPROP_INIT_FAILOVER_PARTNER_SPN 속성을 설정할 수 있습니다. 이 방법을 공급자 문자열 대신 사용할 수 있습니다. 두 곳 이상에서 속성이 설정된 경우 프로그래밍 방식으로 설정된 값이 공급자 문자열에 설정된 값보다 우선적으로 적용됩니다. 초기화 문자열에 설정된 값은 로그인 대화 상자에서 설정된 값보다 우선적으로 적용됩니다. 공급자 문자열에서 동일한 키워드가 여러 번 나타나는 경우 가장 먼저 발견된 값이 우선적으로 적용됩니다.
IDBProperties::GetProperties	IDBProperties::GetProperties를 호출하여 새 데이터 원본 초기화 속성 SSPROP_INIT_SERVERSPN 및 SSPROP_INIT_FAILOVERPARTNERSPN의 값과 새 데이터 원본 속성 SSPROP_AUTHENTICATIONMETHOD 및 SSPROP_MUTUALLYAUTHENTICATED의 값을 가져올 수 있습니다.
IDBProperties::GetPropertyInfo	IdbProperties::GetPropertyInfo에는 새 데이터 원본 초기화 속성 SSPROP_INIT_SERVERSPN 및 SSPROP_INIT_FAILOVERPARTNERSPN이나 새 데이터 원본 속성 SSPROP_AUTHENTICATION_METHOD 및 SSPROP_MUTUALLYAUTHENTICATED가 포함됩니다.
IDBProperties::SetProperties	IDBProperties::SetProperties를 호출하여 새 데이터 원본 초기화 속성 SSPROP_INITSERVERSPN 및 SSPROP_INIT_FAILOVERPARTNERSPN의 값을 설정할 수 있습니다. 언제라도 이러한 속성을 설정할 수 있지만 데이터 원본이 열려 있는 경우에는 "DB_E_ERRORSOCCURRED, "여러 단계 OLE DB 작업을 하는 동안 오류가 발생했습니다. 각 OLE DB 상태 값이 있으면 확인해 보십시오. 완료된 작업이 없습니다.""라는 오류가 반환됩니다.

참고 항목

개념

SQL Server Native Client(OLE DB)