keyring_aws_cmk_id

Идентификатор основного ключа клиента (CMK), полученный с сервера AWS KMS и используемый плагином keyring_aws. Эта переменная недоступна, если плагин не установлен.

Эта переменная обязательна. Если она не указана, инициализация keyring_aws завершается ошибкой.

keyring_aws_conf_file

Путь к файлу конфигурации для плагина keyring_aws. Эта переменная недоступна, если плагин не установлен.

При запуске плагина, keyring_aws считывает идентификатор и ключ секретного доступа AWS из файла конфигурации. Для успешного запуска плагина keyring_aws, файл конфигурации должен существовать и содержать корректную информацию о секретном ключе доступа, инициализированную, как описано в Разделе 6.4.4.5, «Использование плагина keyring_aws Amazon Web Services Keyring».

Имя файла по умолчанию - keyring_aws_conf, расположенный в стандартном каталоге файлов keyring. Путь к этому каталогу совпадает с каталогом для системной переменной keyring_file_data. Обратитесь к описанию этой переменной для получения подробностей и рекомендаций, если вы создаёте каталог вручную.

keyring_aws_data_file

Путь к файлу хранения для плагина keyring_aws. Эта переменная недоступна, если плагин не установлен.

При запуске плагина, если значение, присвоенное keyring_aws_data_file, указывает на файл, которого нет, плагин keyring_aws пытается создать его (а также родительский каталог, если необходимо). Если файл существует, плагин keyring_aws считывает любые зашифрованные ключи, содержащиеся в файле, в кеш оперативной памяти. Плагин keyring_aws не кэширует незашифрованные ключи в памяти.

Имя файла по умолчанию - keyring_aws_data, расположенный в стандартном каталоге файлов keyring. Путь к этому каталогу совпадает с каталогом для системной переменной keyring_file_data. Обратитесь к описанию этой переменной для получения подробностей и рекомендаций, если вы создаёте каталог вручную.

keyring_aws_region

Регион AWS для плагина keyring_aws. Эта переменная недоступна, если плагин не установлен.

keyring_encrypted_file_data

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

Операции keyring являются транзакционными: плагин keyring_encrypted_file использует резервную копию файла во время операций записи, чтобы гарантировать возможность отката к исходному файлу в случае сбоя операции. Резервный файл имеет такое же имя, как значение переменной системы keyring_encrypted_file_data с суффиксом .backup.

Не используйте один и тот же файл данных keyring_encrypted_file для нескольких экземпляров MySQL. Каждый экземпляр должен иметь свой собственный уникальный файл данных.

Имя файла по умолчанию — keyring_encrypted, расположенный в платформенно-зависимом каталоге, зависящем от значения параметра INSTALL_LAYOUT CMake, как показано в следующей таблице. Чтобы явно указать каталог по умолчанию для файла при сборке из исходного кода, используйте параметр INSTALL_MYSQLKEYRINGDIR CMake.

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

Если вы создаёте каталог вручную, он должен иметь ограниченный режим доступа и быть доступным только для учётной записи, используемой для запуска сервера MySQL. Например, в системах Unix и подобных, чтобы использовать каталог /usr/local/mysql/mysql-keyring, следующие команды (выполняемые как root) создают каталог и устанавливают его режим и права владения:

cd /usr/local/mysql
mkdir mysql-keyring
chmod 750 mysql-keyring
chown mysql mysql-keyring
chgrp mysql mysql-keyring

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

keyring_encrypted_file_password

Пароль, используемый плагином keyring_encrypted_file. Эта переменная недоступна, если этот плагин не установлен.

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

Если эта переменная указана в файле параметров, файл должен иметь ограниченный режим доступа и быть доступным только для учётной записи, используемой для запуска сервера MySQL.

Значение пароля не может быть отображено во время работы с помощью SHOW VARIABLES или таблицей Performance Schema global_variables, так как значение для отображения замаскировано.

keyring_file_data

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

Операции keyring являются транзакционными: плагин keyring_file использует резервную копию файла во время операций записи, чтобы гарантировать возможность отката к исходному файлу в случае сбоя операции. Резервный файл имеет такое же имя, как значение переменной системы keyring_file_data с суффиксом .backup.

Не используйте один и тот же файл данных keyring_file для нескольких экземпляров MySQL. Каждый экземпляр должен иметь свой собственный уникальный файл данных.

Имя файла по умолчанию — keyring, расположенный в платформенно-зависимом каталоге, зависящем от значения параметра INSTALL_LAYOUT CMake, как показано в следующей таблице. Чтобы явно указать каталог по умолчанию для файла при сборке из исходного кода, используйте параметр INSTALL_MYSQLKEYRINGDIR CMake.

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

Если вы создаёте каталог вручную, он должен иметь ограниченный режим доступа и быть доступным только для учётной записи, используемой для запуска сервера MySQL. Например, в системах Unix и подобных, чтобы использовать каталог /usr/local/mysql/mysql-keyring, следующие команды (выполняемые как root) создают каталог и устанавливают его режим и права владения:

cd /usr/local/mysql
mkdir mysql-keyring
chmod 750 mysql-keyring
chown mysql mysql-keyring
chgrp mysql mysql-keyring

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

keyring_okv_conf_dir

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

Значение по умолчанию keyring_okv_conf_dir пустое. Чтобы плагин keyring_okv смог получить доступ к Oracle Key Vault, необходимо задать путь к каталогу, содержащему конфигурацию Oracle Key Vault и материалы SSL. Инструкции по настройке этого каталога см. в разделе 6.4.4.4 «Использование плагина keyring_okv KMIP».

Каталог должен иметь ограниченный режим доступа и быть доступен только учетной записи, используемой для запуска сервера MySQL. Например, в системах Unix и подобных ей, для использования каталога /usr/local/mysql/mysql-keyring-okv, следующие команды (выполняемые как root) создают каталог, задают его режим и права владения:

cd /usr/local/mysql
mkdir mysql-keyring-okv
chmod 750 mysql-keyring-okv
chown mysql mysql-keyring-okv
chgrp mysql mysql-keyring-okv

Если значение, присвоенное keyring_okv_conf_dir, указывает на несуществующий каталог или каталог, не содержащий конфигурационной информации, необходимой для подключения к Oracle Key Vault, keyring_okv записывает сообщение об ошибке в лог ошибок. Если попытка присвоения значения keyring_okv_conf_dir во время выполнения приведет к ошибке, значение переменной и операция keyring останутся неизменными.

keyring_operations

Включены ли операции keyring. Эта переменная используется во время миграции ключей. См. раздел 6.4.4.7 «Миграция ключей между хранилищами ключей keyring».