java.lang.Object
com.sun.net.httpserver.Authenticator
- Direct Known Subclasses:
BasicAuthenticator
Authenticator represents an implementation of an HTTP authentication
mechanism. Sub-classes provide implementations of specific mechanisms
such as Digest or Basic auth. Instances are invoked to provide verification
of the authentication information provided in all incoming requests.
Note. This implies that any caching of credentials or other authentication
information must be done outside of this class.
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Indicates an authentication failure.static class
Base class for return type fromauthenticate(HttpExchange)
method.static class
Indicates an authentication must be retried.static class
Indicates an authentication has succeeded and the authenticated user principal can be acquired by callingAuthenticator.Success.getPrincipal()
. -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionabstract Authenticator.Result
authenticate
(HttpExchange exch) Called to authenticate each incoming request.
-
Constructor Details
-
Authenticator
protected Authenticator()Constructor for subclasses to call.
-
-
Method Details
-
authenticate
Called to authenticate each incoming request. The implementation must return aAuthenticator.Failure
,Authenticator.Success
orAuthenticator.Retry
object as appropriate:-
Failure
means the authentication has completed, but has failed due to invalid credentials. -
Success
means that the authentication has succeeded, and aPrincipal
object representing the user can be retrieved by callingAuthenticator.Success.getPrincipal()
. -
Retry
means that another HTTP exchange is required. Any response headers needing to be sent back to the client are set in the givenHttpExchange
. The response code to be returned must be provided in theRetry
object.Retry
may occur multiple times.
- Parameters:
exch
- theHttpExchange
upon which authenticate is called- Returns:
- the result
-
-