Edit

Share via


WebClientProtocol.PreAuthenticate Property

Definition

Gets or sets whether pre-authentication is enabled.

public:
 property bool PreAuthenticate { bool get(); void set(bool value); };
public bool PreAuthenticate { get; set; }
member this.PreAuthenticate : bool with get, set
Public Property PreAuthenticate As Boolean

Property Value

true to pre-authenticate the request; otherwise, false. The default is false.

Remarks

When a client requests a resource without using credentials, the server challenges the request and indicates what authentication schemes it supports. The client chooses an authentication scheme and sends the appropriate WWW-authenticate header to the server. When PreAuthenticate is true, the WWW-authenticate header is sent with all subsequent requests.

When PreAuthenticate is false, a request is made to the XML Web service method without initially attempting to authenticate the user. If the XML Web service allows anonymous access, then the XML Web service method is executed. If anonymous access is disallowed, a 401 HTTP return code is sent back to the client. In response, the WebClientProtocol class returns authentication credentials to the Web server. If the client is authenticated and subsequently authorized to access the XML Web service, the XML Web service method is executed; otherwise the client is denied access.

Applies to

See also