MySQL 金鑰環外掛程式支援下列系統變數。使用它們來設定金鑰環外掛程式的操作。除非安裝適當的金鑰環外掛程式,否則這些變數不可用(請參閱第 8.4.4.3 節,金鑰環外掛程式安裝)。
-
命令列格式 --keyring-aws-cmk-id=值
系統變數 keyring_aws_cmk_id
範圍 全域 動態 是 SET_VAR
提示套用否 類型 字串 從 AWS KMS 伺服器取得並由
keyring_aws
外掛程式使用的 KMS 金鑰 ID。除非安裝該外掛程式,否則此變數不可用。此變數為必要項目。如果未指定,
keyring_aws
初始化將會失敗。 -
命令列格式 --keyring-aws-conf-file=檔案名稱
系統變數 keyring_aws_conf_file
範圍 全域 動態 否 SET_VAR
提示套用否 類型 檔案名稱 預設值 平台特定
keyring_aws
外掛程式的設定檔位置。除非安裝該外掛程式,否則此變數不可用。在外掛程式啟動時,
keyring_aws
會從設定檔讀取 AWS 秘密存取金鑰 ID 和金鑰。為了讓keyring_aws
外掛程式成功啟動,設定檔必須存在,並包含有效的秘密存取金鑰資訊,依照第 8.4.4.7 節,「使用 keyring_aws Amazon Web Services 金鑰環外掛程式」中所述的方式初始化。預設檔案名稱為
keyring_aws_conf
,位於預設金鑰環檔案目錄中。 -
命令列格式 --keyring-aws-data-file
系統變數 keyring_aws_data_file
範圍 全域 動態 否 SET_VAR
提示套用否 類型 檔案名稱 預設值 平台特定
keyring_aws
外掛程式的儲存檔案位置。除非安裝該外掛程式,否則此變數不可用。在外掛程式啟動時,如果指派給
keyring_aws_data_file
的值指定不存在的檔案,則keyring_aws
外掛程式會嘗試建立它(以及其父目錄,如有需要)。如果檔案存在,keyring_aws
會將檔案中包含的任何加密金鑰讀取到其記憶體快取中。keyring_aws
不會將未加密的金鑰快取在記憶體中。預設檔案名稱為
keyring_aws_data
,位於預設金鑰環檔案目錄中。 -
命令列格式 --keyring-aws-region=值
系統變數 keyring_aws_region
範圍 全域 動態 是 SET_VAR
提示套用否 類型 列舉 預設值 us-east-1
有效值 af-south-1
ap-east-1
ap-northeast-1
ap-northeast-2
ap-northeast-3
ap-south-1
ap-southeast-1
ap-southeast-2
ca-central-1
cn-north-1
cn-northwest-1
eu-central-1
eu-north-1
eu-south-1
eu-west-1
eu-west-2
eu-west-3
me-south-1
sa-east-1
us-east-1
us-east-2
us-gov-east-1
us-iso-east-1
us-iso-west-1
us-isob-east-1
us-west-1
us-west-2
用於
keyring_aws
外掛程式的 AWS 區域。除非已安裝該外掛程式,否則此變數不可用。 -
命令列格式 --keyring-hashicorp-auth-path=value
系統變數 keyring_hashicorp_auth_path
範圍 全域 動態 是 SET_VAR
提示套用否 類型 字串 預設值 /v1/auth/approle/login
在 HashiCorp Vault 伺服器中啟用 AppRole 身份驗證的身份驗證路徑,供
keyring_hashicorp
外掛程式使用。除非已安裝該外掛程式,否則此變數不可用。 -
命令列格式 --keyring-hashicorp-ca-path=file_name
系統變數 keyring_hashicorp_ca_path
範圍 全域 動態 是 SET_VAR
提示套用否 類型 檔案名稱 預設值 空字串
MySQL 伺服器可存取的本機檔案的絕對路徑名稱,其中包含
keyring_hashicorp
外掛程式使用的格式正確的 TLS 憑證授權單位。除非已安裝該外掛程式,否則此變數不可用。如果未設定此變數,則
keyring_hashicorp
外掛程式會開啟 HTTPS 連線而不使用伺服器憑證驗證,並信任 HashiCorp Vault 伺服器傳送的任何憑證。為了確保安全,必須假設 Vault 伺服器不是惡意的,並且不可能發生中間人攻擊。如果這些假設無效,請將keyring_hashicorp_ca_path
設定為受信任的 CA 憑證的路徑。(例如,對於憑證和金鑰準備中的說明,這是company.crt
檔案。) -
命令列格式 --keyring-hashicorp-caching[={OFF|ON}]
系統變數 keyring_hashicorp_caching
範圍 全域 動態 是 SET_VAR
提示套用否 類型 布林值 預設值 OFF
是否啟用
keyring_hashicorp
外掛程式使用的選用記憶體內金鑰快取,以快取來自 HashiCorp Vault 伺服器的金鑰。除非已安裝該外掛程式,否則此變數不可用。如果啟用快取,外掛程式會在初始化期間填入快取。否則,外掛程式只會在初始化期間填入金鑰清單。啟用快取是一種折衷方案:它可以提高效能,但在記憶體中保留敏感金鑰資訊的副本,這可能不利於安全性。
keyring_hashicorp_commit_auth_path
系統變數 keyring_hashicorp_commit_auth_path
範圍 全域 動態 否 SET_VAR
提示套用否 類型 字串 此變數與
keyring_hashicorp_auth_path
相關聯,它在keyring_hashicorp
外掛程式初始化期間從該變數取得其值。除非已安裝該外掛程式,否則此變數不可用。如果初始化成功,它會反映實際用於外掛程式操作的「已提交」值。如需其他資訊,請參閱 keyring_hashicorp 設定。keyring_hashicorp_commit_ca_path
系統變數 keyring_hashicorp_commit_ca_path
範圍 全域 動態 否 SET_VAR
提示套用否 類型 字串 此變數與
keyring_hashicorp_ca_path
相關聯,它在keyring_hashicorp
外掛程式初始化期間從該變數取得其值。除非已安裝該外掛程式,否則此變數不可用。如果初始化成功,它會反映實際用於外掛程式操作的「已提交」值。如需其他資訊,請參閱 keyring_hashicorp 設定。keyring_hashicorp_commit_caching
系統變數 keyring_hashicorp_commit_caching
範圍 全域 動態 否 SET_VAR
提示套用否 類型 字串 此變數與
keyring_hashicorp_caching
相關聯,它在keyring_hashicorp
外掛程式初始化期間從該變數取得其值。除非已安裝該外掛程式,否則此變數不可用。如果初始化成功,它會反映實際用於外掛程式操作的「已提交」值。如需其他資訊,請參閱 keyring_hashicorp 設定。keyring_hashicorp_commit_role_id
系統變數 keyring_hashicorp_commit_role_id
範圍 全域 動態 否 SET_VAR
提示套用否 類型 字串 此變數與
keyring_hashicorp_role_id
相關聯,它在keyring_hashicorp
外掛程式初始化期間從該變數取得其值。除非已安裝該外掛程式,否則此變數不可用。如果初始化成功,它會反映實際用於外掛程式操作的「已提交」值。如需其他資訊,請參閱 keyring_hashicorp 設定。keyring_hashicorp_commit_server_url
系統變數 keyring_hashicorp_commit_server_url
範圍 全域 動態 否 SET_VAR
提示套用否 類型 字串 此變數與
keyring_hashicorp_server_url
相關聯,它在keyring_hashicorp
外掛程式初始化期間從該變數取得其值。除非已安裝該外掛程式,否則此變數不可用。如果初始化成功,它會反映實際用於外掛程式操作的「已提交」值。如需其他資訊,請參閱 keyring_hashicorp 設定。keyring_hashicorp_commit_store_path
系統變數 keyring_hashicorp_commit_store_path
範圍 全域 動態 否 SET_VAR
提示套用否 類型 字串 此變數與
keyring_hashicorp_store_path
相關聯,它在keyring_hashicorp
外掛程式初始化期間從該變數取得其值。除非已安裝該外掛程式,否則此變數不可用。如果初始化成功,它會反映實際用於外掛程式操作的「已提交」值。如需其他資訊,請參閱 keyring_hashicorp 設定。-
命令列格式 --keyring-hashicorp-role-id=value
系統變數 keyring_hashicorp_role_id
範圍 全域 動態 是 SET_VAR
提示套用否 類型 字串 預設值 空字串
HashiCorp Vault AppRole 身份驗證角色 ID,供
keyring_hashicorp
外掛程式使用。除非已安裝該外掛程式,否則此變數不可用。值必須為 UUID 格式。此變數為必要項目。如果未指定,
keyring_hashicorp
初始化會失敗。 -
命令列格式 --keyring-hashicorp-secret-id=value
系統變數 keyring_hashicorp_secret_id
範圍 全域 動態 是 SET_VAR
提示套用否 類型 字串 預設值 空字串
HashiCorp Vault AppRole 身份驗證機密 ID,供
keyring_hashicorp
外掛程式使用。除非已安裝該外掛程式,否則此變數不可用。值必須為 UUID 格式。此變數為必要項目。如果未指定,
keyring_hashicorp
初始化會失敗。此變數的值很敏感,因此當顯示時,其值會以
*
字元遮罩。 -
命令列格式 --keyring-hashicorp-server-url=value
系統變數 keyring_hashicorp_server_url
範圍 全域 動態 是 SET_VAR
提示套用否 類型 字串 預設值 https://127.0.0.1:8200
HashiCorp Vault 伺服器 URL,供
keyring_hashicorp
外掛程式使用。除非已安裝該外掛程式,否則此變數不可用。值必須以https://
開頭。 -
命令列格式 --keyring-hashicorp-store-path=value
系統變數 keyring_hashicorp_store_path
範圍 全域 動態 是 SET_VAR
提示套用否 類型 字串 預設值 空字串
HashiCorp Vault 伺服器中的儲存路徑,當
keyring_hashicorp
外掛程式提供適當的 AppRole 認證時,該路徑可寫入。除非已安裝該外掛程式,否則此變數不可用。若要指定認證,請設定keyring_hashicorp_role_id
和keyring_hashicorp_secret_id
系統變數(例如,如keyring_hashicorp 設定中所示)。此變數為必要項目。如果未指定,
keyring_hashicorp
初始化會失敗。 -
命令列格式 --keyring-okv-conf-dir=dir_name
系統變數 keyring_okv_conf_dir
範圍 全域 動態 是 SET_VAR
提示套用否 類型 目錄名稱 預設值 空字串
儲存
keyring_okv
外掛程式使用的組態資訊的目錄路徑名稱。除非已安裝該外掛程式,否則此變數不可用。該位置應為僅供keyring_okv
外掛程式使用的目錄。例如,不要將目錄放置在資料目錄下。預設的
keyring_okv_conf_dir
值為空。為了讓keyring_okv
外掛程式能夠存取 Oracle Key Vault,必須將該值設定為包含 Oracle Key Vault 組態和 SSL 材料的目錄。如需設定此目錄的說明,請參閱第 8.4.4.6 節,「使用 keyring_okv KMIP 外掛程式」。目錄應具有限制模式,且只能由用來執行 MySQL 伺服器的帳戶存取。例如,在 Unix 和類 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_operations
範圍 全域 動態 是 SET_VAR
提示套用否 類型 布林值 預設值 ON
是否啟用金鑰環操作。此變數用於金鑰移轉操作期間。請參閱第 8.4.4.11 節,「在金鑰環金鑰儲存區之間移轉金鑰」。修改此變數所需的權限除了
ENCRYPTION_KEY_ADMIN
之外,還需要SYSTEM_VARIABLES_ADMIN
或已棄用的SUPER
權限。