AuthenticationService Clase
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í.
Permite el acceso a la autenticación de formularios de ASP.NET como servicio Web.
public ref class AuthenticationService
[System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)]
[System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")]
[System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")]
public class AuthenticationService
[<System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)>]
[<System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")>]
[<System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")>]
type AuthenticationService = class
Public Class AuthenticationService
- Herencia
-
AuthenticationService
- Atributos
Comentarios
El AuthenticationService objeto permite autenticar a los usuarios a través de un servicio de Windows Communication Foundation (WCF). El servicio de autenticación WCF se usa cuando debe autenticar a los usuarios a través de ASP.NET pertenencia de una aplicación que está fuera de la aplicación web que almacena las credenciales de usuario. La aplicación debe poder enviar y consumir mensajes en el formato SOAP. A través de la AuthenticationService clase , puede iniciar la sesión de los usuarios, cerrar la sesión de los usuarios, validar las credenciales, comprobar el estado de autenticación, personalizar la autenticación y establecer la cookie de autenticación.
La AuthenticationService clase contiene cuatro métodos a los que solo debe tener acceso a través de un servicio WCF: los IsLoggedInmétodos , Login, Logouty ValidateUser . Para llamar a estos métodos, habilite el servicio de autenticación en un servidor web y, a continuación, conecte una aplicación cliente compatible con WCF al servicio web. Para obtener información sobre cómo configurar el servicio de autenticación, vea How to: Enable the WCF Authentication Service.
Para iniciar la sesión de los usuarios, pase las credenciales de usuario al Login método . Si las credenciales son válidas, la AuthenticationService clase crea una cookie de autenticación. Si la cookie de autenticación no ha expirado, sabe que las credenciales del usuario se han autenticado y no tiene que volver a validar las credenciales. (La autenticación sin cookies no está disponible a través de la AuthenticationService clase ).
AuthenticationService puede generar dos eventos: Authenticating y CreatingCookie. El Authenticating evento se produce cuando se validan las credenciales de usuario. Cree un controlador de eventos para el Authenticating evento para personalizar cómo se validan las credenciales de usuario. El CreatingCookie evento se produce cuando se establece la cookie de autenticación después de validar las credenciales de usuario. Cree un controlador de eventos para el CreatingCookie evento para personalizar la cookie de autenticación.
El ValidateUser método comprueba las credenciales de usuario para la autenticación, pero no devuelve un vale de autenticación. Use ValidateUser cuando un usuario haya iniciado sesión anteriormente y debe comprobar que las credenciales siguen siendo válidas al principio de una nueva sesión de aplicación.
Para obtener un ejemplo del uso del servicio de autenticación WCF desde una aplicación de consola, vea Walkthrough: Using ASP.NET Application Services.
Constructores
AuthenticationService() |
Inicializa una nueva instancia de la clase AuthenticationService. |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
IsLoggedIn() |
Determina si el usuario actual está autenticado. |
Login(String, String, String, Boolean) |
Comprueba las credenciales del usuario y crea un vale de autenticación (cookie) si las credenciales son válidas. |
Logout() |
Borra el vale de autenticación (cookie) en el explorador. |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
ValidateUser(String, String, String) |
Autentica las credenciales del usuario sin emitir un vale de autenticación. |
Eventos
Authenticating |
Se produce cuando se validan las credenciales del usuario. |
CreatingCookie |
Se produce cuando se establece la cookie de autenticación. |