Потребителям сервиса хранилища ключей требуется установка компонента или плагина хранилища ключей:

MySQL предоставляет следующие варианты компонентов хранилища ключей:

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

Компонент или плагин хранилища ключей должен быть загружен на ранней стадии последовательности запуска сервера, чтобы другие компоненты могли получить к нему доступ по мере необходимости во время собственной инициализации. Например, движок хранения данных InnoDB использует хранилище ключей для шифрования табличных пространств, поэтому компонент или плагин хранилища ключей должен быть загружен и доступен до инициализации InnoDB.

В отличие от плагинов хранилища ключей, компоненты хранилища ключей не загружаются с помощью опции сервера --early-plugin-load или настраиваются с помощью переменных системы. Вместо этого сервер определяет, какой компонент хранилища ключей загрузить во время запуска, используя манифест, а загруженный компонент обращается к своему собственному файлу конфигурации при инициализации. Поэтому для установки компонента хранилища ключей необходимо:

Первым шагом в установке компонента хранилища ключей является написание манифеста, указывающего, какой компонент загрузить. Во время запуска сервер пытается прочитать либо глобальный манифест, либо глобальный манифест в паре с локальным манифестом:

Локальные манифестные файлы позволяют настроить загрузку компонентов для нескольких экземпляров сервера, при этом инструкции по загрузке для каждого экземпляра сервера специфичны для данного экземпляра каталога данных. Это позволяет разным экземплярам MySQL использовать различные компоненты хранилища ключей.

Файлы манифеста сервера имеют следующие свойства:

Учитывая вышеперечисленные свойства файла манифеста, для настройки сервера на загрузку component_keyring_file создайте глобальный манифестный файл под названием mysqld.my в каталоге установки mysqld, и, необязательно, создайте локальный манифестный файл, также с именем mysqld.my, в каталоге данных. Следующие инструкции описывают, как загрузить component_keyring_file. Чтобы загрузить другой компонент хранилища ключей, замените его имя на component_keyring_file.

После того, как манифест готов, переходите к настройке компонента хранилища ключей. Для этого ознакомьтесь с примечаниями к выбранному компоненту хранилища ключей, чтобы получить инструкции по настройке, специфичные для этого компонента:

После выполнения любой настройки, специфичной для компонента, запустите сервер. Проверьте установку компонента, изучив таблицу Performance Schema keyring_component_status:

mysql> SELECT * FROM performance_schema.keyring_component_status;
+---------------------+-------------------------------------------------+
| STATUS_KEY          | STATUS_VALUE                                    |
+---------------------+-------------------------------------------------+
| Component_name      | component_keyring_file                          |
| Author              | Oracle Corporation                              |
| License             | GPL                                             |
| Implementation_name | component_keyring_file                          |
| Version             | 1.0                                             |
| Component_status    | Active                                          |
| Data_file           | /usr/local/mysql/keyring/component_keyring_file |
| Read_only           | No                                              |
+---------------------+-------------------------------------------------+

Значение Component_status равное Active указывает на успешную инициализацию компонента.

Если компонент невозможно загрузить, запуск сервера завершается неудачей. Проверьте журнал ошибок сервера на наличие диагностических сообщений. Если компонент загружается, но не может быть инициализирован из-за проблем с конфигурацией, сервер запускается, но значение Component_status равно Disabled. Проверьте журнал ошибок сервера, устраните проблемы с конфигурацией и используйте оператор ALTER INSTANCE RELOAD KEYRING для перезагрузки конфигурации.

Компоненты Keyring должны загружаться только с помощью файла манифеста, а не с помощью оператора INSTALL COMPONENT. Компоненты Keyring, загруженные с помощью этого оператора, могут быть доступны слишком поздно в процессе запуска сервера для некоторых компонентов, использующих Keyring, таких как InnoDB, поскольку они зарегистрированы в таблице системы mysql.component и загружаются автоматически для последующих перезапусков сервера. Но mysql.component — это таблица InnoDB, поэтому любые компоненты, указанные в ней, могут загружаться во время запуска только после инициализации InnoDB.

Если при попытке доступа к службе Keyring компонентом нет доступного компонента Keyring или плагина, то эта служба не может быть использована этим компонентом. В результате компонент может не пройти инициализацию или пройти инициализацию с ограниченными функциями. Например, если InnoDB обнаруживает зашифрованные табличные пространства при инициализации, он пытается получить доступ к Keyring. Если Keyring недоступен, InnoDB может получить доступ только к незашифрованным табличным пространствам.