加密密钥

NOTE
如果您尝试完成这些步骤但遇到问题,请参阅加密密钥轮换疑难解答: CVE-2024-34102知识库文章。

Adobe Commerce和Magento Open Source使用加密密钥保护密码和其他敏感数据。 行业标准ChaCha20-Poly1305算法与256位密钥一起使用,以加密所有需要加密的数据。 这包括信用卡数据和集成(支付和配送模块)密码。 此外,使用强安全哈希算法(SHA-256)来哈希所有不需要解密的数据。

在初始安装期间,系统会提示您允许Commerce生成加密密钥,或输入自己的密钥。 加密密钥工具允许您根据需要更改密钥。 应定期更改加密密钥以提高安全性,并且随时可能危及原始密钥。

有关技术信息,请参阅​ 安装指南 ​中的高级内部部署

IMPORTANT
在按照这些说明更改加密密钥之前,请确保以下文件可写: [your store]/app/etc/env.php

要更改加密密钥:

下面的说明需要访问终端。

  1. 启用维护模式

    code language-bash
    bin/magento maintenance:enable
    
  2. 禁用cron作业。

    云基础架构项目:

    code language-bash
    ./vendor/bin/ece-tools cron:disable
    

    内部部署项目

    code language-bash
    crontab -e
    
  3. 在​ 管理员 ​侧边栏上,转到​ System > Other Settings>Manage Encryption Key

    系统加密密钥 {width="700" modal="regular"}

  4. 执行以下操作之一:

    • 要生成新密钥,请将​ Auto-generate Key ​设置为Yes
    • 若要使用其他键,请将​ Auto-generate Key ​设置为No。 然后在​ New Key ​字段中,输入或粘贴要使用的密钥。
  5. 单击​ Change Encryption Key

    note note
    NOTE
    将新密钥的记录保存在安全位置。 如果文件发生任何问题,则需要解密数据。
  6. 刷新缓存。

    云基础架构项目:

    code language-bash
    magento-cloud cc
    

    内部部署项目:

    code language-bash
    bin/magento cache:flush
    
  7. 启用cron作业。

    云基础架构项目:

    code language-bash
    ./vendor/bin/ece-tools cron:enable
    

    内部部署项目:

    code language-bash
    crontab -e
    
  8. 禁用维护模式。

    code language-bash
    bin/magento maintenance:disable
    
recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1