io.quarkus.vertx.http.runtime.security

Class BasicAuthenticationMechanism

java.lang.Object

io.quarkus.vertx.http.runtime.security.BasicAuthenticationMechanism

All Implemented Interfaces:

HttpAuthenticationMechanism

@Singleton
public class BasicAuthenticationMechanism
extends Object
implements HttpAuthenticationMechanism

The authentication handler responsible for BASIC authentication as described by RFC2617

Nested Class Summary

Nested classes/interfaces inherited from interface io.quarkus.vertx.http.runtime.security.HttpAuthenticationMechanism

HttpAuthenticationMechanism.ChallengeSender

Field Summary

Fields

Modifier and Type	Field and Description
static String	CHARSET
static String	SILENT
static String	USER_AGENT_CHARSETS A comma separated list of patterns and charsets.

Constructor Summary

Constructors

Constructor and Description
BasicAuthenticationMechanism(String realmName)
BasicAuthenticationMechanism(String realmName, String mechanismName)
BasicAuthenticationMechanism(String realmName, String mechanismName, boolean silent)
BasicAuthenticationMechanism(String realmName, String mechanismName, boolean silent, Charset charset, Map<Pattern,Charset> userAgentCharsets)

Method Summary

Modifier and Type	Method and Description
io.smallrye.mutiny.Uni<io.quarkus.security.identity.SecurityIdentity>	authenticate(io.vertx.ext.web.RoutingContext context, io.quarkus.security.identity.IdentityProviderManager identityProviderManager)
io.smallrye.mutiny.Uni<ChallengeData>	getChallenge(io.vertx.ext.web.RoutingContext context)
HttpCredentialTransport	getCredentialTransport() The credential transport, used to make sure multiple incompatible mechanisms are not installed May be null if this mechanism cannot interfere with other mechanisms
Set<Class<? extends io.quarkus.security.identity.request.AuthenticationRequest>>	getCredentialTypes() Returns the required credential types.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.quarkus.vertx.http.runtime.security.HttpAuthenticationMechanism

sendChallenge

Field Detail

SILENT

public static final String SILENT

See Also:

Constant Field Values

CHARSET

public static final String CHARSET

See Also:

Constant Field Values

USER_AGENT_CHARSETS

public static final String USER_AGENT_CHARSETS

A comma separated list of patterns and charsets. The pattern is a regular expression. Because different browsers user different encodings this allows for the correct encoding to be selected based on the current browser. In general though it is recommended that BASIC auth not be used when passwords contain characters outside ASCII, as some browsers use the current locate to determine encoding. This list must have an even number of elements, as it is interpreted as pattern,charset,pattern,charset,...

See Also:

Constant Field Values

Constructor Detail

BasicAuthenticationMechanism

public BasicAuthenticationMechanism(String realmName)

BasicAuthenticationMechanism

public BasicAuthenticationMechanism(String realmName,
                                    String mechanismName)

BasicAuthenticationMechanism

public BasicAuthenticationMechanism(String realmName,
                                    String mechanismName,
                                    boolean silent)

BasicAuthenticationMechanism

public BasicAuthenticationMechanism(String realmName,
                                    String mechanismName,
                                    boolean silent,
                                    Charset charset,
                                    Map<Pattern,Charset> userAgentCharsets)

Method Detail

authenticate

public io.smallrye.mutiny.Uni<io.quarkus.security.identity.SecurityIdentity> authenticate(io.vertx.ext.web.RoutingContext context,
                                                                                          io.quarkus.security.identity.IdentityProviderManager identityProviderManager)

Specified by:

authenticate in interface HttpAuthenticationMechanism

getChallenge

public io.smallrye.mutiny.Uni<ChallengeData> getChallenge(io.vertx.ext.web.RoutingContext context)

Specified by:

getChallenge in interface HttpAuthenticationMechanism

getCredentialTypes

public Set<Class<? extends io.quarkus.security.identity.request.AuthenticationRequest>> getCredentialTypes()

Description copied from interface: HttpAuthenticationMechanism

Returns the required credential types. If there are no identity managers installed that support the listed types then this mechanism will not be enabled.

Specified by:

getCredentialTypes in interface HttpAuthenticationMechanism

getCredentialTransport

public HttpCredentialTransport getCredentialTransport()

Description copied from interface: HttpAuthenticationMechanism

The credential transport, used to make sure multiple incompatible mechanisms are not installed May be null if this mechanism cannot interfere with other mechanisms

Specified by:

getCredentialTransport in interface HttpAuthenticationMechanism