Этот раздел описывает, как установить модуль аутентификации через сокет. Для получения общей информации об установке модулей см. Раздел 7.6.1, «Установка и удаление модулей».

Для использования сервером, файл библиотеки модуля должен находиться в каталоге модулей MySQL (каталог, указанный переменной системы plugin_dir). При необходимости, настройте расположение каталога модулей, задав значение plugin_dir при запуске сервера.

Чтобы загрузить модуль при запуске сервера, используйте параметр --plugin-load-add для указания имени файла библиотеки, содержащей модуль. С этим методом загрузки модулей, параметр должен быть указан каждый раз при запуске сервера. Например, поместите эти строки в файл сервера my.cnf:

[mysqld]
plugin-load-add=auth_socket.so

После изменения my.cnf перезапустите сервер, чтобы новые настройки вступили в силу.

В качестве альтернативы, для загрузки модуля во время выполнения используйте это утверждение:

INSTALL PLUGIN auth_socket SONAME 'auth_socket.so';

INSTALL PLUGIN загружает модуль немедленно, а также регистрирует его в таблице системы mysql.plugins, чтобы заставить сервер загрузить его для каждого последующего обычного запуска без необходимости в --plugin-load-add.

Для проверки установки модуля, изучите таблицу Information Schema PLUGINS или используйте утверждение SHOW PLUGINS (см. Раздел 7.6.2, «Получение информации о модуле сервера»). Например:

mysql> SELECT PLUGIN_NAME, PLUGIN_STATUS
       FROM INFORMATION_SCHEMA.PLUGINS
       WHERE PLUGIN_NAME LIKE '%socket%';
+-------------+---------------+
| PLUGIN_NAME | PLUGIN_STATUS |
+-------------+---------------+
| auth_socket | ACTIVE        |
+-------------+---------------+

Если модуль не удается инициализировать, проверьте журнал ошибок сервера на наличие диагностических сообщений.

Для привязки учетных записей MySQL к модулю сокета см. Использование подключаемой аутентификации через сокеты.

Метод удаления подключаемого модуля аутентификации через сокет зависит от способа его установки:

Модуль сокета проверяет, соответствует ли имя пользователя сокета (имя пользователя операционной системы) имени пользователя MySQL, указанному клиентской программой серверу. Если имена не совпадают, модуль проверяет, соответствует ли имя пользователя сокета имени, указанному в столбце authentication_string строки таблицы системы mysql.user. Если совпадение найдено, модуль разрешает подключение. Значение authentication_string может быть указано с помощью предложения IDENTIFIED ...AS с оператором CREATE USER или ALTER USER.

Предположим, что для пользователя операционной системы с именем valerie создана учетная запись MySQL, которая должна аутентифицироваться модулем auth_socket для подключений с локального хоста через файл сокета:

CREATE USER 'valerie'@'localhost' IDENTIFIED WITH auth_socket;

Если пользователь на локальном хосте с именем входа stefanie вызывает mysql с параметром --user=valerie для подключения через файл сокета, сервер использует auth_socket для аутентификации клиента. Модуль определяет, что значение параметра --user (valerie) отличается от имени пользователя клиента (stephanie) и отклоняет подключение. Если пользователь с именем valerie попробует то же самое, модуль обнаружит, что имя пользователя и имя пользователя MySQL оба равны valerie и разрешит подключение. Однако модуль отклоняет подключение даже для valerie, если подключение выполняется с использованием другого протокола, например, TCP/IP.

Чтобы разрешить как пользователю valerie, так и пользователю stephanie операционной системы доступ к MySQL через подключения к файлам сокета, которые используют учетную запись, это можно сделать двумя способами:

Для доступа к учетной записи как valerie, так и stephanie указаны --user=valerie при подключении.