Потребителям службы keyring необходимо установить компонент или плагин keyring:

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

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

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

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

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

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

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

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

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

После выполнения всех специфичных для компонента настроек запустите сервер. Проверьте установку компонента, просмотрев таблицу 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 может получить доступ только к незашифрованным табличным пространствам.