对于给定身份验证插件的代理，必须满足以下条件：

代理机制只允许将外部客户端用户名映射到代理用户名。没有映射主机名的规定：

考虑以下帐户定义：

-- create proxy account
CREATE USER 'employee_ext'@'localhost'
  IDENTIFIED WITH my_auth_plugin
  AS 'my_auth_string';

-- create proxied account and grant its privileges;
-- use mysql_no_login plugin to prevent direct login
CREATE USER 'employee'@'localhost'
  IDENTIFIED WITH mysql_no_login;
GRANT ALL
  ON employees.*
  TO 'employee'@'localhost';

-- grant to proxy account the
-- PROXY privilege for proxied account
GRANT PROXY
  ON 'employee'@'localhost'
  TO 'employee_ext'@'localhost';

当客户端employee_ext从本地主机连接时，MySQL 使用名为的插件 my_auth_plugin来执行身份验证。假设根据内容 并可能通过咨询某些外部身份验证系统my_auth_plugin，向服务器返回一个用户名。名称与 不同 ，因此返回 作为对服务器的请求，将外部用户视为本地用户 ，以便进行权限检查 。employee'my_auth_string'employeeemployee_extemployeeemployee_extemployee

在这种情况下，employee_ext是代理用户和employee被代理用户。

服务器 通过检查（代理用户）是否 具有（被代理用户）的 权限来 验证用户是否employee可以进行 代理身份验证。如果未授予此特权，则会发生错误。否则， 承担 的特权 。服务器根据授予的权限检查在客户端会话期间执行的语句 。在这种情况下， 可以访问 数据库中的表。 employee_extemployee_extPROXYemployeeemployee_extemployeeemployee_extemployeeemployee_extemployees

被代理的账户，employee使用 mysql_no_login认证插件来防止客户端使用该账户直接登录。（这假定安装了插件。有关说明，请参阅 第 6.4.1.9 节，“无登录可插入身份验证”。）有关保护代理帐户不被直接使用的替代方法，请参阅 防止直接登录到代理帐户。

当发生代理时，可以使用USER() 和CURRENT_USER()函数来查看连接用户（代理用户）和在当前会话期间其权限适用的帐户（被代理用户）之间的区别。对于刚刚描述的示例，这些函数返回这些值：

mysql> SELECT USER(), CURRENT_USER();
+------------------------+--------------------+
| USER()                 | CURRENT_USER()     |
+------------------------+--------------------+
| employee_ext@localhost | employee@localhost |
+------------------------+--------------------+

在CREATE USER创建代理用户帐户的IDENTIFIED WITH语句中，命名支持代理的身份验证插件的子句后面可选地跟一个子句，该子句指定用户连接时服务器传递给插件的字符串。如果存在，该字符串提供的信息可帮助插件确定如何将代理（外部）客户端用户名映射到代理用户名。是否需要该子句取决于每个插件。如果是这样，身份验证字符串的格式取决于插件打算如何使用它。有关给定插件接受的身份验证字符串值的信息，请查阅给定插件的文档。 AS 'auth_string'AS

代理账户通常仅供代理账户使用。也就是说，客户端使用代理帐户进行连接，然后映射到并承担适当的代理用户的权限。

有多种方法可以确保不能直接使用代理帐户：

PROXY需要特权才能使外部用户能够连接并拥有另一个用户的特权 。要授予此特权，请使用该 GRANT语句。例如：

GRANT PROXY ON 'proxied_user' TO 'proxy_user';

mysql.proxies_priv该语句在授权表 中创建一行 。

在连接时，proxy_user必须代表一个有效的外部身份验证的 MySQL 用户，并且 proxied_user必须代表一个有效的本地身份验证的用户。否则，连接尝试失败。

对应的REVOKE语法是：

REVOKE PROXY ON 'proxied_user' FROM 'proxy_user';

MySQLGRANT和 REVOKE语法扩展照常工作。例子：

