Compartilhar via


X509CertificateInitiatorServiceCredential.SetCertificate Método

Definição

Define o certificado a ser usado para criptografar mensagens enviadas ao cliente pelo serviço. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem MutualCertificateDuplex.

Sobrecargas

SetCertificate(String, StoreLocation, StoreName)

Permite que você especifique o certificado a ser usado para criptografar mensagens para o cliente especificando o nome diferenciado da entidade. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem MutualCertificateDuplex.

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

Especifica o certificado a ser usado para criptografar mensagens para o cliente. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem MutualCertificateDuplex.

SetCertificate(String, StoreLocation, StoreName)

Permite que você especifique o certificado a ser usado para criptografar mensagens para o cliente especificando o nome diferenciado da entidade. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem MutualCertificateDuplex.

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)

Parâmetros

subjectName
String

O nome diferenciado da entidade.

storeLocation
StoreLocation

O local do repositório de certificados que o serviço usa para obter o certificado.

storeName
StoreName

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

Exemplos

O código a seguir mostra como usar esse método para definir o certificado.

Comentários

Para saber mais sobre o parâmetro subjectName, confira SubjectName.

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

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

  • CurrentUser: o repositório de certificados usado pelo usuário atual.

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

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

Aplica-se a

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

Especifica o certificado a ser usado para criptografar mensagens para o cliente. Essa configuração é usada somente por associações que estão configuradas com o modo de autenticação de segurança de mensagem MutualCertificateDuplex.

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)

Parâmetros

storeLocation
StoreLocation

O local do repositório de certificados que o serviço usa para obter o certificado.

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.

Exemplos

O código a seguir mostra como usar esse método para definir o certificado.

Comentários

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

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

  • CurrentUser: o repositório de certificados usado pelo usuário atual.

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

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

Os valores de findType são 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 no nome da entidade dos certificados no repositório especificado. Essa 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