다음을 통해 공유

X509CertificateRecipientClientCredential.SetScopedCertificate 메서드

  • 참조

정의

네임스페이스:
System.ServiceModel.Security
어셈블리:
System.ServiceModel.Primitives.dll
어셈블리:
System.ServiceModel.dll

저장소로부터 인증서를 설정하고, 범위를 설정하는 URL에 의해 인덱싱된 컬렉션에 이를 저장합니다.

오버로드

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

주체 이름, 인증서 저장소 위치 및 인증서 저장소 이름별로 인증서를 설정하고, 범위를 설정하는 URL에 사용할 컬렉션에 이를 저장합니다.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

인증서 저장소 위치, 인증서 저장소 이름, X.509 검색 형식 및 검색할 값별로 인증서를 설정하고, 범위를 설정하는 URL에 사용할 컬렉션에 이를 저장합니다.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

주체 이름, 인증서 저장소 위치 및 인증서 저장소 이름별로 인증서를 설정하고, 범위를 설정하는 URL에 사용할 컬렉션에 이를 저장합니다.

public:
 void SetScopedCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, Uri ^ targetService);
public void SetScopedCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, Uri targetService);
member this.SetScopedCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * Uri -> unit
Public Sub SetScopedCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName, targetService As Uri)

매개 변수

subjectName
String

정규화된 주체 이름입니다.

storeLocation
StoreLocation

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

storeName
StoreName

열려는 X.509 인증서 저장소 이름입니다.

targetService
Uri

범위를 설정하는 URL입니다.

예외

ArgumentNullException

subjectName 또는 targetService가 null인 경우

InvalidOperationException

읽기 전용인 자격 증명을 설정하려고 한 경우

예제

이 코드는 이 메서드를 호출하는 방법을 보여줍니다.

public void snippet25(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetScopedCertificate("http://fabrikam.com/sts",
                             StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             new Uri("http://fabrikam.com"));
}

설명

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

  • LocalMachine: 로컬 컴퓨터에 할당된 인증서 저장소입니다.

  • CurrentUser: 현재 사용자가 사용하는 인증서 저장소(기본값)입니다.

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

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

적용 대상

SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

인증서 저장소 위치, 인증서 저장소 이름, X.509 검색 형식 및 검색할 값별로 인증서를 설정하고, 범위를 설정하는 URL에 사용할 컬렉션에 이를 저장합니다.

public:
 void SetScopedCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue, Uri ^ targetService);
public void SetScopedCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue, Uri targetService);
member this.SetScopedCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj * Uri -> unit
Public Sub SetScopedCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object, targetService As Uri)

매개 변수

storeLocation
StoreLocation

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

storeName
StoreName

열려는 X.509 인증서 저장소 이름입니다.

findType
X509FindType

실행할 X.509 검색의 유형입니다.

findValue
Object

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

targetService
Uri

범위를 설정하는 URL입니다.

예외

ArgumentNullException

findValue 또는 targetService가 null인 경우

InvalidOperationException

읽기 전용인 자격 증명을 설정하려고 한 경우

예제

이 코드는 이 메서드를 호출하는 방법을 보여줍니다.

public void snippet20(CalculatorClient client)
{
    X509CertificateRecipientClientCredential rcc = client.ClientCredentials.ServiceCertificate;
    rcc.SetScopedCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS",
                             new Uri("http://fabrikam.com/sts"));
}

rcc.SetScopedCertificate(StoreLocation.CurrentUser, _
            StoreName.TrustedPeople, _
            X509FindType.FindBySubjectName, _
            "FabrikamSTS", _
            New Uri("http://fabrikam.com/sts"))

설명

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

  • LocalMachine: 로컬 컴퓨터에 할당된 인증서 저장소입니다.

  • CurrentUser: 현재 사용자가 사용하는 인증서 저장소(기본값)입니다.

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

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

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

가장 일반적으로 사용되는 열거형은 지정된 저장소에서 인증서 주체 이름에 대해 대/소문자를 구분하지 않는 검색을 수행하는 FindBySubjectName입니다. 검색이 정확하지 않을 수 있습니다. 조건과 일치하는 인증서 또는 여러 인증서가 없으면 throw InvalidOperationException 됩니다.

적용 대상