BindingAuthn (UNITY documentation 3.12.0 API)

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 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 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 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 Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`destroy()`	Called when endpoint using this implementation is destroyed.
`String`	`getAuthenticatorId()`
`String`	`getBindingName()`

- Method Detail
  - 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.