X509CertificateInitiatorClientCredential.SetCertificate 메서드

참조

정의

네임스페이스:: System.ServiceModel.Security

어셈블리:: System.ServiceModel.Primitives.dll

어셈블리:: System.ServiceModel.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

서비스를 나타내는 데 사용할 인증서를 지정합니다.

오버로드

SetCertificate(String, StoreLocation, StoreName)	주체 고유 이름을 지정함으로써 서비스를 나타내는 데 사용할 인증서를 지정할 수 있습니다.
SetCertificate(StoreLocation, StoreName, X509FindType, Object)	`storeLocation`, `storeName`, `findType` 및 `findValue`와 같은 쿼리 매개 변수를 지정함으로써 클라이언트를 나타내는 데 사용할 인증서를 지정할 수 있습니다.

SetCertificate(String, StoreLocation, StoreName)

주체 고유 이름을 지정함으로써 서비스를 나타내는 데 사용할 인증서를 지정할 수 있습니다.

public:
 void SetCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);

public void SetCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);

member this.SetCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unit

Public Sub SetCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)

매개 변수

subjectName: String

주체 고유 이름입니다.

storeLocation: StoreLocation

서비스 인증서를 가져오기 위해 서비스에서 사용하는 인증서 저장소의 위치입니다.

storeName: StoreName

열려는 X.509 인증서 저장소의 이름을 지정합니다.

예제

다음 코드는 사용할 인증서를 지정합니다.

// Create a WSHttpBinding and set its security properties. The
// security mode is Message, and the client is authenticated with
// a certificate.
EndpointAddress ea = new EndpointAddress("http://contoso.com/");
WSHttpBinding b = new WSHttpBinding();
b.Security.Mode = SecurityMode.Message;
b.Security.Message.ClientCredentialType =
    MessageCredentialType.Certificate;

// Create the client with the binding and EndpointAddress.
CalculatorClient cc = new CalculatorClient(b, ea);

// Set the client credential value to a valid certificate.
cc.ClientCredentials.ClientCertificate.SetCertificate(
    "CN=MyName, OU=MyOrgUnit, C=US",
    StoreLocation.CurrentUser,
    StoreName.TrustedPeople);

설명

subjectName 매개 변수에 대한 자세한 내용은 SubjectName을 참조하십시오.

storeLocation 값은 StoreLocation 열거형에 포함되어 있습니다.

LocalMachine: 로컬 컴퓨터에 할당된 인증서 저장소입니다(기본값).
CurrentUser: 현재 사용자가 사용하는 인증서 저장소입니다.

시스템 계정으로 클라이언트 애플리케이션을 실행하는 경우 인증서는 대개 LocalMachine에 있습니다. 사용자 계정으로 클라이언트 애플리케이션을 실행하는 경우 인증서는 대개 CurrentUser에 있습니다.

storeName 값은 StoreName 열거형에 포함되어 있습니다.

적용 대상

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

storeLocation, storeName, findType 및 findValue와 같은 쿼리 매개 변수를 지정함으로써 클라이언트를 나타내는 데 사용할 인증서를 지정할 수 있습니다.

public:
 void SetCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);

public void SetCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);

member this.SetCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unit

Public Sub SetCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)

매개 변수

storeLocation: StoreLocation

클라이언트 인증서를 가져오기 위해 클라이언트가 사용하는 인증서 저장소의 위치입니다.

storeName: StoreName

열려는 X.509 인증서 저장소의 이름을 지정합니다.

findType: X509FindType

실행할 X.509 검색의 유형을 정의합니다.

findValue: Object

X.509 인증서 저장소에서 검색할 값입니다.

예제

다음 코드는 사용할 인증서를 지정합니다.

// Create a WSHttpBinding and set its security properties. The
// security mode is Message, and the client is authenticated with
// a certificate.
EndpointAddress ea = new EndpointAddress("http://contoso.com/");
WSHttpBinding b = new WSHttpBinding();
b.Security.Mode = SecurityMode.Message;
b.Security.Message.ClientCredentialType =
    MessageCredentialType.Certificate;

// Create the client with the binding and EndpointAddress.
CalculatorClient cc = new CalculatorClient(b, ea);

// Set the client credential value to a valid certificate.
cc.ClientCredentials.ClientCertificate.SetCertificate(
    StoreLocation.CurrentUser,
    StoreName.TrustedPeople,
    X509FindType.FindBySubjectName,
    "client.com");

' Create a WSHttpBinding and set its security properties. The
' security mode is Message, and the client is authenticated with 
' a certificate.
Dim ea As New EndpointAddress("http://contoso.com/")
Dim b As New WSHttpBinding()
b.Security.Mode = SecurityMode.Message
b.Security.Message.ClientCredentialType = MessageCredentialType.Certificate

' Create the client with the binding and EndpointAddress.
Dim cc As New CalculatorClient(b, ea)

' Set the client credential value to a valid certificate.
cc.ClientCredentials.ClientCertificate.SetCertificate( _
   StoreLocation.CurrentUser, _
   StoreName.TrustedPeople, _
   X509FindType.FindBySubjectName, _
   "client.com")

설명

storeLocation 값은 StoreLocation 열거형에 포함되어 있습니다.

LocalMachine: 로컬 컴퓨터에 할당된 인증서 저장소입니다(기본값).
CurrentUser: 현재 사용자가 사용하는 인증서 저장소입니다.

storeName 값은 StoreName 열거형에 포함되어 있습니다.

findType 값은 X509FindType 열거형에 포함되어 있습니다.

가장 일반적으로 사용되는 열거형은 지정된 저장소에서 인증서 주체 이름에 대해 대/소문자를 구분하지 않는 검색을 수행하는 FindBySubjectName입니다. 검색이 정확하지 않을 수 있습니다. 둘 이상의 인증서가 반환될 경우 찾은 항목과 일치하는 첫 번째 항목이 클라이언트를 나타내는 데 사용됩니다.

적용 대상

다음을 통해 공유

X509CertificateInitiatorClientCredential.SetCertificate 메서드

정의

오버로드

SetCertificate(String, StoreLocation, StoreName)

매개 변수

예제

설명

적용 대상

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

매개 변수

예제

설명

적용 대상

추가 리소스