使用用于所有服务器插件类型的常用通用描述符格式声明服务器端插件（请参阅第 4.4.2.1 节，“服务器插件库和插件描述符”）。对于 auth_simple插件，描述符如下所示：

mysql_declare_plugin(auth_simple)
{
  MYSQL_AUTHENTICATION_PLUGIN,
  &auth_simple_handler,                 /* type-specific descriptor */
  "auth_simple",                        /* plugin name */
  "Author Name",                        /* author */
  "Any-password authentication plugin", /* description */
  PLUGIN_LICENSE_GPL,                   /* license type */
  NULL,                                 /* no init function */
  NULL,                                 /* no deinit function */
  0x0100,                               /* version = 1.0 */
  NULL,                                 /* no status variables */
  NULL,                                 /* no system variables */
  NULL,                                 /* no reserved information */
  0                                     /* no flags */
}
mysql_declare_plugin_end;

name成员 ( ) 表示在or auth_simple等​​语句中用于引用插件的 名称。这也是或 显示的名称。 INSTALL PLUGINUNINSTALL PLUGINSHOW PLUGINSINFORMATION_SCHEMA.PLUGINS

通用描述符的auth_simple_handler成员指向特定类型的描述符。对于身份验证插件，特定于类型的描述符是st_mysql_auth 结构的一个实例（在中定义plugin_auth.h）：

struct st_mysql_auth
{
  int interface_version;
  const char *client_auth_plugin;
  int (*authenticate_user)(MYSQL_PLUGIN_VIO *vio, MYSQL_SERVER_AUTH_INFO *info);
  int (*generate_authentication_string)(char *outbuf,
      unsigned int *outbuflen, const char *inbuf, unsigned int inbuflen);
  int (*validate_authentication_string)(char* const inbuf, unsigned int buflen);
  int (*set_salt)(const char *password, unsigned int password_len,
                  unsigned char* salt, unsigned char *salt_len);
  const unsigned long authentication_flags;
};

该st_mysql_auth结构具有以下成员：

client_auth_plugin如果需要特定插件， 该成员应指明客户端插件的名称。值NULL表示 “任何插件。”在后一种情况下，客户端使用的任何插件都可以。如果服务器插件不关心客户端插件或它发送的用户名或密码，这很有用。例如，如果服务器插件仅对本地客户端进行身份验证并使用操作系统的某些属性而不是客户端插件发送的信息，则可能是这样。

对于auth_simple，特定于类型的描述符如下所示：

static struct st_mysql_auth auth_simple_handler =
{
  MYSQL_AUTHENTICATION_INTERFACE_VERSION,
  "auth_simple",             /* required client-side plugin name */
  auth_simple_server         /* server-side plugin main function */
  generate_auth_string_hash, /* generate digest from password string */
  validate_auth_string_hash, /* validate password digest */
  set_salt,                  /* generate password salt value */
  AUTH_FLAG_PRIVILEGED_USER_FOR_PASSWORD_CHANGE
};

主函数auth_simple_server()有两个参数，分别代表一个 I/O 结构和一个 MYSQL_SERVER_AUTH_INFO结构。在 中找到的结构定义 plugin_auth.h如下所示：

typedef struct st_mysql_server_auth_info
{
  char *user_name;
  unsigned int user_name_length;
  const char *auth_string;
  unsigned long auth_string_length;
  char authenticated_as[MYSQL_USERNAME_LENGTH+1];
  char external_user[512];
  int  password_used;
  const char *host_or_ip;
  unsigned int host_or_ip_length;
} MYSQL_SERVER_AUTH_INFO;

字符串成员的字符集是 UTF-8。如果有 _length与字符串相关联的成员，则表示字符串长度（以字节为单位）。字符串也是空终止的。

当服务器调用身份验证插件时，它应该 MYSQL_SERVER_AUTH_INFO按如下方式解释结构成员。如所示，其中一些用于在客户端会话中设置 SQL 函数或系统变量的值。

主auth_simple函数 ， auth_simple_server()从客户端读取密码（一个以 null 结尾的字符串），如果密码为非空（第一个字节不为空）则成功：

static int auth_simple_server (MYSQL_PLUGIN_VIO *vio,
                               MYSQL_SERVER_AUTH_INFO *info)
{
  unsigned char *pkt;
  int pkt_len;

  /* read the password as null-terminated string, fail on error */
  if ((pkt_len= vio->read_packet(vio, &pkt)) < 0)
    return CR_ERROR;

  /* fail on empty password */
  if (!pkt_len || *pkt == '\0')
  {
    info->password_used= PASSWORD_USED_NO;
    return CR_ERROR;
  }

  /* accept any nonempty password */
  info->password_used= PASSWORD_USED_YES;

  return CR_OK;
}

主函数应返回下表中显示的错误代码之一。

有关握手如何工作的示例，请参阅 plugin/auth/dialog.c源文件。

host_cache服务器计算 Performance Schema表 中的插件错误 。

auth_simple_server()非常基础，除了设置指示是否收到密码的成员外，它不使用身份验证信息结构。

支持代理用户的插件必须向服务器返回代理用户的名称（客户端用户应获得其特权的 MySQL 用户）。为此，插件必须将 info->authenticated_as成员设置为代理用户名。有关代理的信息，请参阅 代理用户和 第 4.4.9.4 节，“在身份验证插件中实现代理用户支持”。

插件描述符的generate_authentication_string成员获取密码并从中生成密码哈希（摘要）：

对于auth_simple插件， generate_auth_string_hash()函数实现 generate_authentication_string成员。它只是复制密码，除非它太长而无法放入输出缓冲区。

int generate_auth_string_hash(char *outbuf, unsigned int *buflen,
                              const char *inbuf, unsigned int inbuflen)
{
  /*
    fail if buffer specified by server cannot be copied to output buffer
  */
  if (*buflen < inbuflen)
    return 1;   /* error */
  strncpy(outbuf, inbuf, inbuflen);
  *buflen= strlen(inbuf);
  return 0;     /* success */
}

插件描述符的validate_authentication_string成员验证密码哈希：

对于auth_simple插件， validate_auth_string_hash()函数实现 validate_authentication_string成员。它无条件返回成功：

int validate_auth_string_hash(char* const inbuf  __attribute__((unused)),
                              unsigned int buflen  __attribute__((unused)))
{
  return 0;     /* success */
}

插件描述符的set_salt成员仅由 mysql_native_password插件使用（请参阅 Native Pluggable Authentication）。对于其他身份验证插件，您可以使用这个简单的实现：

int set_salt(const char* password __attribute__((unused)),
             unsigned int password_len __attribute__((unused)),
             unsigned char* salt __attribute__((unused)),
             unsigned char* salt_len)
{
  *salt_len= 0;
  return 0;     /* success */
}

插件描述符的authentication_flags成员包含影响插件操作的标志。允许的标志是：