com.ibm.dse.applsrv.aa
Class SecurityConfiguration

java.lang.Object
  |
  +--com.ibm.dse.applsrv.aa.SecurityObject
        |
        +--com.ibm.dse.applsrv.aa.SecurityConfiguration

public class SecurityConfiguration
extends SecurityObject
implements java.io.Serializable

This class represents the system configuration for security.

See Also:
Serialized Form

Field Summary
static java.lang.String C_AUDIT
           
static java.lang.String C_AUDIT_FILE
           
static java.lang.String C_CFG_DB
           
static java.lang.String C_CFG_PERSIST
           
static java.lang.String C_CTX_DB
           
static java.lang.String C_CTXT_PERSIST
           
static java.lang.String C_GRP_DB
           
static java.lang.String C_GRP_PERSIST
           
static java.lang.String C_LOGON_1
           
static java.lang.String C_PWD_ACC
           
static java.lang.String C_RGT_DB
           
static java.lang.String C_RI_PERSIST
           
static java.lang.String C_RO_PERSIST
           
static java.lang.String C_ROL_DB
           
static java.lang.String C_SRV_DB
           
static java.lang.String C_SRV_PERSIST
           
static java.lang.String C_SYS_RO
           
static java.lang.String C_USR_DB
           
static java.lang.String C_USR_PERSIST
           
 
Fields inherited from class com.ibm.dse.applsrv.aa.SecurityObject
fs
 
Constructor Summary
SecurityConfiguration()
           
 
Method Summary
protected  void _save()
          A hack to force inheritence of a static method.
static void controller(SecurityController ctrl)
          Set the security controller.
protected static boolean disablePersist()
          Disable persistence for system configuration.
protected static void forceSave()
          Force a save of the current state of the system configurations to the database.
protected static Dictionary getConfiguration()
          Return a dictionary of the current state of the system configurations.
protected static java.lang.String getPathName()
          Return the pathname of this database of system configurations.
protected static boolean getPersist()
          Return the persistence state for system configurations.
protected static java.lang.String[] getSystemRoles()
          Return the names of the system-wide roles.
static boolean getUniqueLogons()
          Return the unique logon control flag.
protected static void load()
          Load the current state of the system configurations from the database.
protected static Dictionary loadr()
          Load and return the current state of the system configurations from the database.
protected static void reset()
          Reset the system configurations.
protected static void save()
          Save the current state of the system configurations to the database.
protected static void setAuditFile(java.lang.String fileName)
          Set the pathname of the audit file.
protected static void setConfiguration(Dictionary config)
          Set the specified system configurations to the specified values.
protected static void setDB(SecurityPersistence securityPersistence)
          Set the persistence controller for this class.
protected static void setPersist(boolean persistence)
          Enable or disable persistence for system configurations.
protected static void setSystemRoles(java.lang.String[] roles)
          Set the names of the system-wide roles.
static void setUniqueLogons(boolean unique)
          Enable or disable unique logons by users.
protected static void shutdown()
          Shutdown the security component.
protected static void verifyAll()
          Verify the consistancy of this database.
 
Methods inherited from class com.ibm.dse.applsrv.aa.SecurityObject
getData, getData, getDataOrNull, getName, home, prefix, putData, putData, setName
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

C_AUDIT

public static final java.lang.String C_AUDIT

C_CFG_PERSIST

public static final java.lang.String C_CFG_PERSIST

C_CTXT_PERSIST

public static final java.lang.String C_CTXT_PERSIST

C_GRP_PERSIST

public static final java.lang.String C_GRP_PERSIST

C_PWD_ACC

public static final java.lang.String C_PWD_ACC

C_RI_PERSIST

public static final java.lang.String C_RI_PERSIST

C_RO_PERSIST

public static final java.lang.String C_RO_PERSIST

C_SRV_PERSIST

public static final java.lang.String C_SRV_PERSIST

C_SYS_RO

public static final java.lang.String C_SYS_RO

C_LOGON_1

public static final java.lang.String C_LOGON_1

C_USR_PERSIST

public static final java.lang.String C_USR_PERSIST

C_CFG_DB

public static final java.lang.String C_CFG_DB

C_CTX_DB

public static final java.lang.String C_CTX_DB

