Package pl.edu.icm.unity.engine.api.endpoint

Interface BindingAuthn

All Known Subinterfaces:
CredentialRetrieval
All Known Implementing Classes:
AbstractCredentialRetrieval
public interface BindingAuthn
Interface defining binding specific API (e.g. for Vaadin Web interface or CXF WS) which must be implemented to plug an authentication to the binding. Nearly marker - the real functionality will be available in extensions.

This interface is separate from the

invalid reference 
CredentialRetrieval
to provide an endpoint-only view on a credential retrieval (what is needed by the endpoint to get authN results from an authenticator). The
invalid reference 
CredentialRetrieval
is an extension with methods used by the engine to initialize the instance. The implementations will implement a binding specific interface (extension of this interface and the
invalid reference 
CredentialRetrieval
.

IMPORTANT: The implementation MUST be thread safe by being immutable. Perfectly - stateless. This is because a single instance of the retrieval of the implemented type will be created per retrieval configuration defined in the system. And this retrieval can be used in many places. If binding-specific contract requires stateful credential retrieval (e.g. by providing a UI) this must be achieved by using factory method(s) in the binding-specific retrieval interface.

Author:
K. Benedyczak

  • Method Details

    • getBindingName

      String getBindingName()
      Returns:
      implementation id

    • getAuthenticatorId

      String getAuthenticatorId()
      Returns:
      name of the configured authenticator instance.

    • destroy

      void destroy()
      Called when endpoint using this implementation is destroyed.