Previous Topic: PSTKAPPL ProcessingNext Topic: Define LDS Global Options as NDT LDSYSID Elements


Define LDAP Nodes as NDT Node Elements

LDAP nodes are defined to the TSS database as NDT node elements using the format:

TSS ADDTO(NDT) LDAPNODE(node_name)
               ACTIVE(YES|NO)
               ADMDN(LDAP admin distinguished name)
               ADMPSWD(LDAP admin password)
               APPLNAME(application name)
               BITDEFLT(bit field format)
               BROADCAST(YES|NO)
               CHILDELETE(YES|NO)
               CODEPAGE(encoding table)
               DATEFMT(date format)
               DEBUG(YES|NO)
               EXTENDED(YES|NO)
               LABLCERT(label name)
               LOWRPSWD(YES|NO)
               USERDNS(Distinguished Name suffix)
               JOURNAL(YES|NO)
               RECOVERY(YES|NO)
               SYNCADD(YES|NO)
               SYNCDEL(YES|NO)
               SYNCUPD(YES|NO)
               OBJCLASS(LDAP object class)
               PSWDASIS(YES|NO)
               SYSID(sysid1,sysid2,,,)
               URL(Uniform Resource Locator)
               XREF(ACIDfield1,LDAPattribute1Name,LDAPattribute1FieldType,
                    LDAPattribute1DataFormat,LDAPattribute1Length,
                    EncloseCharacter)
LDAPNODE

The internal NODE name of the LDAP server.

SYSID

A list of up to five SMF id's of systems where the LDAPNODE definition apply. The SYSID value might contain an asterisk for masking. If SYSID is omitted, the LDAPNODE is global for all systems sharing the security file.

More than five system id's can be defined by using multiple ADD commands. When specified on an ADD command, the new SYSID entered will replace a previously existing value.

ACTIVE

Indicates the node is active and communication with the LDAP server specified is attempted.

Default: NO

ADMDN

Indicates the LDAP administrator distinguished name used for binding to the LDAP server and administering the LDAP request. If there exists any embedded spaces or commas within the ADMNDN, enclose the entire string in quotes.

ADMPSWD

Indicates the LDAP administrator password used in conjunction with the LDAP administrator ID for binding to the LDAP server.

APPLNAME

Specifies the application name of the NDT table data record that contains the TSS administrator's encryption key used for generating PassTickets. The TSS administrator's userid is used in conjunction with the PassTicket for binding to the LDAP server and administering the LDAP request.

BITDEFLT

Indicates the default field type and format that all bit fields are sent to the LDAP server. The default for this field is CHAR_YN. The list of available options for this field includes:

BINARY

Binary 1 or 0 when the bit is ON or OFF, respectively.

CHAR_01

'1' or '0' when the bit is ON or OFF, respectively.

CHAR_YN

'Y' or 'N' when the bit is ON or OFF, respectively.

CHAR_TF

'T' or 'F' when the bit is ON or OFF, respectively.

BINARY_REV

Binary 0 or 1 when the bit is ON or OFF, respectively.

CHAR_REV01

'0' or '1' when the bit is ON or OFF, respectively.

CHAR_REVYN

'N' or 'Y' when the bit is ON or OFF, respectively.

CHAR_REVTF

'F' or 'T' when the bit is ON or OFF, respectively.

BROADCAST

Indicates the node is a broadcast node. All commands and password changes are sent to this node regardless of the LDS attribute setting on the ACID record.

Default: NO

SYNCADD

Specifies that TSS ACID create processing is propagated to the LDAP server.

Default: NO

CHILDELETE

Indicates that children objects are deleted before deleting the base object.

CODEPAGE

Indicates a twenty byte character field to specify which character encoding table is used to translate characters as they are passed into the system. If no CODEPAGE is specified, ASCII ISO8859-1 is assumed.

DATEFMT

Indicates the default format that the date fields are sent to the LDAP server. The date format options available are the following:

MM

A two digit month.

DD

A two digit day.

YYYY

A four digit year.

YY

A two-digit year.

1

Represents a '/' forward slash delimiter in the date field.

Year designations of 70-99 assume a date in the 20th century (1970-1999); year designations of 00-69 assume a date in the 21st century (2000-2069).

DEBUG

Indicates that node level tracing is enabled or disabled.

EXTENDED

Indicates that extended operations are used to enable SSL for the connection to the LDAP server.

LABLCERT

Defines the LABEL of the PERSONAL certificate used, if CLIENT authentication is required for the LDAP server defined by this LDAPNODE record.

USERDNS

Indicates the user distinguished name suffix that refers to the entry on the LDAP server where the changes are applied.

Maximum length: 255

Note: If there exists any embedded spaces or commas within the USERDNS, enclose the entire string in quotes.

JOURNAL

Specifies whether journaling of LDAP outbound traffic is enabled.

OBJCLASS

Specifies the LDAP object class used when an LDAP entry is created. The object class defines the attributes the LDAP directory entry might contain.

Default: TSSUSER.

SYNCDEL

Specifies that TSS ACID remove processing is propagated to the LDAP server.

Default: NO.

SYNCUPD

Specifies that TSS ACID add/rep processing is propagated to the LDAP server.

Default: NO

RECOVERY

Indicates that recovery processing is enabled for the node.

Default: YES

PSWDASIS

If the password field is specified in the XREF field, the PSWASIS option indicates if the password is propagated as it was entered during a signon password change. Any changes made to the password via the TSS command will always be propagated in upper case even if this option is YES. If this option is set to NO then signon password changes are sent in upper case.

Default: YES

PSWDLOWR

Specifies if the case sensitivity format of the user's password is propagated.

Default: NO

PSWDLOWR works in conjunction with the PSWDASIS function. When:

When a user changes a password during system entry validation, LDS automatically propagates the new password to the LDAP servers interested in the password field. The user receives no indication that LDS processing was involved. LDS must be active and the LDS option must be specified in the ACID.

URL

Specifies the Uniform Resource Locator (URL) used to identify the LDAP server. There is a maximum of three URL entries. The entries specify the primary followed by the backups.The syntax of the LDAP URL is:

ldap[s]:// [<host>[:CA Portal]]
ldap

Specifies a connection using the LDAP protocol.

ldaps

Specifies an SSL LDAP connection.

host

The name or IP address of the LDAP server host.

port

The port number of the LDAP server.

XREF

Specifies the names of the TSS ACID fields and the corresponding LDAP directory attribute fields synchronized to the LDAP directory.