C_GRP_DB

public static final java.lang.String C_GRP_DB

C_RGT_DB

public static final java.lang.String C_RGT_DB

C_ROL_DB

public static final java.lang.String C_ROL_DB

C_SRV_DB

public static final java.lang.String C_SRV_DB

C_USR_DB

public static final java.lang.String C_USR_DB

C_AUDIT_FILE

public static final java.lang.String C_AUDIT_FILE
Constructor Detail

SecurityConfiguration

public SecurityConfiguration()
Method Detail

_save

protected void _save()
              throws DSESecurityException
A hack to force inheritence of a static method.
Overrides:
_save in class SecurityObject
Throws:
DSESecurityException - - abstract method.

controller

public static void controller(SecurityController ctrl)
Set the security controller.
Parameters:
ctrl - SecurityController - the security controller.

disablePersist

protected static boolean disablePersist()
Disable persistence for system configuration.
Returns:
boolean - true if system configuration were persisting else false.

forceSave

protected static void forceSave()
                         throws DSESecurityException
Force a save of the current state of the system configurations to the database.
Throws:
DSESecurityException - - database error.

getConfiguration

protected static Dictionary getConfiguration()
                                      throws DSESecurityException
Return a dictionary of the current state of the system configurations.
Returns:
Dictionary - dictionary of the current state of the system configurations.
Throws:
DSESecurityException - - database error.

getPathName

protected static java.lang.String getPathName()
Return the pathname of this database of system configurations.
Returns:
String - the pathname of this database or null if its not configured.

getPersist

protected static boolean getPersist()
Return the persistence state for system configurations.
Returns:
boolean - true if system configurations are persisting else false.

getSystemRoles

protected static java.lang.String[] getSystemRoles()
Return the names of the system-wide roles.
Returns:
String[] - the names of the system-wide roles.

getUniqueLogons

public static boolean getUniqueLogons()
Return the unique logon control flag.
Returns:
boolean - true if user logons must be unique else false.

load

protected static void load()
                    throws DSESecurityException
Load the current state of the system configurations from the database.
Throws:
DSESecurityException - - database error.

loadr

protected static Dictionary loadr()
                           throws DSESecurityException
Load and return the current state of the system configurations from the database.
Returns:
Dictionary - the database.
Throws:
DSESecurityException - - database error.

reset

protected static void reset()
                     throws DSESecurityException
Reset the system configurations.
Throws:
DSESecurityException - - database error.

save

protected static void save()
                    throws DSESecurityException
Save the current state of the system configurations to the database.
Throws:
DSESecurityException - - database error.

setAuditFile

protected static void setAuditFile(java.lang.String fileName)
Set the pathname of the audit file.
Parameters:
fileName - String - the pathname of the audit file.

setConfiguration

protected static void setConfiguration(Dictionary config)
                                throws DSESecurityException
Set the specified system configurations to the specified values. Invalid keys or values are ignored.
Parameters:
config - Dictionary - dictionary of system configurations to be set.
Throws:
DSESecurityException - - database error.

setDB

protected static void setDB(SecurityPersistence securityPersistence)
Set the persistence controller for this class.
Parameters:
securityPersistence - SecurityPersistence - the persistence controller.

setPersist

protected static void setPersist(boolean persistence)
Enable or disable persistence for system configurations.
Parameters:
persistence - boolean - true to enable persistence, false to disable it.

setSystemRoles

protected static void setSystemRoles(java.lang.String[] roles)
                              throws DSESecurityException
Set the names of the system-wide roles.
Parameters:
roles - String[] - the names of the system-wide roles.
Throws:
DSESecurityException - - one or more of the named roles does not exist.

setUniqueLogons

public static void setUniqueLogons(boolean unique)
                            throws DSESecurityException
Enable or disable unique logons by users.
Parameters:
unique - boolean - true to enable unique logons, false to disable it.
Throws:
DSESecurityException - - database error.

shutdown

protected static void shutdown()
                        throws DSESecurityException
Shutdown the security component.
Throws:
DSESecurityException - - error in the request.

verifyAll

protected static void verifyAll()
                         throws DSESecurityException
Verify the consistancy of this database.
Throws:
DSESecurityException - - error in the request.