## org.hsqldb.auth
Class HsqldbSlaveAuthBean

    java.lang.Object
      org.hsqldb.auth.HsqldbSlaveAuthBean

All Implemented Interfaces:
  AuthFunctionBean

    public class HsqldbSlaveAuthBean

extends Object
implements AuthFunctionBean

Delegates authentication decisions, and optionally determination of user roles and schema, to a different HyperSQL catalog, which may be in the same JVM or remote. For now, at least, this class uses DriverManager to make the ephemeral database connections.

Since:
  2.0.1
Author:
  Blaine Simpson (blaine dot simpson at admc dot com)
See Also:
  `AuthFunctionBean`

Constructor Summary
`HsqldbSlaveAuthBean()`

Method Summary
`String[]` `authenticate(String userName, String password)` Return a list of authorized roles or null to indicate that the implementation does not intend to produce a specific role list but only to indicate whether to allow access or not.
`void` `init()`
`void` `setDelegateRolesSchema(boolean doDelegateRolesSchema)` Defaults to true.
`void` `setMasterJdbcUrl(String masterJdbcUrl)`
`void` `setValidationPassword(String validationPassword)` Use this method and setValidationUser if you want access to the master database to be verified upon instance initialization.
`void` `setValidationUser(String validationUser)` Use this method and setValidationPassword if you want access to the master database to be verified upon instance initialization.

Methods inherited from class java.lang.Object
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### HsqldbSlaveAuthBean

    public HsqldbSlaveAuthBean()

Method Detail

### setValidationUser

    public void setValidationUser(String validationUser)

  Use this method and setValidationPassword if you want access to the master database to be verified upon instance initialization.

### setValidationPassword

    public void setValidationPassword(String validationPassword)

  Use this method and setValidationUser if you want access to the master database to be verified upon instance initialization.

### setMasterJdbcUrl

    public void setMasterJdbcUrl(String masterJdbcUrl)

### setDelegateRolesSchema

    public void setDelegateRolesSchema(boolean doDelegateRolesSchema)

  Defaults to true. Whether roles and initial schema for the new session will be determined by what they are for this user in the master database.

### init

    public void init()
              throws SQLException

  Throws:
    `IllegalStateException` - if any required setting has not been set.
    `SQLException` - if properties 'validationUser' and 'validationPassword' have been set, but we fail to connect to the master database.

### authenticate

    public String[] authenticate(String userName,
                                 String password)
                          throws org.hsqldb.auth.DenyException

  Description copied from interface: `AuthFunctionBean`
  Return a list of authorized roles or null to indicate that the implementation does not intend to produce a specific role list but only to indicate whether to allow access or not. A return value of String[0] is different from returning null, and means that the user should not be granted any roles.

  Specified by:
    `authenticate` in interface `AuthFunctionBean`
  Returns:
    null or String[] according to the contract of HyperSQL authentication function contract, except that the role/schema list is returned as a String[] instead of a java.sql.Array.
  Throws:
    `org.hsqldb.auth.DenyException`
  See Also:
    `AuthFunctionBean.authenticate(String, String)`

Copyright © 2001 - 2010 HSQL Development Group.