# derby.authentication.server

#### Function

Specifies the location of the external directory service that provides user authentication for the Derby system as defined with derby.authentication.provider. For LDAP, specify the host name and port number.

The server must be known on the network.

For more information about external user authentication, see "External directory service" in the Java DB Developer's Guide.

#### Default

Not applicable. Note that if the protocol type is unspecified, it defaults to LDAP.

#### Syntax

    derby.authentication.server=
    [{ ldap: | ldaps: | nisplus: }]
    [//]

    {
        hostname [ :portnumber ] |
        nisServerName/nisDomain
    }

#### Example

    -- system-wide property
    ##LDAP example
    derby.authentication.server=godfrey:9090
    ##LDAP example
    derby.authentication.server=ldap://godfrey:9090
    ##LDAP example
    derby.authentication.server=//godfrey:9090
    ##LDAP over SSL example
    derby.authentication.server=ldaps://godfrey:636/
    -- database-wide property
    CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
        'derby.authentication.server',
        'godfrey:9090')

#### Dynamic or static

Static. For system-wide properties, you must reboot Derby for the change to take effect. For database-wide properties, you must reboot the database for the change to take effect.

Parent topic: Derby properties
Related reference
derby.authentication.builtin.algorithm
derby.authentication.ldap.searchAuthDN
derby.authentication.ldap.searchAuthPW
derby.authentication.ldap.searchBase
derby.authentication.ldap.searchFilter
derby.authentication.provider
derby.connection.requireAuthentication
derby.database.defaultConnectionMode
derby.database.forceDatabaseLock
derby.database.fullAccessUsers
derby.database.noAutoBoot
derby.database.propertiesOnly
derby.database.readOnlyAccessUsers
derby.database.sqlAuthorization
derby.infolog.append
derby.jdbc.xaTransactionTimeout
derby.language.logQueryPlan
derby.language.logStatementText
derby.locks.deadlockTimeout
derby.locks.deadlockTrace
derby.locks.escalationThreshold
derby.locks.monitor
derby.locks.waitTimeout
derby.replication.logBufferSize
derby.replication.maxLogShippingInterval
derby.replication.minLogShippingInterval
derby.replication.verbose
derby.storage.initialPages
derby.storage.minimumRecordSize
derby.storage.pageCacheSize
derby.storage.pageReservedSpace
derby.storage.pageSize
derby.storage.rowLocking
derby.storage.tempDirectory
derby.stream.error.field
derby.stream.error.file
derby.stream.error.method
derby.stream.error.logSeverityLevel
derby.system.bootAll
derby.system.durability
derby.system.home
derby.user.UserName