Package weblogic.management.utils

Interface LDAPServerMBean

All Superinterfaces:

DescriptorBean, SettableBean, StandardInterface

public interface LDAPServerMBean
extends StandardInterface, DescriptorBean

The LDAPServerMBean interface defines methods used to get/set the configuration attributes that are required to communicate with an external LDAP server.

Method Summary

Modifier and Type	Method	Description
int	getCacheSize()	Returns the size of the cache in K.
int	getCacheTTL()	Returns the time-to-live (TTL) of the cache in seconds.
int	getConnectionPoolSize()	The LDAP connection pool size.
int	getConnectionRetryLimit()	Specifies the number of times to attempt to connect to the LDAP server if the initial connection failed.
int	getConnectTimeout()	Returns the maximum number of seconds to wait for the LDAP connection to be established.
java.lang.String	getCredential()	Returns the credential (generally a password) used to authenticate the LDAP user that is defined in the Principal attribute.
byte[]	getCredentialEncrypted()	Returns the credential (generally a password) used to authenticate the LDAP user that is defined in the Principal attribute.
java.lang.String	getHost()	Returns the host name or IP address of the LDAP server.
int	getParallelConnectDelay()	Returns the number of seconds to delay when making concurrent attempts to connect to multiple servers.
int	getPort()	Returns the port number on which the LDAP server is listening.
java.lang.String	getPrincipal()	Returns the Distinguished Name (DN) of the LDAP user that is used by WebLogic Server to connect to the LDAP server.
int	getResultsTimeLimit()	Returns the maximum number of milliseconds to wait for results before timing out.
boolean	isBindAnonymouslyOnReferrals()	Returns whether to anonymously bind when following referrals within the LDAP directory.
boolean	isCacheEnabled()	Returns whether to cache LDAP requests with the LDAP server.
boolean	isFollowReferrals()	Returns whether referrals will automatically be followed within the LDAP Directory.
boolean	isSSLEnabled()	Returns whether SSL will be used to connect to the LDAP server.
void	setBindAnonymouslyOnReferrals(boolean bindAnonymouslyOnReferrals)	Sets whether to anonymously bind when following referrals within the LDAP directory.
void	setCacheEnabled(boolean enabled)	Sets whether to cache LDAP requests with the LDAP server.
void	setCacheSize(int size)	Sets the size of the cache in K.
void	setCacheTTL(int TTL)	Sets the time-to-live (TTL) of the cache in seconds.
void	setConnectionPoolSize(int size)
void	setConnectionRetryLimit(int limit)
void	setConnectTimeout(int timeout)	Sets the maximum number of seconds to wait for the LDAP connection to be established.
void	setCredential(java.lang.String credential)	Sets the credential (generally a password) used to authenticate the LDAP user that is defined in the Principal attribute.
void	setCredentialEncrypted(byte[] bytes)	Sets the credential (generally a password) used to authenticate the LDAP user that is defined in the Principal attribute.
void	setFollowReferrals(boolean followReferrals)	Sets whether referrals will automatically be followed within the LDAP Directory.
void	setHost(java.lang.String host)	Sets the host name or IP address of the LDAP server.
void	setParallelConnectDelay(int delay)	Sets the number of seconds to delay when making concurrent attempts to connect to multiple servers.
void	setPort(int port)	Sets the port number on which the LDAP server is listening.
void	setPrincipal(java.lang.String principal)	Sets the Distinguished Name (DN) of the LDAP user that is used by WebLogic Server to connect to the LDAP server.
void	setResultsTimeLimit(int timeLimit)	Sets the maximum number of milliseconds to wait for results before timing out.
void	setSSLEnabled(boolean enabled)	Sets whether SSL will be used to connect to the LDAP server.

Methods inherited from interface weblogic.descriptor.DescriptorBean

addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener

Methods inherited from interface weblogic.management.commo.StandardInterface

getName

Method Detail

getHost

java.lang.String getHost()

Returns the host name or IP address of the LDAP server.

Default Value:

"localhost"

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setHost

void setHost(java.lang.String host)
      throws javax.management.InvalidAttributeValueException

Sets the host name or IP address of the LDAP server.

