암호화 키

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. 크론 작업을 활성화합니다.

    클라우드 인프라 프로젝트:

    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