Function

Has two uses:

• Creates users and passwords when derby.authentication.provider is set to BUILTIN.
• Caches user DNs locally when derby.authentication.provider is set to LDAP and derby.authentication.ldap.searchFilter is set to derby.user.

Users and Passwords

This property creates valid clear-text users and passwords within Derby when the derby.authentication.provider property is set to BUILTIN. For information about users, see "Working with User Authentication" in the Derby Developer's Guide.

• Database-Level Properties

  When you create users with database-level properties, those users are available to the specified database only.

  You set the property once for each user. To delete a user, set that user's password to null.

• System-Level Properties

  When you create users with system-level users, those users are available to all databases in the system.

  You set the value of this system-wide property once for each user, so you can set it several times. To delete a user, remove that user from the file.

  You can define this property in the usual ways--typically in the derby.properties file.

When a user name and its corresponding password are provided in the DriverManager.getConnection call, Derby validates them against the properties defined for the current system.

User names are SQL92Identifiers and can be delimited.

This property caches user DNs (distinguished names) locally when derby.authentication.provider is set to LDAP and derby.authentication.ldap.searchFilter is set to derby.user. When you provide a user DN with this property, Derby is able to avoid an LDAP search for that user's DN before authenticating. For those users without DNs defined with this property, Derby performs a search using the default value of derby.authentication.ldap.searchFilter.

Syntax

derby.user.{UserName=Password}UserName=userDN }

-- database-level property 
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
    'derby.user.UserName',
    'PassworduserDN')

Default

None.

Examples

-- system-level property 
derby.user.guest=java5w

derby.user.sa=Derby3x9
 
derby.user."!Amber"=java5w
 -- database-level property 
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
    'derby.user.sa',
    'Derby3x9') -- cache a userDN locally 
derby.user.richard=uid=richard, ou=People, o=JBMSTours.com
 -- cache a userDN locally, database-level property 
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
    'derby.user.richard',
    'uid=richard, ou=People, o=JBMSTours.com')

Dynamic or static

Dynamic. The change takes effect immediately. For information about dynamic changes to properties, see Dynamic or Static Changes to Properties.