Parameters:

host - - the new host name

Throws:

javax.management.InvalidAttributeValueException

See Also:

getHost()

getPort

int getPort()

Returns the port number on which the LDAP server is listening.

Default Value:

389

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

Maximum Value:

65534

Minimum Value:

1

setPort

void setPort(int port)
      throws javax.management.InvalidAttributeValueException

Sets the port number on which the LDAP server is listening.

Parameters:

port - - the new port number

Throws:

javax.management.InvalidAttributeValueException

See Also:

getPort()

isSSLEnabled

boolean isSSLEnabled()

Returns whether SSL will be used to connect to the LDAP server.

Default Value:

false

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setSSLEnabled

void setSSLEnabled(boolean enabled)
            throws javax.management.InvalidAttributeValueException

Sets whether SSL will be used to connect to the LDAP server.

Parameters:

enabled - - the new SSL enabled value

Throws:

javax.management.InvalidAttributeValueException

See Also:

isSSLEnabled()

getPrincipal

java.lang.String getPrincipal()

Returns the Distinguished Name (DN) of the LDAP user that is used by WebLogic Server to connect to the LDAP server.

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setPrincipal

void setPrincipal(java.lang.String principal)
           throws javax.management.InvalidAttributeValueException

Sets the Distinguished Name (DN) of the LDAP user that is used by WebLogic Server to connect to the LDAP server.

Parameters:

principal - - the new principal name

Throws:

javax.management.InvalidAttributeValueException

See Also:

getPrincipal()

getCredential

java.lang.String getCredential()

Returns the credential (generally a password) used to authenticate the LDAP user that is defined in the Principal attribute.

See Also:

getCredentialEncrypted()

setCredential

void setCredential(java.lang.String credential)
            throws javax.management.InvalidAttributeValueException

Sets the credential (generally a password) used to authenticate the LDAP user that is defined in the Principal attribute.

Parameters:

credential - - the new credential

Throws:

javax.management.InvalidAttributeValueException

See Also:

getCredential(), setCredentialEncrypted(byte[])

getCredentialEncrypted

byte[] getCredentialEncrypted()

Returns the credential (generally a password) used to authenticate the LDAP user that is defined in the Principal attribute.

Returns:

The credential value as an encrypted byte array.

Default Value:

null

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setCredentialEncrypted

void setCredentialEncrypted(byte[] bytes)
                     throws javax.management.InvalidAttributeValueException

Sets the credential (generally a password) used to authenticate the LDAP user that is defined in the Principal attribute.

Parameters:

bytes - The new credential value as a byte array.

Throws:

javax.management.InvalidAttributeValueException

See Also:

getCredentialEncrypted()

isCacheEnabled

boolean isCacheEnabled()

Returns whether to cache LDAP requests with the LDAP server.

Default Value:

true

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setCacheEnabled

void setCacheEnabled(boolean enabled)
              throws javax.management.InvalidAttributeValueException

Sets whether to cache LDAP requests with the LDAP server.

Parameters:

enabled - - the new cache enabled value

Throws:

javax.management.InvalidAttributeValueException

See Also:

isCacheEnabled()

getCacheSize

int getCacheSize()

Returns the size of the cache in K.

Default Value:

32

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

Minimum Value:

0

setCacheSize

void setCacheSize(int size)
           throws javax.management.InvalidAttributeValueException

Sets the size of the cache in K.

Parameters:

size - - the new cache size

Throws:

javax.management.InvalidAttributeValueException

See Also:

getCacheSize()

getCacheTTL

int getCacheTTL()

Returns the time-to-live (TTL) of the cache in seconds.

Default Value:

60

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

Minimum Value:

0

setCacheTTL

void setCacheTTL(int TTL)
          throws javax.management.InvalidAttributeValueException

Sets the time-to-live (TTL) of the cache in seconds.

Parameters:

TTL - - the new cache time to live

Throws:

javax.management.InvalidAttributeValueException

See Also:

getCacheTTL()

isFollowReferrals

boolean isFollowReferrals()

Returns whether referrals will automatically be followed within the LDAP Directory. If set to false, then a Referral exception will be thrown when referrals are encountered during LDAP requests.

