加密密钥
最近更新： 2025年5月5日
创建对象：
- 初学者
- 中级
- 管理员
NOTE如果您尝试完成这些步骤但遇到问题，请参阅加密密钥轮换疑难解答： CVE-2024-34102知识库文章。
Adobe Commerce和Magento Open Source使用加密密钥保护密码和其他敏感数据。 行业标准ChaCha20-Poly1305算法与256位密钥一起使用，以加密所有需要加密的数据。 这包括信用卡数据和集成（支付和配送模块）密码。 此外，使用强安全哈希算法(SHA-256)来哈希所有不需要解密的数据。
在初始安装期间，系统会提示您允许Commerce生成加密密钥，或输入自己的密钥。 加密密钥工具允许您根据需要更改密钥。 应定期更改加密密钥以提高安全性，并且随时可能危及原始密钥。
IMPORTANT- 在按照这些说明更改加密密钥之前，请确保以下文件可写：
[your store]/app/etc/env.php - 管理员设置中的加密密钥更改功能已弃用，已在2.4.8中移除。升级到2.4.8后，您必须使用本页中所述的CLI命令更改加密密钥。
要更改加密密钥：
下面的说明需要访问终端。
-
启用维护模式。
bin/magento maintenance:enable -
禁用cron作业。
云基础架构项目：
./vendor/bin/ece-tools cron:disable内部部署项目
crontab -e -
使用以下方法之一更改加密密钥。
CLI命令运行以下CLI命令，并确保其完成时没有出现错误。 如果需要重新加密某些系统配置值或付款字段，请参阅 PHP开发指南 中有关重新加密🔗的详细指南。
bin/magento encryption:key:change管理员设置IMPORTANT此功能已被弃用，在2.4.8中已移除。Adobe建议使用CLI更改加密密钥。-
在 管理员 侧边栏上，转到 System > Other Settings>Manage Encryption Key。
-
执行以下操作之一：
- 要生成新密钥，请将 Auto-generate Key 设置为
Yes。 - 若要使用其他键，请将 Auto-generate Key 设置为
No。 然后在 New Key 字段中，输入或粘贴要使用的密钥。
- 要生成新密钥，请将 Auto-generate Key 设置为
-
单击 Change Encryption Key。
NOTE将新密钥的记录保存在安全位置。 如果文件发生任何问题，则需要解密数据。
-
-
刷新缓存。
云基础架构项目：
magento-cloud cc内部部署项目：
bin/magento cache:flush -
启用cron作业。
云基础架构项目：
./vendor/bin/ece-tools cron:enable内部部署项目：
crontab -e -
禁用维护模式。
bin/magento maintenance:disable
recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1