扩展 MySQL 8.0  / 第 4 章 MySQL 插件 API  / 4.4 编写插件  / 4.4.9 编写认证插件  /  6.4.1.13 可插入认证系统变量

6.4.1.13 可插入认证系统变量

除非安装了适当的服务器端插件,否则这些变量不可用:

  • authentication_ldap_sasl对于名称为以下形式的系统变量 authentication_ldap_sasl_xxx

  • authentication_ldap_simple对于名称为以下形式的系统变量 authentication_ldap_simple_xxx

表 6.20 身份验证插件系统变量摘要

姓名 命令行 选项文件 系统变量 状态变量 可变范围 动态的
authentication_ldap_sasl_auth_method_name 是的 是的 是的 全球的 是的
authentication_ldap_sasl_bind_base_dn 是的 是的 是的 全球的 是的
authentication_ldap_sasl_bind_root_dn 是的 是的 是的 全球的 是的
authentication_ldap_sasl_bind_root_pwd 是的 是的 是的 全球的 是的
authentication_ldap_sasl_ca_path 是的 是的 是的 全球的 是的
authentication_ldap_sasl_group_search_attr 是的 是的 是的 全球的 是的
authentication_ldap_sasl_group_search_filter 是的 是的 是的 全球的 是的
authentication_ldap_sasl_init_pool_size 是的 是的 是的 全球的 是的
authentication_ldap_sasl_log_status 是的 是的 是的 全球的 是的
authentication_ldap_sasl_max_pool_size 是的 是的 是的 全球的 是的
authentication_ldap_sasl_server_host 是的 是的 是的 全球的 是的
authentication_ldap_sasl_server_port 是的 是的 是的 全球的 是的
authentication_ldap_sasl_tls 是的 是的 是的 全球的 是的
authentication_ldap_sasl_user_search_attr 是的 是的 是的 全球的 是的
authentication_ldap_simple_auth_method_name 是的 是的 是的 全球的 是的
authentication_ldap_simple_bind_base_dn 是的 是的 是的 全球的 是的
authentication_ldap_simple_bind_root_dn 是的 是的 是的 全球的 是的
authentication_ldap_simple_bind_root_pwd 是的 是的 是的 全球的 是的
authentication_ldap_simple_ca_path 是的 是的 是的 全球的 是的
authentication_ldap_simple_group_search_attr 是的 是的 是的 全球的 是的
authentication_ldap_simple_group_search_filter 是的 是的 是的 全球的 是的
authentication_ldap_simple_init_pool_size 是的 是的 是的 全球的 是的
authentication_ldap_simple_log_status 是的 是的 是的 全球的 是的
authentication_ldap_simple_max_pool_size 是的 是的 是的 全球的 是的
authentication_ldap_simple_server_host 是的 是的 是的 全球的 是的
authentication_ldap_simple_server_port 是的 是的 是的 全球的 是的
authentication_ldap_simple_tls 是的 是的 是的 全球的 是的
authentication_ldap_simple_user_search_attr 是的 是的 是的 全球的 是的
authentication_windows_log_level 是的 是的 是的 全球的
authentication_windows_use_principal_name 是的 是的 是的 全球的

  • authentication_ldap_sasl_auth_method_name

    命令行格式 --authentication-ldap-sasl-auth-method-name=value
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_auth_method_name
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 SCRAM-SHA-1
    有效值 SCRAM-SHA-1

    对于 SASL LDAP 身份验证,身份验证方法名称。认证插件和LDAP服务器之间的通信是根据这种认证方式进行的,以确保密码安全。

    这些身份验证方法值是允许的:

    • SCRAM-SHA-1: 使用 SASL 质询-响应机制。

      客户端 authentication_ldap_sasl_client 插件与 SASL 服务器通信,使用密码创建挑战并获得 SASL 请求缓冲区,然后将此缓冲区传递给服务器端 authentication_ldap_sasl插件。客户端和服务器端 SASL LDAP 插件使用 SASL 消息在 LDAP 协议中安全传输凭证,以避免在 MySQL 客户端和服务器之间发送明文密码。

  • authentication_ldap_sasl_bind_base_dn

    命令行格式 --authentication-ldap-sasl-bind-base-dn=value
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_bind_base_dn
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 NULL

    对于 SASL LDAP 身份验证,基本专有名称 (DN)。此变量可用于通过将搜索锚定在 搜索树 中的特定位置( ” )来限制搜索范围。

    假设一组 LDAP 用户条目的每个成员都具有以下形式:

    uid=user_name,ou=People,dc=example,dc=com

    另一组 LDAP 用户条目的每个成员都具有以下形式:

    uid=user_name,ou=Admin,dc=example,dc=com

    然后像这样搜索不同的基本 DN 值:

    • 如果基本 DN 是 ou=People,dc=example,dc=com:搜索仅在第一组中查找用户条目。

    • 如果基本 DN 是 ou=Admin,dc=example,dc=com:搜索仅在第二组中查找用户条目。

    • 如果基本 DN 是 ou=dc=example,dc=com:搜索查找第一组或第二组中的用户条目。

    通常,更具体的基本 DN 值会导致更快的搜索,因为它们会更多地限制搜索范围。

  • authentication_ldap_sasl_bind_root_dn

    命令行格式 --authentication-ldap-sasl-bind-root-dn=value
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_bind_root_dn
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 NULL

    对于 SASL LDAP 身份验证,根专有名称 (DN)。此变量与 一起 authentication_ldap_sasl_bind_root_pwd 用作凭据,用于向 LDAP 服务器进行身份验证以执行搜索。身份验证使用一个或两个 LDAP 绑定操作,具体取决于 MySQL 帐户是否命名 LDAP 用户 DN:

    • 如果帐户未命名用户 DN: 使用 和 authentication_ldap_sasl执行初始 LDAP 绑定 。(默认情况下它们都是空的,因此如果未设置它们,LDAP 服务器必须允许匿名连接。)生成的绑定 LDAP 句柄用于根据客户端用户名搜索用户 DN。 使用用户 DN 和客户端提供的密码执行第二次绑定。 authentication_ldap_sasl_bind_root_dnauthentication_ldap_sasl_bind_root_pwdauthentication_ldap_sasl

    • 如果该帐户确实命名了一个用户 DN:在这种情况下,第一个绑定操作是不必要的。 authentication_ldap_sasl使用用户 DN 和客户端提供的密码执行单个绑定。这比 MySQL 帐户不指定 LDAP 用户 DN 更快。

  • authentication_ldap_sasl_bind_root_pwd

    命令行格式 --authentication-ldap-sasl-bind-root-pwd=value
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_bind_root_pwd
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 NULL

    对于 SASL LDAP 身份验证,root 专有名称的密码。此变量与 结合使用 authentication_ldap_sasl_bind_root_dn。请参阅该变量的说明。

  • authentication_ldap_sasl_ca_path

    命令行格式 --authentication-ldap-sasl-ca-path=value
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_ca_path
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 NULL

    对于 SASL LDAP 身份验证,证书颁发机构文件的绝对路径。如果希望身份验证插件执行 LDAP 服务器证书的验证,请指定此文件。

    笔记

    除了将 authentication_ldap_sasl_ca_path 变量设置为文件名之外,您还必须将适当的证书颁发机构证书添加到文件并启用 authentication_ldap_sasl_tls 系统变量。可以设置这些变量来覆盖默认的 OpenLDAP TLS 配置;请参阅 LDAP 可插入身份验证和 ldap.conf

  • authentication_ldap_sasl_group_search_attr

    命令行格式 --authentication-ldap-sasl-group-search-attr=value
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_group_search_attr
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 cn

    对于 SASL LDAP 身份验证,指定 LDAP 目录条目中组名的属性的名称。如果 authentication_ldap_sasl_group_search_attr 其默认值为cn,搜索将返回该cn值作为组名称。例如,如果uid 值为的 LDAP 条目user1cn属性为 mygroup,则搜索 user1returnmygroup 作为组名。

    如果您不需要组或代理身份验证,则此变量应该为空字符串。

    从 MySQL 5.7.21 开始,如果组搜索属性为 isMemberOf,LDAP 身份验证直接检索用户属性isMemberOf 值并将其分配为组信息。如果组搜索属性不是isMemberOf,则 LDAP 身份验证会搜索用户所属的所有组。(后者是默认行为。)此行为基于如何以两种方式存储 LDAP 组信息:1) 组条目可以具有名为 用户名memberUidmember 值为用户名的属性;2) 用户条目可以有一个属性,该属性以isMemberOf组名的值命名。

  • authentication_ldap_sasl_group_search_filter

    命令行格式 --authentication-ldap-sasl-group-search-filter=value
    介绍 5.7.21
    系统变量 authentication_ldap_sasl_group_search_filter
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 (|(&(objectClass=posixGroup)(memberUid=%s))(&(objectClass=group)(member=%s)))

    对于 SASL LDAP 身份验证,自定义组搜索过滤器。

    从 MySQL 5.7.22 开始,搜索过滤器值可以包含 表示用户名和完整用户 DN 的符号{UA}{UD}例如,{UA}替换为用户名,例如"admin",而 {UD}替换为使用完整的 DN,例如 "uid=admin,ou=People,dc=example,dc=com". 以下值为默认值,它同时支持 OpenLDAP 和 Active Directory:

    (|(&(objectClass=posixGroup)(memberUid={UA}))
      (&(objectClass=group)(member={UD})))

    以前,如果组搜索属性是 isMemberOfmemberOf,它会被视为具有组信息的用户属性。但是,在某些情况下,对于用户场景,memberOf是一个不包含组信息的简单用户属性。为了获得额外的灵活性,可选{GA} 前缀现在可以与组搜索属性一起使用。(以前,假定如果组搜索属性是isMemberOf,则处理方式不同。现在任何带有 {GA} 前缀的组属性都被视为具有组名称的用户属性。)例如,值为{GA}MemberOf,如果组值为 DN,则组 DN 中的第一个属性值作为组名返回。

    在 MySQL 5.7.21 中,搜索过滤器使用 %s符号,将其扩展为 OpenLDAP ( &(objectClass=posixGroup)(memberUid=%s)) 的用户名和 Active Directory () 的完整用户 DN &(objectClass=group)(member=%s)

  • authentication_ldap_sasl_init_pool_size

    命令行格式 --authentication-ldap-sasl-init-pool-size=#
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_init_pool_size
    范围 全球的
    动态的 是的
    类型 整数
    默认值 10
    最小值 0
    最大值 32767
    单元 连接

    对于 SASL LDAP 身份验证,LDAP 服务器连接池的初始大小。根据对 LDAP 服务器的并发身份验证请求的平均数量选择此变量的值。

    该插件使用 authentication_ldap_sasl_init_pool_sizeauthentication_ldap_sasl_max_pool_size 一起进行连接池管理:

    对插件系统变量设置的更改可能对池中已有的连接没有影响。例如,修改 LDAP 服务器主机、端口或 TLS 设置不会影响现有连接。但是,如果原始变量值无效并且无法初始化连接池,插件会尝试为下一个 LDAP 请求重新初始化池。在这种情况下,新的系统变量值用于重新初始化尝试。

    如果 authentication_ldap_sasl_max_pool_size=0 要禁用池,插件打开的每个 LDAP 连接都使用系统变量当时的值。

  • authentication_ldap_sasl_log_status

    命令行格式 --authentication-ldap-sasl-log-status=#
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_log_status
    范围 全球的
    动态的 是的
    类型 整数
    默认值 1
    最小值 1
    最大值 5

    对于 SASL LDAP 身份验证,写入错误日志的消息的日志记录级别。下表显示了允许的级别值及其含义。

    表 6.21 authentication_ldap_sasl_log_status 的日志级别

    期权价值 记录的消息类型
    1 没有消息
    2 错误信息
    3 错误和警告信息
    4 错误、警告和信息消息
    5 与上一级别相同,加上来自 MySQL 的调试消息

    在客户端,可以通过设置 AUTHENTICATION_LDAP_CLIENT_LOG 环境变量将消息记录到标准输出。允许值和默认值与 相同 authentication_ldap_sasl_log_status

    AUTHENTICATION_LDAP_CLIENT_LOG 环境变量仅适用于 SASL LDAP 身份验证 。它对简单的 LDAP 身份验证没有影响,因为在这种情况下,客户端插件是 mysql_clear_password,它对 LDAP 操作一无所知。

  • authentication_ldap_sasl_max_pool_size

    命令行格式 --authentication-ldap-sasl-max-pool-size=#
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_max_pool_size
    范围 全球的
    动态的 是的
    类型 整数
    默认值 1000
    最小值 0
    最大值 32767
    单元 连接

    对于 SASL LDAP 身份验证,LDAP 服务器连接池的最大大小。要禁用连接池,请将此变量设置为 0。

    此变量与 结合使用 authentication_ldap_sasl_init_pool_size。请参阅该变量的说明。

  • authentication_ldap_sasl_server_host

    命令行格式 --authentication-ldap-sasl-server-host=host_name
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_server_host
    范围 全球的
    动态的 是的
    类型 细绳

    对于 SASL LDAP 身份验证,LDAP 服务器主机。此变量的允许值取决于身份验证方法:

  • authentication_ldap_sasl_server_port

    命令行格式 --authentication-ldap-sasl-server-port=port_num
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_server_port
    范围 全球的
    动态的 是的
    类型 整数
    默认值 389
    最小值 1
    最大值 32376

    对于 SASL LDAP 身份验证,LDAP 服务器 TCP/IP 端口号。

    从 MySQL 5.7.25 开始,如果 LDAP 端口号配置为 636 或 3269,则插件使用 LDAPS(LDAP over SSL)而不是 LDAP。(LDAPS 不同于startTLS。)

  • authentication_ldap_sasl_tls

    命令行格式 --authentication-ldap-sasl-tls[={OFF|ON}]
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_tls
    范围 全球的
    动态的 是的
    类型 布尔值
    默认值 OFF

    对于 SASL LDAP 身份验证,插件与 LDAP 服务器的连接是否安全。如果启用此变量,插件将使用 TLS 安全地连接到 LDAP 服务器。可以设置此变量以覆盖默认的 OpenLDAP TLS 配置;请参阅 LDAP 可插入身份验证和 ldap.conf如果启用此变量,您可能还希望设置该 authentication_ldap_sasl_ca_path 变量。

    MySQL LDAP 插件支持 StartTLS 方法,该方法在普通 LDAP 连接之上初始化 TLS。

    从 MySQL 5.7.25 开始,可以通过设置 authentication_ldap_sasl_server_port 系统变量来使用 LDAPS。

  • authentication_ldap_sasl_user_search_attr

    命令行格式 --authentication-ldap-sasl-user-search-attr=value
    介绍 5.7.19
    系统变量 authentication_ldap_sasl_user_search_attr
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 uid

    对于 SASL LDAP 认证,指定 LDAP 目录条目中用户名的属性的名称。如果未提供用户可分辨名称,身份验证插件将使用此属性搜索名称。例如,如果 authentication_ldap_sasl_user_search_attr 值为uid,则搜索用户名会 user1找到 uid值为 的条目user1

  • authentication_ldap_simple_auth_method_name

    命令行格式 --authentication-ldap-simple-auth-method-name=value
    介绍 5.7.19
    系统变量 authentication_ldap_simple_auth_method_name
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 SIMPLE
    有效值

    SIMPLE

    AD-FOREST

    对于简单的 LDAP 身份验证,身份验证方法名称。身份验证插件和 LDAP 服务器之间的通信根据此身份验证方法发生。

    笔记

    对于所有简单的 LDAP 身份验证方法,建议还设置 TLS 参数以要求与 LDAP 服务器的通信通过安全连接进行。

    这些身份验证方法值是允许的:

    • SIMPLE:使用简单的 LDAP 身份验证。此方法使用一个或两个 LDAP 绑定操作,具体取决于 MySQL 帐户是否命名 LDAP 用户专有名称。见说明 authentication_ldap_simple_bind_root_dn

    • AD-FOREST:一种变体 SIMPLE,这样身份验证会搜索 Active Directory 林中的所有域,对每个 Active Directory 域执行 LDAP 绑定,直到在某个域中找到用户。

  • authentication_ldap_simple_bind_base_dn

    命令行格式 --authentication-ldap-simple-bind-base-dn=value
    介绍 5.7.19
    系统变量 authentication_ldap_simple_bind_base_dn
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 NULL

    对于简单的 LDAP 身份验证,基本专有名称 (DN)。此变量可用于通过将搜索锚定在 搜索树 中的特定位置( ” )来限制搜索范围。

    假设一组 LDAP 用户条目的每个成员都具有以下形式:

    uid=user_name,ou=People,dc=example,dc=com

    另一组 LDAP 用户条目的每个成员都具有以下形式:

    uid=user_name,ou=Admin,dc=example,dc=com

    然后像这样搜索不同的基本 DN 值:

    • 如果基本 DN 是 ou=People,dc=example,dc=com:搜索仅在第一组中查找用户条目。

    • 如果基本 DN 是 ou=Admin,dc=example,dc=com:搜索仅在第二组中查找用户条目。

    • 如果基本 DN 是 ou=dc=example,dc=com:搜索查找第一组或第二组中的用户条目。

    通常,更具体的基本 DN 值会导致更快的搜索,因为它们会更多地限制搜索范围。

  • authentication_ldap_simple_bind_root_dn

    命令行格式 --authentication-ldap-simple-bind-root-dn=value
    介绍 5.7.19
    系统变量 authentication_ldap_simple_bind_root_dn
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 NULL

    对于简单的 LDAP 身份验证,根专有名称 (DN)。此变量与 一起 authentication_ldap_simple_bind_root_pwd 用作凭据,用于向 LDAP 服务器进行身份验证以执行搜索。身份验证使用一个或两个 LDAP 绑定操作,具体取决于 MySQL 帐户是否命名 LDAP 用户 DN:

    • 如果帐户未命名用户 DN: 使用 和 authentication_ldap_simple执行初始 LDAP 绑定 。(默认情况下它们都是空的,因此如果未设置它们,LDAP 服务器必须允许匿名连接。)生成的绑定 LDAP 句柄用于根据客户端用户名搜索用户 DN。 使用用户 DN 和客户端提供的密码执行第二次绑定。 authentication_ldap_simple_bind_root_dnauthentication_ldap_simple_bind_root_pwdauthentication_ldap_simple

    • 如果该帐户确实命名了一个用户 DN:在这种情况下,第一个绑定操作是不必要的。 authentication_ldap_simple使用用户 DN 和客户端提供的密码执行单个绑定。这比 MySQL 帐户不指定 LDAP 用户 DN 更快。

  • authentication_ldap_simple_bind_root_pwd

    命令行格式 --authentication-ldap-simple-bind-root-pwd=value
    介绍 5.7.19
    系统变量 authentication_ldap_simple_bind_root_pwd
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 NULL

    对于简单的 LDAP 身份验证,root 专有名称的密码。此变量与 结合使用 authentication_ldap_simple_bind_root_dn。请参阅该变量的说明。

  • authentication_ldap_simple_ca_path

    命令行格式 --authentication-ldap-simple-ca-path=value
    介绍 5.7.19
    系统变量 authentication_ldap_simple_ca_path
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 NULL

    对于简单的 LDAP 身份验证,证书颁发机构文件的绝对路径。如果希望身份验证插件执行 LDAP 服务器证书的验证,请指定此文件。

    笔记

    除了将 authentication_ldap_simple_ca_path 变量设置为文件名之外,您还必须将适当的证书颁发机构证书添加到文件并启用 authentication_ldap_simple_tls 系统变量。可以设置这些变量来覆盖默认的 OpenLDAP TLS 配置;请参阅 LDAP 可插入身份验证和 ldap.conf

  • authentication_ldap_simple_group_search_attr

    命令行格式 --authentication-ldap-simple-group-search-attr=value
    介绍 5.7.19
    系统变量 authentication_ldap_simple_group_search_attr
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 cn

    对于简单 LDAP 认证,指定 LDAP 目录条目中的组名的属性名称。如果 authentication_ldap_simple_group_search_attr 其默认值为cn,搜索将返回该cn值作为组名称。例如,如果uid 值为的 LDAP 条目user1cn属性为 mygroup,则搜索 user1returnmygroup 作为组名。

    从 MySQL 5.7.21 开始,如果组搜索属性为 isMemberOf,LDAP 身份验证直接检索用户属性isMemberOf 值并将其分配为组信息。如果组搜索属性不是isMemberOf,则 LDAP 身份验证会搜索用户所属的所有组。(后者是默认行为。)此行为基于如何以两种方式存储 LDAP 组信息:1) 组条目可以具有名为 用户名memberUidmember 值为用户名的属性;2) 用户条目可以有一个属性,该属性以isMemberOf组名的值命名。

  • authentication_ldap_simple_group_search_filter

    命令行格式 --authentication-ldap-simple-group-search-filter=value
    介绍 5.7.21
    系统变量 authentication_ldap_simple_group_search_filter
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 (|(&(objectClass=posixGroup)(memberUid=%s))(&(objectClass=group)(member=%s)))

    对于简单的 LDAP 身份验证,自定义组搜索过滤器。

    从 MySQL 5.7.22 开始,搜索过滤器值可以包含 表示用户名和完整用户 DN 的符号{UA}{UD}例如,{UA}替换为用户名,例如"admin",而 {UD}替换为使用完整的 DN,例如 "uid=admin,ou=People,dc=example,dc=com". 以下值为默认值,它同时支持 OpenLDAP 和 Active Directory:

    (|(&(objectClass=posixGroup)(memberUid={UA}))
      (&(objectClass=group)(member={UD})))

    以前,如果组搜索属性是 isMemberOfmemberOf,它会被视为具有组信息的用户属性。但是,在某些情况下,对于用户场景,memberOf是一个不包含组信息的简单用户属性。为了获得额外的灵活性,可选{GA} 前缀现在可以与组搜索属性一起使用。(以前,假定如果组搜索属性是isMemberOf,则处理方式不同。现在任何带有 {GA} 前缀的组属性都被视为具有组名称的用户属性。)例如,值为{GA}MemberOf,如果组值为 DN,则组 DN 中的第一个属性值作为组名返回。

    在 MySQL 5.7.21 中,搜索过滤器使用 %s符号,将其扩展为 OpenLDAP ( &(objectClass=posixGroup)(memberUid=%s)) 的用户名和 Active Directory () 的完整用户 DN &(objectClass=group)(member=%s)

  • authentication_ldap_simple_init_pool_size

    命令行格式 --authentication-ldap-simple-init-pool-size=#
    介绍 5.7.19
    系统变量 authentication_ldap_simple_init_pool_size
    范围 全球的
    动态的 是的
    类型 整数
    默认值 10
    最小值 0
    最大值 32767
    单元 连接

    对于简单的 LDAP 身份验证,LDAP 服务器连接池的初始大小。根据对 LDAP 服务器的并发身份验证请求的平均数量选择此变量的值。

    该插件使用 authentication_ldap_simple_init_pool_sizeauthentication_ldap_simple_max_pool_size 一起进行连接池管理:

    对插件系统变量设置的更改可能对池中已有的连接没有影响。例如,修改 LDAP 服务器主机、端口或 TLS 设置不会影响现有连接。但是,如果原始变量值无效并且无法初始化连接池,插件会尝试为下一个 LDAP 请求重新初始化池。在这种情况下,新的系统变量值用于重新初始化尝试。

    如果 authentication_ldap_simple_max_pool_size=0 要禁用池,插件打开的每个 LDAP 连接都使用系统变量当时的值。

  • authentication_ldap_simple_log_status

    命令行格式 --authentication-ldap-simple-log-status=#
    介绍 5.7.19
    系统变量 authentication_ldap_simple_log_status
    范围 全球的
    动态的 是的
    类型 整数
    默认值 1
    最小值 1
    最大值 5

    对于简单的 LDAP 身份验证,写入错误日志的消息的日志记录级别。下表显示了允许的级别值及其含义。

    表 6.22 authentication_ldap_simple_log_status 的日志级别

    期权价值 记录的消息类型
    1 没有消息
    2 错误信息
    3 错误和警告信息
    4 错误、警告和信息消息
    5 与上一级别相同,加上来自 MySQL 的调试消息

  • authentication_ldap_simple_max_pool_size

    命令行格式 --authentication-ldap-simple-max-pool-size=#
    介绍 5.7.19
    系统变量 authentication_ldap_simple_max_pool_size
    范围 全球的
    动态的 是的
    类型 整数
    默认值 1000
    最小值 0
    最大值 32767
    单元 连接

    对于简单 LDAP 身份验证,LDAP 服务器连接池的最大大小。要禁用连接池,请将此变量设置为 0。

    此变量与 结合使用 authentication_ldap_simple_init_pool_size。请参阅该变量的说明。

  • authentication_ldap_simple_server_host

    命令行格式 --authentication-ldap-simple-server-host=host_name
    介绍 5.7.19
    系统变量 authentication_ldap_simple_server_host
    范围 全球的
    动态的 是的
    类型 细绳

    对于简单的 LDAP 身份验证,LDAP 服务器主机。此变量的允许值取决于身份验证方法:

    • 对于 authentication_ldap_simple_auth_method_name=SIMPLE:LDAP 服务器主机可以是主机名或 IP 地址。

    • 对于 authentication_ldap_simple_auth_method_name=AD-FOREST。LDAP 服务器主机可以是 Active Directory 域名。例如,对于 的 LDAP 服务器 URL ldap://example.mem.local:389,域名可以是mem.local

      Active Directory 林设置可以有多个域(LDAP 服务器 IP),可以使用 DNS 发现这些域。在 Unix 和类 Unix 系统上,可能需要一些额外的设置来使用 SRV 记录配置您的 DNS 服务器,这些记录为 Active Directory 域指定 LDAP 服务器。有关 DNS SRV 的信息,请参阅 RFC 2782

      假设您的配置具有以下属性:

      • 提供有关 Active Directory 域信息的名称服务器具有 IP 地址 10.172.166.100

      • LDAP 服务器的名称 和 IP 地址 都ldap1.mem.local通过 。 ldap3.mem.local10.172.166.10110.172.166.103

      您希望使用 SRV 搜索可以发现 LDAP 服务器。例如,在命令行中,像这样的命令应该列出 LDAP 服务器:

      host -t SRV _ldap._tcp.mem.local

      执行DNS配置如下:

      1. 添加一行以/etc/resolv.conf 指定提供有关 Active Directory 域的信息的名称服务器:

        nameserver 10.172.166.100
      2. 使用 LDAP 服务器的 SRV 记录为名称服务器配置适当的区域文件:

        _ldap._tcp.mem.local. 86400 IN SRV 0 100 389 ldap1.mem.local.
        _ldap._tcp.mem.local. 86400 IN SRV 0 100 389 ldap2.mem.local.
        _ldap._tcp.mem.local. 86400 IN SRV 0 100 389 ldap3.mem.local.
      3. /etc/hosts如果无法解析服务器主机 ,可能还需要指定 LDAP 服务器的 IP 地址 。例如,将这样的行添加到文件中:

        10.172.166.101 ldap1.mem.local
        10.172.166.102 ldap2.mem.local
        10.172.166.103 ldap3.mem.local

      使用刚刚描述的 DNS 配置,服务器端 LDAP 插件可以发现 LDAP 服务器并尝试在所有域中进行身份验证,直到身份验证成功或没有更多服务器为止。

      Windows 不需要刚才描述的设置。给定值中的 LDAP 服务器主机 authentication_ldap_simple_server_host ,Windows LDAP 库将搜索所有域并尝试进行身份验证。

  • authentication_ldap_simple_server_port

    命令行格式 --authentication-ldap-simple-server-port=port_num
    介绍 5.7.19
    系统变量 authentication_ldap_simple_server_port
    范围 全球的
    动态的 是的
    类型 整数
    默认值 389
    最小值 1
    最大值 32376

    对于简单 LDAP 身份验证,LDAP 服务器 TCP/IP 端口号。

    从 MySQL 5.7.25 开始,如果 LDAP 端口号配置为 636 或 3269,则插件使用 LDAPS(LDAP over SSL)而不是 LDAP。(LDAPS 不同于startTLS。)

  • authentication_ldap_simple_tls

    命令行格式 --authentication-ldap-simple-tls[={OFF|ON}]
    介绍 5.7.19
    系统变量 authentication_ldap_simple_tls
    范围 全球的
    动态的 是的
    类型 布尔值
    默认值 OFF

    对于简单的 LDAP 身份验证,插件与 LDAP 服务器的连接是否安全。如果启用此变量,插件将使用 TLS 安全地连接到 LDAP 服务器。可以设置此变量以覆盖默认的 OpenLDAP TLS 配置;请参阅 LDAP 可插入身份验证和 ldap.conf如果启用此变量,您可能还希望设置该 authentication_ldap_simple_ca_path 变量。

    MySQL LDAP 插件支持 StartTLS 方法,该方法在普通 LDAP 连接之上初始化 TLS。

    从 MySQL 5.7.25 开始,可以通过设置 authentication_ldap_simple_server_port 系统变量来使用 LDAPS。

  • authentication_ldap_simple_user_search_attr

    命令行格式 --authentication-ldap-simple-user-search-attr=value
    介绍 5.7.19
    系统变量 authentication_ldap_simple_user_search_attr
    范围 全球的
    动态的 是的
    类型 细绳
    默认值 uid

    对于简单 LDAP 认证,指定 LDAP 目录条目中用户名的属性名称。如果未提供用户可分辨名称,身份验证插件将使用此属性搜索名称。例如,如果 authentication_ldap_simple_user_search_attr 值为uid,则搜索用户名会 user1找到 uid值为 的条目user1