org.apache.cxf.transport.http.auth
Interface HttpAuthSupplier

All Known Implementing Classes:

DefaultBasicAuthSupplier, DigestAuthSupplier, SpnegoAuthSupplier

public interface HttpAuthSupplier

Supplies Authorization information to an HTTPConduit.

A HTTPConduit keeps a reference to this HttpAuthSupplier for the life of the HTTPConduit, unless changed out by dynamic configuration. Therefore, an implementation of this HttpAuthSupplier may maintain state for subsequent calls.

For instance, an implementation may not provide a Authorization preemptively for a particular URL and decide to get the realm information from a 401 response in which the HTTPConduit will call getAuthorization for that URL. Then this implementation may provide the Authorization for this particular URL preemptively for subsequent calls to getAuthorization.

requiresRequestCaching

boolean requiresRequestCaching()

If the supplier requires the request to be cached to be resent, return true

getAuthorization

String getAuthorization(AuthorizationPolicy authPolicy,
                        URI url,
                        Message message,
                        String fullHeader)

The HTTPConduit makes a call to this method to obtain an Authentication token for http authentication.

Parameters:

authPolicy - credentials for the authentication

uri - The URI we want to connect to

message - The CXF Message

fullHeader - The full WWW-Authenticate header or null if preemptive auth

Returns:

token for Authenticate string or null if authentication is not possible