org.eclipse.jetty.client.util

Class DigestAuthentication

java.lang.Object

org.eclipse.jetty.client.util.DigestAuthentication

All Implemented Interfaces:

Authentication

public class DigestAuthentication
extends Object
implements Authentication

Implementation of the HTTP "Digest" authentication defined in RFC 2617.

Applications should create objects of this class and add them to the AuthenticationStore retrieved from the HttpClient via HttpClient.getAuthenticationStore().

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.client.api.Authentication

Authentication.Result

Constructor Summary

Constructors

Constructor and Description
DigestAuthentication(URI uri, String realm, String user, String password)

Method Summary

Methods

Modifier and Type	Method and Description
Authentication.Result	authenticate(Request request, ContentResponse response, String wwwAuthenticate, Attributes context) Executes the authentication mechanism for the given request, returning a Authentication.Result that can be used to actually authenticate the request via Authentication.Result.apply(Request).
boolean	matches(String type, URI uri, String realm) Matches Authentications based on the given parameters

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DigestAuthentication

public DigestAuthentication(URI uri,
                    String realm,
                    String user,
                    String password)

Parameters:

uri - the URI to match for the authentication

realm - the realm to match for the authentication

user - the user that wants to authenticate

password - the password of the user

Method Detail

matches

public boolean matches(String type,
              URI uri,
              String realm)

Description copied from interface: Authentication

Matches Authentications based on the given parameters

Specified by:

matches in interface Authentication

Parameters:

type - the Authentication type such as "Basic" or "Digest"

uri - the request URI

realm - the authentication realm as provided in the WWW-Authenticate response header

Returns:

true if this authentication matches, false otherwise

authenticate

public Authentication.Result authenticate(Request request,
                                 ContentResponse response,
                                 String wwwAuthenticate,
                                 Attributes context)

Description copied from interface: Authentication

Executes the authentication mechanism for the given request, returning a Authentication.Result that can be used to actually authenticate the request via Authentication.Result.apply(Request).

If a request for "/secure" returns a Authentication.Result, then the result may be used for other requests such as "/secure/foo" or "/secure/bar", unless those resources are protected by other realms.

Specified by:

authenticate in interface Authentication

Parameters:

request - the request to execute the authentication mechanism for

response - the 401 response obtained in the previous attempt to request the protected resource

wwwAuthenticate - the WWW-Authenticate header chosen for this authentication (among the many that the response may contain)

context - the conversation context in case the authentication needs multiple exchanges to be completed and information needs to be stored across exchanges

Returns:

the authentication result, or null if the authentication could not be performed