-- grant PROXY to multiple accounts
GRANT PROXY ON 'a' TO 'b', 'c', 'd';

-- revoke PROXY from multiple accounts
REVOKE PROXY ON 'a' FROM 'b', 'c', 'd';

-- grant PROXY to an account and enable the account to grant
-- PROXY to the proxied account
GRANT PROXY ON 'a' TO 'd' WITH GRANT OPTION;

-- grant PROXY to default proxy account
GRANT PROXY ON 'a' TO ''@'';

在这些PROXY情况下可以授予特权：

rootMySQL安装时创建 的初始账号，PROXY ... WITH GRANT OPTION权限为''@''，即所有用户和所有主机。这可以 root设置代理用户，以及将设置代理用户的权限委托给其他帐户。例如，root可以这样做：

CREATE USER 'admin'@'localhost'
  IDENTIFIED BY 'admin_password';
GRANT PROXY
  ON ''@''
  TO 'admin'@'localhost'
  WITH GRANT OPTION;

这些语句创建了一个admin可以管理所有GRANT PROXY映射的用户。例如，admin可以这样做：

GRANT PROXY ON sally TO joe;

要指定部分或所有用户应使用给定的身份验证插件进行连接，请创建一个具有空用户名和主机名的“空白”''@'' MySQL 帐户(如果与空白用户不同）。假设存在一个名为的插件ldap_auth，它实现了 LDAP 身份验证并将连接用户映射到开发人员或经理帐户。要在这些帐户上设置用户代理，请使用以下语句：

-- create default proxy account
CREATE USER ''@''
  IDENTIFIED WITH ldap_auth
  AS 'O=Oracle, OU=MySQL';

-- create proxied accounts; use
-- mysql_no_login plugin to prevent direct login
CREATE USER 'developer'@'localhost'
  IDENTIFIED WITH mysql_no_login;
CREATE USER 'manager'@'localhost'
  IDENTIFIED WITH mysql_no_login;

-- grant to default proxy account the
-- PROXY privilege for proxied accounts
GRANT PROXY
  ON 'manager'@'localhost'
  TO ''@'';
GRANT PROXY
  ON 'developer'@'localhost'
  TO ''@'';

现在假设客户端连接如下：

$> mysql --user=myuser --password ...
Enter password: myuser_password

服务器未发现myuser定义为 MySQL 用户，但由于存在''@''与客户端用户名和主机名匹配的空白用户帐户 ( )，因此服务器根据该帐户对客户端进行身份验证。服务器调用ldap_auth 身份验证插件并将myuser和 myuser_password作为用户名和密码传递给它。

如果ldap_auth插件在 LDAP 目录中发现 的myuser_password密码不正确myuser，则身份验证失败并且服务器拒绝连接。

如果密码正确，ldap_auth 发现myuser是开发者，则返回用户名developer给MySQL服务器，而不是myuser. 将与信号的客户端用户名不同的用户名返回给myuser 它应 myuser视为代理的服务器。服务器验证 ''@''可以验证为 developer（因为''@'' 有PROXY这样做的特权）并接受连接。会话以 被代理用户myuser的特权 继续进行。developer（这些权限应由 DBA 使用 GRANT语句设置，未显示。 USER()） CURRENT_USER()函数返回这些值：

mysql> SELECT USER(), CURRENT_USER();
+------------------+---------------------+
| USER()           | CURRENT_USER()      |
+------------------+---------------------+
| myuser@localhost | developer@localhost |
+------------------+---------------------+

如果插件在 LDAP 目录中找到的 myuser是管理员，它将 manager作为用户名返回，并且会话继续具有代理用户 myuser的权限。manager

mysql> SELECT USER(), CURRENT_USER();
+------------------+-------------------+
| USER()           | CURRENT_USER()    |
+------------------+-------------------+
| myuser@localhost | manager@localhost |
+------------------+-------------------+

为简单起见，外部身份验证不能是多级的：在前面的示例中既没有考虑用于的凭据developer也没有考虑用于的凭据。manager但是，如果客户端尝试连接并直接作为 developer或manager 帐户进行身份验证，它们仍然会被使用，这就是为什么应该保护这些代理帐户免受直接登录的原因（请参阅 防止直接登录到代理帐户）。

如果您打算创建默认代理用户，请检查优先于默认代理用户 的其他现有“匹配任何用户”帐户，因为它们可以阻止该用户按预期工作。

在前面的讨论中，默认代理用户帐户 ''在主机部分，匹配任何主机。如果设置默认代理用户，请注意检查是否存在具有相同用户部分和 '%'主机部分的非代理帐户，因为它 '%'也匹配任何主机，但优先于''服务器用于对帐户行进行排序的规则内部（参见 第 6.2.6 节，“访问控制，第 1 阶段：连接验证”）。

假设 MySQL 安装包括这两个帐户：

-- create default proxy account
CREATE USER ''@''
  IDENTIFIED WITH some_plugin
  AS 'some_auth_string';
-- create anonymous account
CREATE USER ''@'%'
  IDENTIFIED BY 'anon_user_password';

第一个帐户 ( ''@'') 用作默认代理用户，用于验证不匹配更具体帐户的用户的连接。第二个帐户 ( ''@'%') 是一个匿名用户帐户，创建它可能是为了让没有自己帐户的用户能够匿名连接。

这两个帐户具有相同的用户部分 ( '')，匹配任何用户。每个帐户都有一个与任何主机匹配的主机部分。然而，在连接尝试的帐户匹配中有一个优先级，因为匹配规则将主机'%'排在前面''。对于不匹配任何更具体的帐户的帐户，服务器会尝试针对 ''@'%'（匿名用户）而不是 ''@''（默认代理用户）对它们进行身份验证。因此，永远不会使用默认代理帐户。

要避免此问题，请使用以下策略之一：

一些身份验证插件为自己实现代理用户映射（例如，PAM 和 Windows 身份验证插件）。其他认证插件默认不支持代理用户。其中，一些可以请求 MySQL 服务器本身根据授予的代理权限映射代理用户：mysql_native_password， sha256_password。如果 check_proxy_users启用了系统变量，则服务器会为发出此类请求的任何身份验证插件执行代理用户映射：

例如，要启用所有上述功能，请使用my.cnf文件中的这些行启动服务器：

[mysqld]
check_proxy_users=ON
mysql_native_password_proxy_users=ON
sha256_password_proxy_users=ON

假设已启用相关系统变量，像往常一样使用创建代理用户CREATE USER，然后将其授予 PROXY其他单个帐户的权限，将其视为代理用户。当服务器收到代理用户的成功连接请求时，它会发现该用户具有PROXY 权限并使用它来确定正确的代理用户。

-- create proxy account
CREATE USER 'proxy_user'@'localhost'
  IDENTIFIED WITH mysql_native_password
  BY 'password';

-- create proxied account and grant its privileges;
-- use mysql_no_login plugin to prevent direct login
CREATE USER 'proxied_user'@'localhost'
  IDENTIFIED WITH mysql_no_login;
-- grant privileges to proxied account
GRANT ...
  ON ...
  TO 'proxied_user'@'localhost';

-- grant to proxy account the
-- PROXY privilege for proxied account
GRANT PROXY
  ON 'proxied_user'@'localhost'
  TO 'proxy_user'@'localhost';

要使用代理帐户，请使用其名称和密码连接到服务器：

$> mysql -u proxy_user -p
Enter password: (enter proxy_user password here)

身份验证成功，服务器发现 proxy_user具有 的 PROXY权限 proxied_user，会话继续 proxy_user具有 的权限 proxied_user。

服务器执行的代理用户映射受以下限制：

两个系统变量有助于跟踪代理登录过程：