모든 서버 플러그 인 타입에 사용되는 보통의 일반 기술자 형식을 사용하여 서버 측 플러그인을 선언합니다 ( 섹션 24.2.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 멤버 ( auth_simple )는 INSTALL PLUGIN , UNINSTALL PLUGIN 등의 문에서 플러그인을 참조하는 데 사용할 이름을 지정합니다. 이것은 SHOW PLUGINS 또는 INFORMATION_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);
};

st_mysql_auth 구조는 세 멤버 (유형별 API 버전 번호 클라이언트 플러그인 이름 및 클라이언트와 통신하는 기본 플러그인 함수 포인터)가 있습니다. 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 */
};

메인 함수는 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 멤버가있는 경우, 이것은 바이트 단위의 문자열 길이를 나타냅니다. 문자열을 NULL로 끝납니다.

서버에서 인증 플러그인이 호출되면 MYSQL_SERVER_AUTH_INFO 구조체 멤버가 다음과 같이 해석됩니다. 이 부분은 설명 된대로 클라이언트 세션의 SQL 함수 또는 시스템 변수의 값을 설정하는 데 사용됩니다.

auth_simple 의 메인 함수 auth_simple_server() 는 클라이언트의 암호 (NULL로 끝나는 문자열)를 읽고 암호가 비어 있지 않은 (선두 바이트가 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 소스 파일을 참조하십시오.

CR_ERROR 에 계속 오류 코드는 MySQL 5.6.5에서 사용할 수 있습니다. 서버는 MySQL 5.6.5 이후에 사용할 수있는 성능 스키마 host_cache 테이블의 플러그인 오류를 계산합니다.

auth_simple_server_main() 는 매우 기본적인 것이기 때문에 암호를 받았는지 여부를 나타내는 멤버를 설정하는 것을 제외하고, 인증 정보 구조를 사용하지 않습니다.

프록시 사용자를 지원하는 플러그인은 프록시 설정되어있는 사용자 (클라이언트 사용자가 얻을 수있는 권한이있는 MySQL 사용자)의 이름을 서버에 반환해야합니다. 이렇게하려면 플러그인은 프록시 설정되는 사용자 이름을 info->authenticated_as 멤버로 설정해야합니다. 프록시 설정 내용은 섹션 6.3.9 "프록시 사용자" 및 섹션 24.2.4.9.4 "인증 플러그인에서 프록시 사용자 지원 구현" 을 참조하십시오.

mysql_declare_client_plugin() 매크로 및 mysql_end_client_plugin 매크로를 사용하여 클라이언트 플러그인 디스크립터를 선언합니다 ( 섹션 24.2.4.2.3 "클라이언트 플러그인 기술자" 를 참조하십시오). auth_simple 플러그인의 경우 기술자는 다음과 같이됩니다.

mysql_declare_client_plugin(AUTHENTICATION)
  "auth_simple",                        /* plugin name */
  "Author Name",                        /* author */
  "Any-password authentication plugin", /* description */
  {1,0,0},                              /* version = 1.0.0 */
  "GPL",                                /* license type */
  NULL,                                 /* for internal use */
  NULL,                                 /* no init function */
  NULL,                                 /* no deinit function */
  NULL,                                 /* no option-handling function */
  auth_simple_client                    /* main function */
mysql_end_client_plugin;

플러그인 이름에서 옵션 처리 함수까지 기술자 멤버는 모든 클라이언트 플러그인 유형에서 공통적 있습니다. (설명은 섹션 24.2.4.2.3 "클라이언트 플러그인 기술자" 를 참조하십시오.) 일반 회원에 따라,이 기술자는 인증 플러그 인에 고유의 추가 멤버가 있습니다. 이것은 '기본'함수이며, 서버와의 통신을 처리합니다. 이 함수는 I / O 구조와 연결 처리기를 나타내는 2 개의 인수를 취합니다. 임의 암호를 지정할 수이 간단한 플러그인은 메인 함수는 사용자가 지정한 암호를 서버에 쓸뿐입니다.

static int auth_simple_client (MYSQL_PLUGIN_VIO *vio, MYSQL *mysql)
{
  int res;

  /* send password as null-terminated string in clear text */
  res= vio->write_packet(vio, (const unsigned char *) mysql->passwd, 
                         strlen(mysql->passwd) + 1);

  return res ? CR_ERROR : CR_OK;
}

주요 기능은 다음 표에 나열된 중 하나의 오류 코드를 돌려줍니다.

CR_OK_HANDSHAKE_COMPLETE 는 클라이언트가 자신의 역할을 성공적으로 완료하고 마지막 패킷을 읽은 것을 나타냅니다. 인증 프로토콜 왕복 횟수가 사전에 알려져 있지 않고, 인증이 완료되었는지 여부를 판별하기 위해 플러그인이 다른 패킷을 읽을 필요가있는 경우 클라이언트 플러그인이 CR_OK_HANDSHAKE_COMPLETE 을 반환 할 수 있습니다.

플러그인 라이브러리의 오브젝트 파일을 컴파일 및 설치하려면 섹션 24.2.4.3 "플러그인 라이브러리의 컴파일 및 설치" 단계를 참조하십시오. 라이브러리 파일을 사용하려면 라이브러리 파일이 플러그인 디렉토리 ( plugin_dir 시스템 변수에 지정된 디렉토리)에 설치되어 있어야합니다.

서버 측 플러그인을 서버에 등록합니다. 예를 들어, 플러그인 서버 시작시로드하려면 --plugin-load=auth_simple.so 옵션을 사용합니다 (시스템에서 필요한 경우 라이브러리 지원 설비를 변경합니다).

서버가 인증을 위해 auth_simple 플러그인을 사용하려는 사용자를 만듭니다.

mysql> CREATE USER 'x'@'localhost'
    -> IDENTIFIED WITH auth_simple;

클라이언트 프로그램을 사용하여 사용자 x 로 서버에 연결합니다. 서버 측의 auth_simple 플러그인은 클라이언트 측 auth_simple 플러그인을 사용하는 클라이언트 프로그램과 통신, 후자는 서버에 암호를 보냅니다. 서버는 빈 암호를 보내 연결을 거부하고 비어 있지 않은 암호를 전송하는 연결을 허용합니다. 이를 검증하기 위해 각각의 방식으로 클라이언트 프로그램을 시작합니다.

shell> mysql --user=x --skip-password
ERROR 1045 (28000): Access denied for user 'x'@'localhost' (using password: NO)

shell> mysql --user=x --password=abc
mysql>

이 서버 플러그인은 비어 있지 않은 암호를 모두 허용하므로 안전하지 않은 것으로 간주됩니다. 플러그인을 테스트하고 플러그인이 작동하는지 확인한 후 모르고 안전하지 않은 인증 플러그인이로드 된 상태에서 서버가 실행됩니다 계속 않도록 --plugin-load 옵션을 지정하지 않고 서버를 다시 시작합니다. 또한 DROP USER 'x'@'localhost' 를 사용하여 사용자를 삭제합니다.

인증 플러그인로드 및 사용에 대한 자세한 내용은 섹션 5.1.8.1 "플러그인 설치 및 제거" 및 섹션 6.3.7 "플러그 인증" 을 참조하십시오.

인증 플러그인의 사용을 지원하는 클라이언트 프로그램을 작성하는 경우, 일반적으로 이러한 프로그램은 mysql_options() 를 호출 MYSQL_DEFAULT_AUTH 옵션 및 MYSQL_PLUGIN_DIR 옵션을 설정하여 플러그인을로드합니다.

char *plugin_dir = "path_to_plugin_dir";
char *default_auth = "plugin_name";

/* ... process command-line options ... */

mysql_options(&mysql, MYSQL_PLUGIN_DIR, plugin_dir);
mysql_options(&mysql, MYSQL_DEFAULT_AUTH, default_auth);

일반적으로 프로그램은 사용자가 기본값을 대체 할 수있는 --plugin-dir 및 --default-auth 옵션도 사용할 수 있습니다.

클라이언트 프로그램에서 낮은 수준의 플러그인 관리가 필요한 경우 클라이언트 라이브러리에 st_mysql_client_plugin 인수를 함수를 포함합니다. 섹션 23.8.14 "C API 클라이언트 플러그인 함수" 를 참조하십시오.

플러그 인증에서 사용할 수있게되는 기능 중 하나는 프록시 사용자입니다 ( 섹션 6.3.9 "프록시 사용자" 를 참조하십시오). 서버 측 인증 플러그인에서 프록시 사용자가 지원되도록하려면 다음의 조건을 충족해야합니다.

즉, 플러그인에 필요한 프록시 사용자 지원의 특성은 프록시 설정되는 사용자 이름을 authenticated_as 에 설정할뿐입니다. 다른 옵션인지 ( external_user 설정) SQL 문을 사용하여 DBA가합니다.

인증 플러그인은 프록시 사용자가 접속했을 때 반환 프록시 설정되어있는 사용자를 어떻게 결정하는 것일까 요. 이것은 플러그인에 따라 다릅니다. 일반적으로 플러그인은 서버에서 전달 된 인증 문자열에 따라 클라이언트를 프록시 설정되어있는 사용자에 매핑합니다. 이 문자열은 인증 플러그인을 사용하도록 지정하는 CREATE USER 문 IDENTIFIED WITH 절 AS 부분에 지정됩니다.

플러그인 개발자는 인증 문자열의 구문 규칙을 결정하고 이러한 규칙에 따라 플러그인을 구현합니다. 외부 사용자를 MySQL 사용자에 매핑하는 쉼표로 구분 된 목록의 쌍을 플러그인을받을합니다. 예 :

CREATE USER ''@'%.example.com'
  IDENTIFIED WITH my_plugin AS 'extuser1=mysqlusera, extuser2=mysqluserb'
CREATE USER ''@'%.example.org'
  IDENTIFIED WITH my_plugin AS 'extuser1=mysqluserc, extuser2=mysqluserd'

서버 플러그인을 시작하여 클라이언트를 인증 할 때 적절한 인증 문자열을 플러그인에 전달합니다. 플러그인은 다음 역할이 있습니다.

예를 들어, example.com 호스트에서 extuser2 연결하는 경우 서버는 'extuser1=mysqlusera, extuser2=mysqluserb' 를 플러그인에 전달 플러그인은 mysqluserb 종단의 NULL 바이트를 부가 해 authenticated_as 에 복사합니다. example.org 호스트에서 extuser2 연결하는 경우 서버는 'extuser1=mysqluserc, extuser2=mysqluserd' 을 전달 플러그인 대신 mysqluserd 를 복사합니다.

매핑에 일치하는 것이없는 경우의 조치는 플러그인에 따라 다릅니다. 일치하는 것이있을 필요가있을 때, 많은 경우 플러그인은 오류를 반환합니다. 또는 플러그인이 단순히 클라이언트 이름을 반환 할 수 있으며,이 경우 플러그인은 authenticated_as 을 변경하지 않고, 서버는 클라이언트를 프록시로 처리하지 않습니다.

다음 예제에서는 auth_simple_proxy 라는 플러그인을 사용하여 프록시 사용자를 처리하는 방법을 보여줍니다. 앞에서 언급 한 auth_simple 플러그인처럼 auth_simple_proxy 는 비어 있지 않은 모든 암호를 유효한 것으로 받아들입니다 (따라서 프로덕션 환경에서 사용하지 마십시오). 이것은 또한 auth_string 인증 문자열 멤버를 검사하고 다음 매우 간단한 규칙을 사용하여이를 해석합니다.

테스트를 위해 위의 규칙에 따라 프록시 설정되지 않은 하나의 계정 및 프록시 설정되는 하나의 계정을 설정합니다. 이것은 하나의 계정에 AS 절이없이 다른 계정에 프록시 설정되어있는 사용자를 지정하는 AS 절이 있다는 것을 의미합니다.

CREATE USER 'plugin_user1'@'localhost'
  IDENTIFIED WITH auth_simple_proxy;
CREATE USER 'plugin_user2'@'localhost'
  IDENTIFIED WITH auth_simple_proxy AS 'proxied_user';

또한 프록시 설정되는 사용자 계정을 만들고 해당 계정에 대한 PROXY 권한을 plugin_user2 에 부여합니다.

CREATE USER 'proxied_user'@'localhost'
  IDENTIFIED BY 'proxied_user_pass';
GRANT PROXY
  ON 'proxied_user'@'localhost'
  TO 'plugin_user2'@'localhost';

서버는 인증 플러그인을 호출하기 전에 authenticated_as 클라이언트 사용자 이름을 설정합니다. 사용자가 프록시임을 표시하기 위해 플러그인은 프록시 설정되는 사용자 이름을 authenticated_as 로 설정합니다. auth_simple_proxy 의 경우 이것은 auth_string 값을 검사하여 값이 비어 있지 않은 경우 값을 authenticated_as 멤버에 복사하여 프록시 설정되어있는 사용자의 이름으로 그것을 돌려 줄 필요가 있다는 것을 의미합니다. 또한 프록시 설정을하는 경우 플러그인은 external_user 회원 클라이언트 사용자 이름을 설정하고 이것이 external_user 시스템 변수의 값입니다.

static int auth_simple_proxy_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;

  /* if authentication string is nonempty, use as proxied user name */
  /* and use client name as external_user value */
  if (info->auth_string_length > 0)
  {
    strcpy (info->authenticated_as, info->auth_string);
    strcpy (info->external_user, info->user_name);
  }

  return CR_OK;
}

