X509ClientCertificateAuthentication.MapClientCertificateToWindowsAccount Proprietà

Definizione

Spazio dei nomi:

System.ServiceModel.Security

Assembly:

System.ServiceModel.dll

Ottiene o imposta un valore che indica se del certificato viene mappato agli account di Windows.

public:
 property bool MapClientCertificateToWindowsAccount { bool get(); void set(bool value); };

public bool MapClientCertificateToWindowsAccount { get; set; }

member this.MapClientCertificateToWindowsAccount : bool with get, set

Public Property MapClientCertificateToWindowsAccount As Boolean

Valore della proprietà

Boolean

true se del certificato viene mappato agli account di Windows. In caso contrario, false. Il valore predefinito è false.

Eccezioni

InvalidOperationException

Eseguire l'operazione set quando la credenziale è di sola lettura.

Esempio

Nel codice seguente viene mostrato come impostare questa proprietà.

// 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

È anche possibile impostare la proprietà in un file di configurazione.

<serviceCredentials>  
  <clientCertificate>  
     <authentication mapClientCertificateToWindowsAccount='true'/>  
  </clientCertificate>  
</serviceCredentials>  

Commenti

Quando si utilizza il tipo di credenziale client di certificato sulle associazioni, il certificato non viene mappato agli account di Windows. È possibile eseguire l'override di questo comportamento utilizzando questa proprietà. Quando questa proprietà viene impostata su true, l'identità dal certificato client viene mappata a un account di Windows.