Default Value:

true

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setFollowReferrals

void setFollowReferrals(boolean followReferrals)
                 throws javax.management.InvalidAttributeValueException

Sets whether referrals will automatically be followed within the LDAP Directory.

Parameters:

followReferrals - - the new follow referrals value

Throws:

javax.management.InvalidAttributeValueException

See Also:

isFollowReferrals()

isBindAnonymouslyOnReferrals

boolean isBindAnonymouslyOnReferrals()

Returns whether to anonymously bind when following referrals within the LDAP directory. If set to false, then the current Principal and Credential will be used.

Default Value:

false

Changes to this property take effect after you redeploy the module or restart the server. If the resource is in a partition, restart the partition.

setBindAnonymouslyOnReferrals

void setBindAnonymouslyOnReferrals(boolean bindAnonymouslyOnReferrals)
                            throws javax.management.InvalidAttributeValueException

Sets whether to anonymously bind when following referrals within the LDAP directory.

Parameters:

bindAnonymouslyOnReferrals - - the new bind anonymously on referrals value

Throws:

javax.management.InvalidAttributeValueException

See Also:

isBindAnonymouslyOnReferrals()

getResultsTimeLimit

int getResultsTimeLimit()

Returns the maximum number of milliseconds to wait for results before timing out. If set to 0, there is no maximum time limit.

Default Value:

0

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setResultsTimeLimit

void setResultsTimeLimit(int timeLimit)
                  throws javax.management.InvalidAttributeValueException

Sets the maximum number of milliseconds to wait for results before timing out. If set to 0, there is no maximum time limit.

The default setting is 0. This default value can result in a slowdown in WebLogic Server execution if the LDAP server is unavailable. In addition, if WebLogic Server has multiple LDAP Authentication providers configured, the failure to connect to one LDAP server may block the use of the other LDAP Authentication providers.

Oracle recommends that you specify a non-zero value; for example, 60 seconds.

Parameters:

timeLimit - - the new results time limit

Throws:

javax.management.InvalidAttributeValueException

See Also:

getResultsTimeLimit()

getConnectTimeout

int getConnectTimeout()

Returns the maximum number of seconds to wait for the LDAP connection to be established.

Default Value:

0

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setConnectTimeout

void setConnectTimeout(int timeout)
                throws javax.management.InvalidAttributeValueException

Sets the maximum number of seconds to wait for the LDAP connection to be established.

Parameters:

timeout - - the new connect timeout

Throws:

javax.management.InvalidAttributeValueException

See Also:

getConnectTimeout()

getParallelConnectDelay

int getParallelConnectDelay()

Returns the number of seconds to delay when making concurrent attempts to connect to multiple servers.

If set to 0, connection attempts are serialized. An attempt is made to connect to the first server in the list. The next entry in the list is tried only if the attempt to connect to the current host fails. This might cause your application to block for unacceptably long time if a host is down. If set to greater than 0, another connection setup thread is started after this number of delay seconds has passed.

Default Value:

0

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setParallelConnectDelay

void setParallelConnectDelay(int delay)
                      throws javax.management.InvalidAttributeValueException

Sets the number of seconds to delay when making concurrent attempts to connect to multiple servers.

Parameters:

delay - - the new parallel connect delay

Throws:

javax.management.InvalidAttributeValueException

See Also:

getParallelConnectDelay()

getConnectionRetryLimit

int getConnectionRetryLimit()

Specifies the number of times to attempt to connect to the LDAP server if the initial connection failed.

Default Value:

1

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setConnectionRetryLimit

void setConnectionRetryLimit(int limit)
                      throws javax.management.InvalidAttributeValueException

Parameters:

limit - - number of times connection should tried.

Throws:

javax.management.InvalidAttributeValueException

See Also:

getConnectionRetryLimit()

getConnectionPoolSize

int getConnectionPoolSize()

The LDAP connection pool size. Default is 6.

Default Value:

6

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setConnectionPoolSize

void setConnectionPoolSize(int size)
                    throws javax.management.InvalidAttributeValueException

Parameters:

size - the LDAP connection pool size

Throws:

javax.management.InvalidAttributeValueException