X509ClientCertificateAuthentication.IncludeWindowsGroups Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se os grupos do Windows estão incluídos no contexto de autorização.
public:
property bool IncludeWindowsGroups { bool get(); void set(bool value); };public bool IncludeWindowsGroups { get; set; }member this.IncludeWindowsGroups : bool with get, setPublic Property IncludeWindowsGroups As BooleanValor de Propriedade
true se Windows grupos estiverem incluídos no contexto de autorização; caso contrário, false. A predefinição é true.
Exemplos
O código seguinte mostra como definir esta propriedade.
// 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
A propriedade também pode ser definida num ficheiro de configuração.
<serviceCredentials>
<clientCertificate>
<authentication includeWindowsGroups ='true'/>
</clientCertificate>
</serviceCredentials>
Observações
Esta propriedade é válida apenas quando a MapClientCertificateToWindowsAccount propriedade está definida como true.
Defina esta propriedade para false apenas se não precisar de estabelecer a lista de grupos a que um utilizador pertence – isto pode resultar num benefício de desempenho se as suas decisões de aplicação e autorização não exigirem Windows grupos.
