AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) 메서드

정의

네임스페이스:

System.Net

어셈블리:

System.Net.Requests.dll

Source:

AuthenticationManager.cs

주의

The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.

요청을 사전 인증합니다.

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);

[<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

매개 변수

request

WebRequest

인터넷 리소스에 대한 요청입니다.

credentials

ICredentials

요청과 연결된 자격 증명입니다.

반환

Authorization

요청을 사전 인증할 수 있으면, Authorization 클래스의 인스턴스이고, 그렇지 않으면 null입니다. credentials이(가) null이면 이 메서드는 null을(를) 반환합니다.

특성

ObsoleteAttribute

예외

PlatformNotSupportedException

.NET Core 및 .NET 5+ 전용: 모든 경우

ArgumentNullException

request은 null입니다.

설명

인증 모듈이 요청을 미리 인증할 수 있는 경우 메서드는 PreAuthenticate 인증 인스턴스를 반환하고 리소스가 챌린지를 실행할 때까지 기다리는 대신 인증 정보를 서버에 선제적으로 보냅니다. 이 동작은 RFC 2617의 섹션 3.3(HTTP 인증: 기본 및 다이제스트 액세스 인증)에 설명되어 있습니다. 사전 인증을 지원하는 인증 모듈을 사용하면 클라이언트가 인증 문제로 인한 추가 왕복을 방지하여 서버 효율성을 향상시킬 수 있습니다.

요청을 미리 인증할 수 있는 권한 부여 모듈은 속성을 true로 IAuthenticationModule.CanPreAuthenticate 설정합니다.