ClientWindowsAuthenticationMembershipProvider Classe
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.
Ativa a Windows authentication com serviços de aplicação cliente.
public ref class ClientWindowsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider
public class ClientWindowsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider
type ClientWindowsAuthenticationMembershipProvider = class
inherit MembershipProvider
Public Class ClientWindowsAuthenticationMembershipProvider
Inherits MembershipProvider
- Herança
Exemplos
O código de exemplo seguinte demonstra como usar este método para autenticar um utilizador através do Windows authentication. Neste exemplo, o valor da staticMembership.Provider propriedade é atribuído a uma ClientWindowsAuthenticationMembershipProvider instância. Isto garante que será lançado um NullReferenceException código se testar este código acidentalmente usando outro fornecedor de subscrição.
private bool ValidateUsingWindowsAuthentication()
{
ClientWindowsAuthenticationMembershipProvider authProvider =
System.Web.Security.Membership.Provider as
ClientWindowsAuthenticationMembershipProvider;
// Call ValidateUser and pass null values for the parameters.
// This call always returns true.
return authProvider.ValidateUser(null, null);
}
Private Function ValidateUsingWindowsAuthentication() As Boolean
Dim authProvider As ClientWindowsAuthenticationMembershipProvider = _
CType(System.Web.Security.Membership.Provider, _
ClientWindowsAuthenticationMembershipProvider)
' Call ValidateUser and pass Nothing for the parameters.
' This call always returns true.
Return authProvider.ValidateUser(Nothing, Nothing)
End Function
Observações
Pode usar serviços de aplicação cliente para validar utilizadores através da Windows authentication. Para ativar Windows authentication, configura a sua aplicação para usar a classe ClientWindowsAuthenticationMembershipProvider.
Após a configuração, pode validar os utilizadores chamando o staticMembership.ValidateUser método. O Membership.ValidateUser método chama internamente o ValidateUser método.
O ClientWindowsAuthenticationMembershipProvider.ValidateUser método autentica automaticamente o utilizador atual e define a staticThread.CurrentPrincipal propriedade para um ClientRolePrincipal objeto que contém o atual WindowsIdentity. Se a ClientRoleProvider estiver configurado para a sua aplicação, pode usar o ClientRolePrincipal objeto para recuperar informações de papéis de utilizador do serviço de papéis.
Pode obter uma referência à instância atual ClientWindowsAuthenticationMembershipProvider através da staticMembership.Provider propriedade. Pode usar a referência do fornecedor de membros para ligar diretamente ao ClientWindowsAuthenticationMembershipProvider.ValidateUser método. Além disso, vai precisar da referência do fornecedor de membros para ligar ao Logout método, que não está disponível na MembershipProvider classe base.
Construtores
| Name | Description |
|---|---|
| ClientWindowsAuthenticationMembershipProvider() |
Inicializa uma nova instância da ClientWindowsAuthenticationMembershipProvider classe. |
Propriedades
| Name | Description |
|---|---|
| ApplicationName |
Esta propriedade não é utilizada por esta classe. |
| Description |
Recebe uma descrição breve e amigável, adequada para exibição em ferramentas administrativas ou outras interfaces de utilizador (UIs). (Herdado de ProviderBase) |
| EnablePasswordReset |
Esta propriedade não é utilizada por esta classe. |
| EnablePasswordRetrieval |
Esta propriedade não é utilizada por esta classe. |
| MaxInvalidPasswordAttempts |
Esta propriedade não é utilizada por esta classe. |
| MinRequiredNonAlphanumericCharacters |
Esta propriedade não é utilizada por esta classe. |
| MinRequiredPasswordLength |
Esta propriedade não é utilizada por esta classe. |
| Name |
Recebe o nome amigável usado para se referir ao fornecedor durante a configuração. (Herdado de ProviderBase) |
| PasswordAttemptWindow |
Esta propriedade não é utilizada por esta classe. |
| PasswordFormat |
Esta propriedade não é utilizada por esta classe. |
| PasswordStrengthRegularExpression |
Esta propriedade não é utilizada por esta classe. |
| RequiresQuestionAndAnswer |
Esta propriedade não é utilizada por esta classe. |
| RequiresUniqueEmail |
Esta propriedade não é utilizada por esta classe. |
Métodos
| Name | Description |
|---|---|
| ChangePassword(String, String, String) |
Este método não é utilizado por esta classe. |
| ChangePasswordQuestionAndAnswer(String, String, String, String) |
Este método não é utilizado por esta classe. |
| CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
Este método não é utilizado por esta classe. |
| DecryptPassword(Byte[]) |
Desencripta uma palavra-passe encriptada. (Herdado de MembershipProvider) |
| DeleteUser(String, Boolean) |
Este método não é utilizado por esta classe. |
| EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) |
Encripta a palavra-passe especificada usando o modo de compatibilidade de palavra-passe especificado. (Herdado de MembershipProvider) |
| EncryptPassword(Byte[]) |
Encripta uma palavra-passe. (Herdado de MembershipProvider) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindUsersByEmail(String, Int32, Int32, Int32) |
Este método não é utilizado por esta classe. |
| FindUsersByName(String, Int32, Int32, Int32) |
Este método não é utilizado por esta classe. |
| GetAllUsers(Int32, Int32, Int32) |
Este método não é utilizado por esta classe. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetNumberOfUsersOnline() |
Este método não é utilizado por esta classe. |
| GetPassword(String, String) |
Este método não é utilizado por esta classe. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUser(Object, Boolean) |
Este método não é utilizado por esta classe. |
| GetUser(String, Boolean) |
Este método não é utilizado por esta classe. |
| GetUserNameByEmail(String) |
Este método não é utilizado por esta classe. |
| Initialize(String, NameValueCollection) |
Inicializa o construtor de configuração. (Herdado de ProviderBase) |
| Logout() |
Faz logout do utilizador. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnValidatingPassword(ValidatePasswordEventArgs) |
Levanta o ValidatingPassword evento se um gestor de eventos tiver sido definido. (Herdado de MembershipProvider) |
| ResetPassword(String, String) |
Este método não é utilizado por esta classe. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| UnlockUser(String) |
Este método não é utilizado por esta classe. |
| UpdateUser(MembershipUser) |
Este método não é utilizado por esta classe. |
| ValidateUser(String, String) |
Autentica automaticamente o utilizador atual usando a identidade fornecida pelo sistema operativo. |
evento
| Name | Description |
|---|---|
| ValidatingPassword |
Ocorre quando um utilizador é criado, uma palavra-passe é alterada ou uma palavra-passe é redefinida. (Herdado de MembershipProvider) |