X509CertificateRecipientClientCredential.SetDefaultCertificate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica el certificado predeterminado que se va a usar para el servicio.
Sobrecargas
| Nombre | Description |
|---|---|
| SetDefaultCertificate(String, StoreLocation, StoreName) |
Especifica el certificado predeterminado que se va a usar para el servicio. En el caso de los enlaces que usan la seguridad de mensajes basada en certificados, este certificado se usa para cifrar los mensajes en el servicio y se espera que el servicio use para firmar respuestas al cliente. |
| SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object) |
Especifica el certificado predeterminado que se va a usar para el servicio. En el caso de los enlaces que usan la seguridad de mensajes basada en certificados, este certificado se usa para cifrar los mensajes en el servicio y se espera que el servicio use para firmar respuestas al cliente. |
Comentarios
Estos métodos obtienen un certificado del almacén en la ubicación especificada que coincide con los parámetros especificados.
En el caso de los enlaces que usan la seguridad de mensajes basada en certificados, este certificado se usa para cifrar los mensajes en el servicio y se espera que el servicio use para firmar respuestas al cliente.
SetDefaultCertificate(String, StoreLocation, StoreName)
Especifica el certificado predeterminado que se va a usar para el servicio. En el caso de los enlaces que usan la seguridad de mensajes basada en certificados, este certificado se usa para cifrar los mensajes en el servicio y se espera que el servicio use para firmar respuestas al 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 -> unitPublic Sub SetDefaultCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)Parámetros
- subjectName
- String
Nombre distintivo del firmante.
- storeLocation
- StoreLocation
Ubicación del almacén de certificados que usa el servicio para obtener el certificado de servicio.
- storeName
- StoreName
Nombre del almacén de certificados X.509 que se va a abrir.
Excepciones
subjectName es null.
Se intentó establecer cuando la credencial es de solo lectura.
Ejemplos
El código siguiente usa este método para especificar un certificado X.509 que se va a usar.
public void snippet23(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate("http://fabrikam.com/sts",
StoreLocation.CurrentUser,
StoreName.TrustedPeople);
}
Comentarios
Este método obtiene un certificado del almacén en la ubicación especificada que coincide con el subjectName parámetro .
Los valores de storeLocation se incluyen en la StoreLocation enumeración:
LocalMachine: almacén de certificados asignado al equipo local.
CurrentUser: el almacén de certificados usado por el usuario actual (valor predeterminado).
Si la aplicación se ejecuta en una cuenta del sistema, el certificado suele estar en LocalMachine. Si la aplicación se ejecuta en una cuenta de usuario, el certificado suele estar en CurrentUser.
Los valores de storeName se incluyen en la StoreName enumeración .
Se aplica a
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)
Especifica el certificado predeterminado que se va a usar para el servicio. En el caso de los enlaces que usan la seguridad de mensajes basada en certificados, este certificado se usa para cifrar los mensajes en el servicio y se espera que el servicio use para firmar respuestas al 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 -> unitPublic Sub SetDefaultCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)Parámetros
- storeLocation
- StoreLocation
Ubicación del almacén de certificados que usa el servicio para obtener el certificado de servicio.
- storeName
- StoreName
Nombre del almacén de certificados X.509 que se va a abrir.
- findType
- X509FindType
Tipo de búsqueda X.509 que se va a ejecutar.
- findValue
- Object
Valor que se va a buscar en el almacén de certificados X.509.
Excepciones
findValue es null.
Se intentó establecer cuando la credencial es de solo lectura.
Ejemplos
El código siguiente usa este método para especificar un certificado X.509 que se va a usar.
public void snippet22(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
StoreName.TrustedPeople,
X509FindType.FindBySubjectName,
"FabrikamSTS");
}
Comentarios
Este método obtiene un certificado del almacén en la ubicación especificada que coincide con los findType parámetros y findValue .
Los valores de storeLocation se incluyen en la StoreLocation enumeración:
LocalMachine: almacén de certificados asignado al equipo local.
CurrentUser: el almacén de certificados usado por el usuario actual (valor predeterminado).
Si la aplicación se ejecuta en una cuenta del sistema, el certificado suele estar en LocalMachine. Si la aplicación se ejecuta en una cuenta de usuario, el certificado suele estar en CurrentUser.
Los valores de storeName se incluyen en la StoreName enumeración .
Los valores de findType se incluyen en la X509FindType enumeración .
La enumeración más usada es FindBySubjectName, que realiza una búsqueda sin distinción entre mayúsculas y minúsculas en el nombre del firmante de los certificados en el almacén especificado. Puede ser una búsqueda imprecisa. Si no se encuentran certificados ni varios certificados que coincidan con los criterios, se produce una InvalidOperationException excepción .
