Interface AuthenticationProvider
- All Known Implementing Classes:
ContainerBasedAuthenticationProvider
,HttpBasicAuthenticationProvider
,OAuth2AuthenticationProvider
public interface AuthenticationProvider
A provider to handle the authentication of
HttpServletRequest
s.
May implement a specific authentication scheme.- Author:
- Thorben Lindhauer
-
Method Summary
Modifier and TypeMethodDescriptionvoid
augmentResponseByAuthenticationChallenge
(javax.servlet.http.HttpServletResponse response, ProcessEngine engine) Callback to add an authentication challenge to the response to the client.extractAuthenticatedUser
(javax.servlet.http.HttpServletRequest request, ProcessEngine engine) Checks the request for authentication.
-
Method Details
-
extractAuthenticatedUser
AuthenticationResult extractAuthenticatedUser(javax.servlet.http.HttpServletRequest request, ProcessEngine engine) Checks the request for authentication. May not return null, but always anAuthenticationResult
that indicates, whether authentication was successful, and, if true, always provides the authenticated user. The result can only be successful if a valid user id was provided in the request. It is not required to provide the group or tenant id, as they will be resolved via theIdentityService
(e.g.ProcessEngineAuthenticationFilter.setAuthenticatedUser(org.camunda.bpm.engine.ProcessEngine, java.lang.String, java.util.List<java.lang.String>, java.util.List<java.lang.String>)
).- Parameters:
request
- the request to authenticateengine
- the process engine the request addresses. May be used to authenticate against the engine's identity service.
-
augmentResponseByAuthenticationChallenge
void augmentResponseByAuthenticationChallenge(javax.servlet.http.HttpServletResponse response, ProcessEngine engine) Callback to add an authentication challenge to the response to the client. Called in case of unsuccessful authentication.
For example, a Http Basic auth implementation may set the WWW-Authenticate header to
Basic realm="engine name"
.- Parameters:
response
- the response to augmentengine
- the process engine the request addressed. May be considered as an authentication realm to create a specific authentication challenge
-