Package org.wildfly.security.auth.server.http

Class HttpAuthenticationFactory

java.lang.Object

org.wildfly.security.auth.server.AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

org.wildfly.security.auth.server.http.HttpAuthenticationFactory

All Implemented Interfaces:

MechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

public final class HttpAuthenticationFactory
extends AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

A HTTP authentication mechanism configuration, the configuration is associated with the SecurityDomain and HttpServerAuthenticationMechanismFactory for obtaining configured mechanisms.

Author:

Darran Lofthouse

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	HttpAuthenticationFactory.Builder	A builder for SASL server factory configurations.

Method Summary

Modifier and Type	Method	Description
static HttpAuthenticationFactory.Builder	builder()	Obtain a new HttpAuthenticationFactory.Builder capable of building a HttpAuthenticationFactory.
protected HttpServerAuthenticationMechanism	doCreate(String name, CallbackHandler callbackHandler, UnaryOperator<HttpServerAuthenticationMechanismFactory> factoryTransformation)
protected Collection<String>	getAllSupportedMechNames()
protected Collection<String>	getSupportedCredentialAlgorithmNames(Class<? extends AlgorithmCredential> credentialType, String mechName)
protected Collection<Class<? extends Credential>>	getSupportedCredentialTypes(String mechName)
protected Collection<String>	getSupportedEvidenceAlgorithmNames(Class<? extends AlgorithmEvidence> evidenceType, String mechName)
protected Collection<Class<? extends Evidence>>	getSupportedEvidenceTypes(String mechName)
protected boolean	isKnownMechanism(String mechName)	Determine whether the given mechanism name is known to WildFly Elytron.
void	shutdownAuthenticationMechanismFactory()
protected boolean	usesCredentials(String mechName)	Determine whether the given mechanism name needs credentials from a realm in order to authenticate.

Methods inherited from class org.wildfly.security.auth.server.AbstractMechanismAuthenticationFactory

createMechanism, getFactory, getMechanismConfigurationSelector, getMechanismNames, getSecurityDomain

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.wildfly.security.auth.server.MechanismAuthenticationFactory

createMechanism

Method Details

doCreate

protected HttpServerAuthenticationMechanism doCreate(String name,
 CallbackHandler callbackHandler,
 UnaryOperator<HttpServerAuthenticationMechanismFactory> factoryTransformation)
                                              throws HttpAuthenticationException

Specified by:

doCreate in class AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

Throws:

HttpAuthenticationException

getAllSupportedMechNames

protected Collection<String> getAllSupportedMechNames()

Specified by:

getAllSupportedMechNames in class AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

getSupportedEvidenceTypes

protected Collection<Class<? extends Evidence>> getSupportedEvidenceTypes(String mechName)

Specified by:

getSupportedEvidenceTypes in class AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

getSupportedEvidenceAlgorithmNames

protected Collection<String> getSupportedEvidenceAlgorithmNames(Class<? extends AlgorithmEvidence> evidenceType,
 String mechName)

Specified by:

getSupportedEvidenceAlgorithmNames in class AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

getSupportedCredentialTypes

protected Collection<Class<? extends Credential>> getSupportedCredentialTypes(String mechName)

Specified by:

getSupportedCredentialTypes in class AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

getSupportedCredentialAlgorithmNames

protected Collection<String> getSupportedCredentialAlgorithmNames(Class<? extends AlgorithmCredential> credentialType,
 String mechName)

Specified by:

getSupportedCredentialAlgorithmNames in class AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

usesCredentials

protected boolean usesCredentials(String mechName)

Description copied from class: AbstractMechanismAuthenticationFactory

Determine whether the given mechanism name needs credentials from a realm in order to authenticate.

Specified by:

usesCredentials in class AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

Parameters:

mechName - the mechanism name

Returns:

true if the mechanism requires realm credential support, false if it does not

isKnownMechanism

protected boolean isKnownMechanism(String mechName)

Description copied from class: AbstractMechanismAuthenticationFactory

Determine whether the given mechanism name is known to WildFly Elytron. If it is not known we can't filter it out as we can not rely upon the other methods being able to return accurate responses about the mechanisms requirements. As this is a new method and other implementations may not know to override this has a default implementation to match the current behaviour i.e. assume we know about all mechanisms.

Overrides:

isKnownMechanism in class AbstractMechanismAuthenticationFactory<HttpServerAuthenticationMechanism,HttpServerAuthenticationMechanismFactory,HttpAuthenticationException>

Parameters:

mechName - the mechanism name

Returns:

true if the mechanism is known to WildFly Elytron, false if it is not

shutdownAuthenticationMechanismFactory

public void shutdownAuthenticationMechanismFactory()

builder

public static HttpAuthenticationFactory.Builder builder()

Obtain a new HttpAuthenticationFactory.Builder capable of building a HttpAuthenticationFactory.

Returns:

a new HttpAuthenticationFactory.Builder capable of building a HttpAuthenticationFactory.