AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Método
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í.
Precaución
The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.
Autentica previamente una solicitud.
public:
static System::Net::Authorization ^ PreAuthenticate(System::Net::WebRequest ^ request, System::Net::ICredentials ^ credentials);
public static System.Net.Authorization? PreAuthenticate(System.Net.WebRequest request, System.Net.ICredentials credentials);
[System.Obsolete("The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.", DiagnosticId="SYSLIB0009", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.Authorization? PreAuthenticate(System.Net.WebRequest request, System.Net.ICredentials credentials);
public static System.Net.Authorization PreAuthenticate(System.Net.WebRequest request, System.Net.ICredentials credentials);
static member PreAuthenticate : System.Net.WebRequest * System.Net.ICredentials -> System.Net.Authorization
[<System.Obsolete("The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.", DiagnosticId="SYSLIB0009", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member PreAuthenticate : System.Net.WebRequest * System.Net.ICredentials -> System.Net.Authorization
Public Shared Function PreAuthenticate (request As WebRequest, credentials As ICredentials) As Authorization
Parámetros
- request
- WebRequest
Solicitud a un recurso de Internet.
- credentials
- ICredentials
Credenciales asociadas a la solicitud.
Devoluciones
Instancia de la Authorization clase si la solicitud se puede autenticar previamente; de lo contrario, null. Si credentials es null, este método devuelve null.
- Atributos
Excepciones
Solo .NET Core y .NET 5+: en todos los casos.
request es null.
Comentarios
Si el módulo de autenticación puede autenticar previamente la solicitud, el PreAuthenticate método devuelve una instancia de autenticación y envía la información de autorización al servidor de forma preventiva en lugar de esperar a que el recurso emita un desafío. Este comportamiento se describe en la sección 3.3 de RFC 2617 (Autenticación HTTP: Autenticación HTTP: Autenticación básica y implícita de acceso). Los módulos de autenticación que admiten la autenticación previa permiten a los clientes mejorar la eficacia del servidor evitando viajes de ida y vuelta adicionales causados por desafíos de autenticación.
Los módulos de autorización que pueden autenticar previamente las solicitudes establecen la IAuthenticationModule.CanPreAuthenticate propiedad en true.