Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

LDAP X509 Identity Asserter: Provider Specific

Configuration Options     Related Tasks     Related Topics

Use this page to define the provider specific configuration of this LDAP X509 Identity Assertion provider.

Configuration Options

Name Description
Host

The host name of the computer on which the LDAP server is running.

MBean Attribute:
LDAPServerMBean.Host

Changes take effect after you redeploy the module or restart the server.

Port

The port number on which the LDAP server is listening.

MBean Attribute:
LDAPServerMBean.Port

Minimum value: 1

Maximum value: 65534

Changes take effect after you redeploy the module or restart the server.

Principal

The Distinguished Name (DN) of the LDAP user that WebLogic Server should use to connect to the LDAP server.

MBean Attribute:
LDAPServerMBean.Principal

Changes take effect after you redeploy the module or restart the server.

Credential

The credential (usually a password) used to connect to the LDAP server.

If this password has not been set, WebLogic Server generates a password at startup, initializes the attribute, and saves the configuration to the config.xml file. If you want to connect to the embedded LDAP server using an external LDAP browser and the embedded LDAP administrator account (cn=Admin), change this attribute from the generated value.

MBean Attribute:
LDAPServerMBean.Credential

Changes take effect after you redeploy the module or restart the server.

SSLEnabled

Specifies whether the SSL protocol should be used when connecting to the LDAP server.

MBean Attribute:
LDAPServerMBean.SSLEnabled

Changes take effect after you redeploy the module or restart the server.

User Name Attribute

Specifies the attribute on the LDAP object for the user that contains the user's name.

The user's name should appear in the Subject. This setting defines how to find the user's name. Typically, the setting matches the User Name setting of the LDAP Authentication provider configured for use with this LDAP X509 Identity Assertion provider.

MBean Attribute:
LDAPX509IdentityAsserterMBean.UsernameAttribute

Changes take effect after you redeploy the module or restart the server.

User Filter Attributes

Specifies how to select the LDAP object for the user from the LDAP objects beneath the base LDAP DN defined in the Certificate Mapping attribute. This setting defines how to find the LDAP object from the certificate's Subject DN.

The LDAP object's class must be person. This attribute contains an array of strings, each of which is an attribute that the LDAP object must match.

Typically, the value of this attribute is the LDAP object that matches the value of an attribute in the certificate's Subject DN. For example:

The uid attribute of the LDAP user object matches the Subject DN attribute, if the syntax is:

LDAPATTRNAME=$subj.SUBJECDNATTRNAME

For example: uid=$subj.DN

This option is very similar to the User Name Filter option on LDAP Authentication providers which maps a username to a search filter. The differences are:

  • This option maps a certificate's Subject DN to a filter and the LDAP Authentication provider uses a single string giving the system administrator complete control over the filter.
  • The LDAP X509 Authentication provider adds objectclass=person to the filter and uses an array of strings that are combined.

MBean Attribute:
LDAPX509IdentityAsserterMBean.UserFilterAttributes

Changes take effect after you redeploy the module or restart the server.

Certificate Attribute

Specifies the attribute on the LDAP object for the user that contains the user's certificate. This option defines how to find the certificate. Valid values are userCertificate and userCertificate;binary.

  • If you use the LDAP browser to load a certificate into the LDAP directory, an attribute userCertificate of type binary is created. To access the certificate, define this option as userCertificate.
  • If you use ldapmodify to create the Certificate Attribute, a userCertificate;binary is created when the certificate data is loaded in the LDAP directory. To access the certificate, define this option as userCertificate;binary.

MBean Attribute:
LDAPX509IdentityAsserterMBean.CertificateAttribute

Changes take effect after you redeploy the module or restart the server.

Certificate Mapping

Specifies how to construct the base LDAP DN used to locate the LDAP object for the user. This attribute defines how to find the object from the certificate's Subject DN.

Typically, this value is the same as the User Base DN attribute in the LDAP Authentication providers. You may include the fields from the Subject DN in this base DN.

For example: if the Certificate subject is CN=meyer.beasys.com, ou=fred, o=BEASYS, L=SFO, C=US and the mapping is ou=people, ou=$subj.ou, WebLogic Server uses ou=people, ou=fred, o=BEASYS, c=US as the DN when locating the user.

MBean Attribute:
LDAPX509IdentityAsserterMBean.CertificateMapping

Changes take effect after you redeploy the module or restart the server.

Connection Retry Limit

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

MBean Attribute:
LDAPServerMBean.ConnectionRetryLimit

Changes take effect after you redeploy the module or restart the server.

Cache Enabled

Specifies whether a cache is used with the LDAP server

This is a cache of the LDAP requests.

MBean Attribute:
LDAPServerMBean.CacheEnabled

Changes take effect after you redeploy the module or restart the server.

Cache Size

The size of the cache (in kilobytes) that is used with the LDAP server

MBean Attribute:
LDAPServerMBean.CacheSize

Minimum value: 0

Changes take effect after you redeploy the module or restart the server.

Cache TTL

The time-to-live of the cache (in seconds) that is used with the LDAP server

MBean Attribute:
LDAPServerMBean.CacheTTL

Minimum value: 0

Changes take effect after you redeploy the module or restart the server.

Related Tasks

Related Topics


Back to Top