X509ClientCertificateAuthentication.IncludeWindowsGroups Propriété

Définition

Espace de noms:

System.ServiceModel.Security

Assembly:

System.ServiceModel.dll

Obtient ou affecte une valeur qui indique si les groupes Windows sont inclus dans le contexte d'autorisation.

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

public bool IncludeWindowsGroups { get; set; }

member this.IncludeWindowsGroups : bool with get, set

Public Property IncludeWindowsGroups As Boolean

Valeur de propriété

Boolean

true si les groupes Windows sont inclus dans le contexte d'autorisation ; sinon, false. La valeur par défaut est true.

Exemples

Le code suivant montre comment définir cette propriété.

// Create a service host.
Uri httpUri = new Uri("http://localhost/Calculator");
ServiceHost sh = new ServiceHost(typeof(Calculator), httpUri);
// Create a binding that uses a certificate.
WSHttpBinding b = new WSHttpBinding(SecurityMode.Message);
b.Security.Message.ClientCredentialType =
    MessageCredentialType.Certificate;

// 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 a certificate.
Dim b As New WSHttpBinding(SecurityMode.Message)
b.Security.Message.ClientCredentialType = MessageCredentialType.Certificate


' Get a reference to the authentication object.
Dim myAuthProperties As X509ClientCertificateAuthentication = _
sh.Credentials.ClientCertificate.Authentication
' Configure IncludeWindowsGroups.
myAuthProperties.IncludeWindowsGroups = True

Cette propriété peut également être définie dans un fichier de configuration.

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

Remarques

Cette propriété est valide uniquement lorsque la propriété MapClientCertificateToWindowsAccount a la valeur true.

Affectez la valeur false à cette propriété seulement si vous n'avez pas besoin d'établir la liste des groupes auxquels appartient un utilisateur. Ceci peut entraîner une amélioration des performances si vos décisions relatives à l'application et l'autorisation ne requièrent pas de groupes Windows.