Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
public interface AuthScheme
Method Summary | |
String |
|
String |
|
String |
|
String |
|
String |
|
String |
|
boolean |
|
boolean |
|
void |
|
public String authenticate(Credentials credentials, String method, String uri) throws AuthenticationException
Deprecated. Use
authenticate(Credentials,HttpMethod)
Produces an authorization string for the given set ofCredentials
, method name and URI using the given authentication scheme in response to the actual authorization challenge.
- Parameters:
credentials
- The set of credentials to be used for athenticationmethod
- The name of the method that requires authorization. This parameter may be ignored, if it is irrelevant or not applicable to the given authentication schemeuri
- The URI for which authorization is needed. This parameter may be ignored, if it is irrelevant or not applicable to the given authentication scheme
- Returns:
- the authorization string
- Throws:
AuthenticationException
- if authorization string cannot be generated due to an authentication failure
- See Also:
HttpMethod.getName()
,HttpMethod.getPath()
public String authenticate(Credentials credentials, HttpMethod method) throws AuthenticationException
Produces an authorization string for the given set ofCredentials
.
- Parameters:
credentials
- The set of credentials to be used for athenticationmethod
- The method being authenticated
- Returns:
- the authorization string
- Throws:
AuthenticationException
- if authorization string cannot be generated due to an authentication failure
- Since:
- 3.0
public String getID()
Deprecated. no longer used
Returns a String identifying the authentication challenge. This is used, in combination with the host and port to determine if authorization has already been attempted or not. Schemes which require multiple requests to complete the authentication should return a different value for each stage in the request. Additionally, the ID should take into account any changes to the authentication challenge and return a different value when appropriate. For example when the realm changes in basic authentication it should be considered a different authentication attempt and a different value should be returned.
- Returns:
- String a String identifying the authentication challenge. The returned value may be null.
public String getParameter(String name)
Returns authentication parameter with the given name, if available.
- Parameters:
name
- The name of the parameter to be returned
- Returns:
- the parameter with the given name
public String getRealm()
Returns authentication realm. If the concept of an authentication realm is not applicable to the given authentication scheme, returnsnull
.
- Returns:
- the authentication realm
public String getSchemeName()
Returns textual designation of the given authentication scheme.
- Returns:
- the name of the given authentication scheme
public boolean isComplete()
Authentication process may involve a series of challenge-response exchanges. This method tests if the authorization process has been completed, either successfully or unsuccessfully, that is, all the required authorization challenges have been processed in their entirety.
- Returns:
- true if the authentication process has been completed, false otherwise.
- Since:
- 3.0
public boolean isConnectionBased()
Tests if the authentication scheme is provides authorization on a per connection basis instead of usual per request basis
- Returns:
- true if the scheme is connection based, false if the scheme is request based.
- Since:
- 3.0
public void processChallenge(String challenge) throws MalformedChallengeException
Processes the given challenge token. Some authentication schemes may involve multiple challenge-response exchanges. Such schemes must be able to maintain the state information when dealing with sequential challenges
- Parameters:
challenge
- the challenge string
- Since:
- 3.0