Compartilhar via

X509CertificateRecipientClientCredential.SetDefaultCertificate Método

  • Referência

Definição

Namespace:
System.ServiceModel.Security
Assembly:
System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.dll

Especifica o certificado padrão a ser usado para o serviço.

Sobrecargas

SetDefaultCertificate(String, StoreLocation, StoreName)

Especifica o certificado padrão a ser usado para o serviço. Para associações que usam a segurança de mensagens baseada em certificado, esse certificado é usado para criptografar mensagens para o serviço e deve ser usado pelo serviço para assinar respostas ao cliente.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Especifica o certificado padrão a ser usado para o serviço. Para associações que usam a segurança de mensagens baseada em certificado, esse certificado é usado para criptografar mensagens para o serviço e deve ser usado pelo serviço para assinar respostas ao cliente.

Comentários

Esses métodos obtêm um certificado do repositório no local especificado que corresponde aos parâmetros especificados.

Para associações que usam a segurança de mensagens baseada em certificado, esse certificado é usado para criptografar mensagens para o serviço e deve ser usado pelo serviço para assinar respostas ao cliente.

SetDefaultCertificate(String, StoreLocation, StoreName)

Especifica o certificado padrão a ser usado para o serviço. Para associações que usam a segurança de mensagens baseada em certificado, esse certificado é usado para criptografar mensagens para o serviço e deve ser usado pelo serviço para assinar respostas ao cliente.

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

Parâmetros

subjectName
String

O nome diferenciado da entidade.

storeLocation
StoreLocation

O local do repositório de certificados usado pelo serviço para obter o certificado de serviço.

storeName
StoreName

O nome do repositório de certificados X.509 a ser aberto.

Exceções

ArgumentNullException

subjectName é null.

InvalidOperationException

Tentativa de definir quando a credencial é somente leitura.

Exemplos

O código a seguir usa esse método para especificar um certificado X.509 a ser usado.

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

Comentários

Esse método obtém um certificado do repositório no local especificado que corresponde ao subjectName parâmetro.

Os valores são storeLocation incluídos na StoreLocation enumeração:

  • LocalMachine: o repositório de certificados atribuído ao computador local.

  • CurrentUser: o repositório de certificados usado pelo usuário atual (padrão).

Se o aplicativo estiver em execução em uma conta do sistema, o certificado normalmente estará .LocalMachine Se o aplicativo estiver em execução em uma conta de usuário, o certificado normalmente estará .CurrentUser

Os valores são storeName incluídos na StoreName enumeração.

Aplica-se a

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Especifica o certificado padrão a ser usado para o serviço. Para associações que usam a segurança de mensagens baseada em certificado, esse certificado é usado para criptografar mensagens para o serviço e deve ser usado pelo serviço para assinar respostas ao cliente.

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

Parâmetros

storeLocation
StoreLocation

O local do repositório de certificados usado pelo serviço para obter o certificado de serviço.

storeName
StoreName

O nome do repositório de certificados X.509 a ser aberto.

findType
X509FindType

O tipo de pesquisa de X.509 a ser executada.

findValue
Object

O valor a ser pesquisado no repositório de certificados X.509.

Exceções

ArgumentNullException

findValue é null.

InvalidOperationException

Tentativa de definir quando a credencial é somente leitura.

Exemplos

O código a seguir usa esse método para especificar um certificado X.509 a ser usado.

public void snippet22(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS");
}

Comentários

Esse método obtém um certificado do repositório no local especificado que corresponde aos parâmetros e findValue aos findType parâmetros.

Os valores são storeLocation incluídos na StoreLocation enumeração:

  • LocalMachine: o repositório de certificados atribuído ao computador local.

  • CurrentUser: o repositório de certificados usado pelo usuário atual (padrão).

Se o aplicativo estiver em execução em uma conta do sistema, o certificado normalmente estará .LocalMachine Se o aplicativo estiver em execução em uma conta de usuário, o certificado normalmente estará .CurrentUser

Os valores são storeName incluídos na StoreName enumeração.

Os valores são findType incluídos na X509FindType enumeração.

A enumeração mais usada é FindBySubjectName, que faz uma pesquisa que não diferencia maiúsculas de minúsculas sobre o nome do assunto dos certificados no repositório especificado. Pode ser uma pesquisa imprecisa. Se nenhum certificado ou vários certificados que correspondem aos critérios forem encontrados, um InvalidOperationException será gerado.

Aplica-se a