X509ClientCertificateAuthentication.MapClientCertificateToWindowsAccount Propiedad
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í.
Obtiene o establece un valor que indica si el certificado está asignado a las cuentas de Windows.
public:
property bool MapClientCertificateToWindowsAccount { bool get(); void set(bool value); };public bool MapClientCertificateToWindowsAccount { get; set; }member this.MapClientCertificateToWindowsAccount : bool with get, setPublic Property MapClientCertificateToWindowsAccount As BooleanValor de propiedad
true si el certificado está asignado a las cuentas de Windows; de lo contrario, false. De manera predeterminada, es false.
Excepciones
set cuando la credencial es de solo lectura.
Ejemplos
El código siguiente muestra cómo establecer esta propiedad.
// Create a service host.
Uri httpUri = new Uri("http://localhost/Calculator");
ServiceHost sh = new ServiceHost(typeof(Calculator), httpUri);
// Create a binding that uses Windows security.
WSHttpBinding b = new WSHttpBinding(SecurityMode.Message);
b.Security.Message.ClientCredentialType = MessageCredentialType.Windows;
// Get a reference to the authentication object.
X509ClientCertificateAuthentication myAuthProperties =
sh.Credentials.ClientCertificate.Authentication;
// Configure IncludeWindowsGroups.
myAuthProperties.IncludeWindowsGroups = true;
' Create a service host.
Dim httpUri As New Uri("http://localhost/Calculator")
Dim sh As New ServiceHost(GetType(Calculator), httpUri)
' Create a binding that uses Windows security.
Dim b As New WSHttpBinding(SecurityMode.Message)
b.Security.Message.ClientCredentialType = MessageCredentialType.Windows
' Get a reference to the authentication object.
Dim myAuthProperties As X509ClientCertificateAuthentication = _
sh.Credentials.ClientCertificate.Authentication
' Configure IncludeWindowsGroups.
myAuthProperties.IncludeWindowsGroups = True
La propiedad también puede establecerse en un archivo de configuración.
<serviceCredentials>
<clientCertificate>
<authentication mapClientCertificateToWindowsAccount='true'/>
</clientCertificate>
</serviceCredentials>
Comentarios
Al utilizar el certificado del tipo de credencial del cliente en los enlaces, el certificado no está asignado a las cuentas de Windows. Puede invalidar este comportamiento mediante esta propiedad. Cuando esta propiedad está establecida como true, produce que la identidad del certificado de cliente se asigne a una cuenta de Windows.