Administrators LDAP Authentication for SecureTransport

Installation

To install the administrators LDAP authentication plugin, perform the following steps on all SecureTransport Server / Edge nodes:

• Delete the following files/folders associated with the previous version of this plugin (if they exist):

  • /plugins/authentication/axway-securetransport-plugins-authentication-admin-ldap.jar
  • /plugins/authentication/axway-admin-ldap

• Extract securetransport-plugins-authentication-admin-ldap-1.0.1-15.zip into /plugins/authentication

• Restart the Admin and TM daemons on all nodes.

Configuration

Verify that the authentication plugin has been successfully registered in ST Server configuration page:

The Administrators LDAP Authentication plugin is added in Plugins.Authentication.Admin.Registry option in Server Configuration page in disabled state.
To enable the authentication plugin, uncomment it by removing the # character preceding its name.
Before enabling the external authentication plugin, please make sure its sources are configured and there is at least one ST administrator account with local credentials, that does not exist in the external authentication sources.

To configure the LDAP authentication plugin sources, set the following options with appropriate values on the Server configuration page:

Plugins.Authentication.Admin.Registry

主要 LDAP 源配置选项：

Plugins.Authentication.admin-ldap-authentication-plugin.ldapServerName
LDAP 服务器名称。这可以是任意字符串，它命名 LDAP 条目。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapHost
LDAP 服务器的地址。这可以是 IP 地址，也可以是可从 SecureTransport 解析的主机名或完全限定域名。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapPort
LDAP 主机用于侦听 LDAP 请求的端口。非安全 LDAP 请求的默认端口是 389。TLS LDAP 请求的默认端口是 636。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapServerVersion
服务器支持的 LDAP 版本（2 或 3）。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapConnectionType
LDAP 连接类型。可能的值为 normal、TLS 或 StartTLS。如果选择正常，则连接将是不安全的。仅当配置的 ldapHost 与 LDAP 服务器证书的 CN 匹配时，StartTLS 连接才有效。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapAuthenticationBindType
LDAP 身份验证绑定类型。可能的值为管理员、用户或匿名。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapBindDN
定义绑定搜索用户属性时使用的绑定 DN。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapBindPassword
与绑定 DN 绑定时使用的密码。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapBaseDN
定义用于用户目录条目搜索的 LDAP 基本 DN。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapCommonCase
定义登录名的转换。可能的值为上限、下限或无。设置 none 要求区分大小写，所有其他设置不区分大小写。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapSearchFilter
定义后备 LDAP 搜索过滤器/属性。如果绑定是用户，则该字段将充当 ldap 搜索属性，例如cn、uid 或 sAMAccountName。如果绑定是管理员或匿名的，这个字段将作为 ldap 搜索过滤器，例如(sAMAccountName=admin), (ou=TTRD)。搜索过滤器将仅支持管理员登录名的表达式评估。示例： (cn=${authn.loginname}) 其中 ${authn.loginname} 将被评估为管理员用户名。此字段不应包含空格。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapUseReferrals
定义是否使用 LDAP 引用。可能的值为真或假。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapCiphers
用于 TLS 连接的密码套件。密码套件必须以逗号分隔。默认值是TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384，TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384，TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256，TLS_DHE_RSA_WITH_AES_256_GCM_SHA384，TLS_DHE_DSS_WITH_AES_256_GCM_SHA384，TLS_DHE_DSS_WITH_AES_256_CBC_SHA256，TLS_DHE_RSA_WITH_AES_256_CBC_SHA256，TLS_DHE_RSA_WITH_AES_128_GCM_SHA256，TLS_DHE_DSS_WITH_AES_128_GCM_SHA256，TLS_DHE_DSS_WITH_AES_128_CBC_SHA256，TLS_DHE_RSA_WITH_AES_128_CBC_SHA256，TLS_RSA_WITH_AES_256_CBC_SHA256，TLS_EMPTY_RENEGOTIATION_INFO_SCSV。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapTlsProtocols
定义已启用的 TLS（传输层安全）协议的逗号分隔列表。默认值为 TLSv1、TLSv1.1、TLSv1.2。
Plugins.Authentication.admin-ldap-authentication-plugin.ldapVerifyCertificateChain
定义是否检查 ldap 服务器的证书是否被 ST 信任。