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 utiliza para el servicio.
Sobrecargas
| SetDefaultCertificate(String, StoreLocation, StoreName) |
Especifica el certificado predeterminado que se utiliza para el servicio. Para los enlaces que utilizan la seguridad del mensaje basada en certificados, este certificado se utiliza para cifrar los mensajes del servicio y se espera que sea utilizado por el servicio para firmar las respuestas para el cliente. |
| SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object) |
Especifica el certificado predeterminado que se utiliza para el servicio. Para los enlaces que utilizan la seguridad del mensaje basada en certificados, este certificado se utiliza para cifrar los mensajes del servicio y se espera que sea utilizado por el servicio para firmar las respuestas para el cliente. |
Comentarios
Estos métodos reciben un certificado del almacén en la ubicación especificada que coincide con los parámetros especificados.
Para los enlaces que utilizan la seguridad del mensaje basada en certificados, este certificado se utiliza para cifrar los mensajes del servicio y se espera que sea utilizado por el servicio para firmar las respuestas para el cliente.
SetDefaultCertificate(String, StoreLocation, StoreName)
Especifica el certificado predeterminado que se utiliza para el servicio. Para los enlaces que utilizan la seguridad del mensaje basada en certificados, este certificado se utiliza para cifrar los mensajes del servicio y se espera que sea utilizado por el servicio para firmar las respuestas para el 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 asunto.
- storeLocation
- StoreLocation
La ubicación del almacén de certificados que el servicio utiliza para obtener el certificado del servicio.
- storeName
- StoreName
Obtiene el nombre del almacén de certificados X.509.
Excepciones
subjectName es null.
Se intentó establecer cuando la credencial es de solo lectura.
Ejemplos
El siguiente código utiliza este método para especificar el certificado X.509 que se va a utilizar.
public void snippet23(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate("http://fabrikam.com/sts",
StoreLocation.CurrentUser,
StoreName.TrustedPeople);
}
Comentarios
Este método recibe un certificado del almacén en la ubicación especificada que coincide con el parámetro subjectName.
Los valores para storeLocation están incluidos en la enumeración StoreLocation:
LocalMachine: el 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 está ejecutando bajo una cuenta del sistema, entonces el certificado está normalmente en LocalMachine. Si la aplicación se está ejecutando en una cuenta de usuario, entonces el certificado se encuentra normalmente en CurrentUser.
Los valores para storeName están incluidos en la enumeración StoreName.
Se aplica a
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)
Especifica el certificado predeterminado que se utiliza para el servicio. Para los enlaces que utilizan la seguridad del mensaje basada en certificados, este certificado se utiliza para cifrar los mensajes del servicio y se espera que sea utilizado por el servicio para firmar las respuestas para el 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
La ubicación del almacén de certificados que el servicio utiliza para obtener el certificado del servicio.
- storeName
- StoreName
Obtiene el nombre del almacén de certificados X.509.
- findType
- X509FindType
El tipo de búsqueda de X.509 que se va a ejecutar.
- findValue
- Object
El 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 siguiente código utiliza este método para especificar el certificado X.509 que se va a utilizar.
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 desde el almacén en la ubicación especificada que coincida con los parámetros findType y findValue.
Los valores para storeLocation están incluidos en la enumeración StoreLocation:
LocalMachine: el 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 está ejecutando bajo una cuenta del sistema, entonces el certificado está normalmente en LocalMachine. Si la aplicación se está ejecutando en una cuenta de usuario, entonces el certificado se encuentra normalmente en CurrentUser.
Los valores para storeName están incluidos en la enumeración StoreName.
Los valores para findType están incluidos en la enumeración X509FindType.
La enumeración normalmente utilizada es FindBySubjectName, que hace una búsqueda sin distinción entre mayúsculas y minúsculas en el nombre del asunto de certificados en el almacén especificado. Ésta puede ser una búsqueda imprecisa. Si ningún certificado o varios certifica que coinciden los criterios que se buscan, se produce InvalidOperationException.
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de