org.apache.pulsar.broker.authentication

Interface AuthenticationProvider

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

AuthenticationProviderBasic, AuthenticationProviderList, AuthenticationProviderTls, AuthenticationProviderToken

public interface AuthenticationProvider
extends Closeable

Provider of authentication mechanism

Method Summary

Modifier and Type	Method and Description
default String	authenticate(AuthenticationDataSource authData) Validate the authentication for the given credentials with the specified authentication data.
default boolean	authenticateHttpRequest(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Set response, according to passed in request.
String	getAuthMethodName()
void	initialize(ServiceConfiguration config) Perform initialization for the authentication provider
default AuthenticationState	newAuthState(org.apache.pulsar.common.api.AuthData authData, SocketAddress remoteAddress, SSLSession sslSession) Create an authentication data State use passed in AuthenticationDataSource.

Methods inherited from interface java.io.Closeable

close

Method Detail

initialize

void initialize(ServiceConfiguration config)
         throws IOException

Perform initialization for the authentication provider

Parameters:

config - broker config object

Throws:

IOException - if the initialization fails

getAuthMethodName

String getAuthMethodName()

Returns:

the authentication method name supported by this provider

authenticate

default String authenticate(AuthenticationDataSource authData)
                     throws AuthenticationException

Validate the authentication for the given credentials with the specified authentication data. This method is useful in one stage authn, if you're not doing one stage or if you're providing your own state implementation for one stage authn, it should throw an exception.

Parameters:

authData - provider specific authentication data

Returns:

the "role" string for the authenticated connection, if the authentication was successful

Throws:

AuthenticationException - if the credentials are not valid

newAuthState

default AuthenticationState newAuthState(org.apache.pulsar.common.api.AuthData authData,
                                         SocketAddress remoteAddress,
                                         SSLSession sslSession)
                                  throws AuthenticationException

Create an authentication data State use passed in AuthenticationDataSource.

Throws:

AuthenticationException

authenticateHttpRequest

default boolean authenticateHttpRequest(javax.servlet.http.HttpServletRequest request,
                                        javax.servlet.http.HttpServletResponse response)
                                 throws Exception

Set response, according to passed in request. and return whether we should do following chain.doFilter or not.

Throws:

Exception