Package com.sun.enterprise.security.auth.realm.solaris

Class SolarisRealm

java.lang.Object

com.sun.enterprise.security.auth.realm.AbstractGlassFishRealmState

com.sun.enterprise.security.auth.realm.Realm

com.sun.enterprise.security.auth.realm.solaris.SolarisRealm

All Implemented Interfaces:

GlassFishUserManagement, GlassFishUserStore, Comparable<Realm>

@Service
public final class SolarisRealm
extends Realm

Realm wrapper for supporting Solaris authentication.

The Solaris realm needs the following properties in its configuration:

• jaas-ctx - JAAS context name used to access LoginModule for authentication.

See Also:

• SolarisLoginModule

Field Summary

Fields

Modifier and Type	Field	Description
static final String	AUTH_TYPE
static final String	OS_ARCH
static final String	SOL_SPARC_OS_ARCH
static final String	SOL_X86_OS_ARCH

Fields inherited from class com.sun.enterprise.security.auth.realm.Realm

_logger

Fields inherited from class com.sun.enterprise.security.auth.realm.AbstractGlassFishRealmState

groupMapper, JAAS_CONTEXT_PARAM, PARAM_GROUP_MAPPING

Constructor Summary

Constructors

Constructor	Description
SolarisRealm()

Method Summary

Modifier and Type	Method	Description
String[]	authenticate(String username, char[] password)	Invoke the native authentication call.
String	getAuthType()	Returns a short (preferably less than fifteen characters) description of the kind of authentication which is supported by this realm.
Enumeration	getGroupNames(String username)	Returns the name of all the groups that this user belongs to.
void	init(Properties props)	Initialize a realm with some properties.

Methods inherited from class com.sun.enterprise.security.auth.realm.Realm

getDefaultInstance, getDefaultRealm, getInstance, getInstance, getRealmNames, getRealmStatsProvier, instantiate, instantiate, isValidRealm, isValidRealm, setDefaultRealm, unloadInstance, unloadInstance, updateInstance, updateInstance

Methods inherited from class com.sun.enterprise.security.auth.realm.AbstractGlassFishRealmState

addAssignGroups, compareTo, getDefaultDigestAlgorithm, getJAASContext, getMappedGroupNames, getName, getProperties, getProperty, refresh, setName, setProperty, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.sun.enterprise.security.auth.realm.GlassFishUserManagement

addUser, addUser, persist, removeUser, supportsUserManagement, updateUser, updateUser

Methods inherited from interface com.sun.enterprise.security.auth.realm.GlassFishUserStore

getGroupNames, getUser, getUserNames, refresh

Field Details

AUTH_TYPE

public static final String AUTH_TYPE

See Also:

• Constant Field Values

OS_ARCH

public static final String OS_ARCH

See Also:

• Constant Field Values

SOL_SPARC_OS_ARCH

public static final String SOL_SPARC_OS_ARCH

See Also:

• Constant Field Values

SOL_X86_OS_ARCH

public static final String SOL_X86_OS_ARCH

See Also:

• Constant Field Values

Constructor Details

SolarisRealm

public SolarisRealm()

Method Details

init

public void init(Properties props)
          throws BadRealmException,
NoSuchRealmException

Initialize a realm with some properties. This can be used when instantiating realms from their descriptions. This method may only be called a single time.

Overrides:

init in class AbstractGlassFishRealmState

Parameters:

props - Initialization parameters used by this realm.

Throws:

BadRealmException - If the configuration parameters identify a corrupt realm.

NoSuchRealmException - If the configuration parameters specify a realm which doesn't exist.

getAuthType

public String getAuthType()

Returns a short (preferably less than fifteen characters) description of the kind of authentication which is supported by this realm.

Specified by:

getAuthType in class AbstractGlassFishRealmState

Returns:

Description of the kind of authentication that is directly supported by this realm.

getGroupNames

public Enumeration getGroupNames(String username)
                          throws NoSuchUserException

Returns the name of all the groups that this user belongs to. This is called from web path role verification, though it should not be.

Parameters:

username - Name of the user in this realm whose group listing is needed.

Returns:

Enumeration of group names (strings).

Throws:

InvalidOperationException - thrown if the realm does not support this operation - e.g. Certificate realm does not support this operation.

NoSuchUserException

authenticate

public String[] authenticate(String username,
 char[] password)

Invoke the native authentication call.

Parameters:

username - User to authenticate.

password - Given password.