Package io.micronaut.security.authentication

Interface Authentication

All Superinterfaces:

Principal, Serializable

All Known Implementing Classes:

AuthenticationJWTClaimsSetAdapter, ClientAuthentication, ServerAuthentication, X509Authentication

public interface Authentication
extends Principal, Serializable

Represents the state of an authentication.

Since:

1.0

Author:

James Kleeh

Method Summary

Modifier and Type	Method	Description
static Authentication	build(String username)	Builds an Authentication instance for the user.
static Authentication	build(String username, Collection<String> roles)	Builds an Authentication instance for the user.
static Authentication	build(String username, Collection<String> roles, Map<String,Object> attributes)	Builds an Authentication instance for the user.
static Authentication	build(String username, Map<String,Object> attributes)	Builds an Authentication instance for the user.
Map<String,Object>	getAttributes()	In order to correctly implement the Serializable specification, this map should be Map<String, Serializable>, however that would place a burden on those not requiring serialization, forcing their values to conform to that spec.
default Collection<String>	getRoles()

Methods inherited from interface java.security.Principal

equals, getName, hashCode, implies, toString

Method Details

getAttributes

@NonNull
Map<String,Object> getAttributes()

In order to correctly implement the Serializable specification, this map should be Map<String, Serializable>, however that would place a burden on those not requiring serialization, forcing their values to conform to that spec. This is left intentionally as Object in order to meet both use cases and those requiring serialization must ensure all values in the map implement Serializable.

Returns:

Any additional attributes in the authentication

getRoles

@NonNull
default Collection<String> getRoles()

Returns:

Any roles associated with the authentication

build

@NonNull
static Authentication build(@NonNull
 String username)

Builds an Authentication instance for the user.

Parameters:

username - User's name

Returns:

An Authentication for the User

build

@NonNull
static Authentication build(@NonNull
 String username,
 @NonNull
 Collection<String> roles)

Builds an Authentication instance for the user.

Parameters:

username - User's name

roles - User's roles

Returns:

An Authentication for the User

build

@NonNull
static Authentication build(@NonNull
 String username,
 @NonNull
 Map<String,Object> attributes)

Builds an Authentication instance for the user.

Parameters:

username - User's name

attributes - User's attributes

Returns:

An Authentication for the User

build

@NonNull
static Authentication build(@NonNull
 String username,
 @Nullable
 Collection<String> roles,
 @Nullable
 Map<String,Object> attributes)

Builds an Authentication instance for the user.

Parameters:

username - User's name

roles - User's roles

attributes - User's attributes

Returns:

An Authentication for the User