연결이 성공하면 USER() 함수는 연결된 클라이언트 사용자와 호스트 이름을 나타내고, CURRENT_USER() 는 세션에 적용되는 권한을 가진 계정을 나타냅니다. 후자의 값은 프록시 설정이되지 않는 경우 연결 사용자 계정 및 프록시 설정이 이루어진 경우 프록시 설정되는 계정입니다.

플러그인을 컴파일 및 설치하여 테스트합니다. 첫째, plugin_user1 로 연결합니다.

shell> mysql --user=plugin_user1 --password=x

이 경우 프록시 설정되지 않습니다.

mysql> SELECT USER(), CURRENT_USER(), @@proxy_user, @@external_user\G
*************************** 1. row ***************************
         USER(): plugin_user1@localhost
 CURRENT_USER(): plugin_user1@localhost
   @@proxy_user: NULL
@@external_user: NULL

그런 plugin_user2 로 연결합니다.

shell> mysql --user=plugin_user2 --password=x

이 경우 plugin_user2 는 proxied_user 에 대해 프록시 설정됩니다.

mysql> SELECT USER(), CURRENT_USER(), @@proxy_user, @@external_user\G
*************************** 1. row ***************************
         USER(): plugin_user2@localhost
 CURRENT_USER(): proxied_user@localhost
   @@proxy_user: 'plugin_user2'@'localhost'
@@external_user: 'plugin_user2'@'localhost'