Cloudscape Properties
Page 47 of 47

cloudscape.user.UserName

Function

Has two uses:

Users and Passwords

This property creates valid clear-text users and passwords within Cloudscape when the cloudscape.authentication.provider property is set to CLOUDSCAPE. For information about users, see Working with User Authentication of the Cloudscape 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 may 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 cloudscape.properties file.

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

User names are SQL92Identifiers and can be delimited.

Caching User DNs

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

Syntax

cloudscape.user.{UserName=Password} | UserName=userDN }

-- database-level property
CALL PropertyInfo.setDatabaseProperty(
    'cloudscape.user.UserName',
    'Password | userDN')

Default

None.

Examples

-- system-level property
cloudscape.user.guest=java5w
cloudscape.user.sa=cloud3x9 cloudscape.user."!Amber"=java5w

-- database-level property
CALL PropertyInfo.setDatabaseProperty(
    'cloudscape.user.sa',
    'cloud3x9')

-- cache a userDN locally
cloudscape.user.richard=uid=richard, ou=People, o=cloudscape.com

-- cache a userDN locally, database-level property
CALL PropertyInfo.setDatabaseProperty(
    'cloudscape.user.richard',
    'uid=richard, ou=People, o=cloudscape.com')

-- publishing a database-wide property
CREATE PUBLICATION APub
ADD TARGET DATABASE PROPERTY
cloudscape.user.guest=
    'guestPW'

Scope

system-wide

database-wide (publishable)

Dynamic or Static

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