암호화 키 교체

셀프 호스팅 n8n 인스턴스에서 자격 증명 및 기타 민감한 데이터를 보호하는 데이터 암호화 키를 활성화하고 교체하는 방법을 설명합니다.

기능 제공 범위 셀프 호스팅 n8n 인스턴스에서만 사용 가능합니다. 기능을 활성화하고 키를 교체하려면 인스턴스 소유자여야 합니다. 암호화 키 교체를 사용하면 인스턴스의 마스터 암호화 키를 변경하지 않고도, 자격 증명, OAuth 토큰 및 기타 민감한 콘텐츠와 같은 n8n 데이터를 암호화하는 키를 주기적으로 교체할 수 있습니다. 암호화 키 교체 동작 방식 # n8n은 2계층 키 모델을 사용합니다: 인스턴스 암호화 키 ( N8N_ENCRYPTION_KEY ): 배포 시 설정되는 마스터 키입니다. 이 키는 변경되지 않습니다. n8n은 데이터 암호화 키를 보호하는 용도로만 이 키를 사용합니다. 데이터 암호화 키 : 자격 증명 데이터를 직접 암호화하는 키입니다. 교체 대상이 되는 키입니다. n8n은 이 키를 인스턴스 키로 암호화하여 데이터베이스에 저장합니다. 교체가 이루어지면 n8n은 새 데이터 암호화 키를 생성하고 이후의 모든 쓰기에 사용합니다. 이전 키로 암호화된 기존 데이터는 계속 읽을 수 있습니다. n8n은 각 레코드를 다음에 업데이트할 때 자동으로 새 키로 재암호화합니다. 시작하기 전에 # 이 기능을 활성화하기 전에 전체 데이터베이스 백업을 수행하세요 암호화 키 교체 활성화는 단방향 변경입니다. 롤백 경로가 없습니다. 자세한 내용은 하위 호환성 및 롤백 을 참조하세요. 또한 다음 사항을 확인해야 합니다: 모든 n8n 인스턴스(메인 및 모든 워커)가 동일한 N8N_ENCRYPTION_KEY 값을 공유해야 합니다. 환경 변수와 n8n 데이터베이스를 직접 제어할 수 있어야 합니다. 이는 셀프 호스팅 배포에서만 가능합니다. 암호화 키 교체 활성화 # 모든 n8n 인스턴스(메인 및 워커 모두)에 다음 환경 변수를 설정합니다: N8N_ENV_FEAT_ENCRYPTION_KEY_ROTATION= true 모든 인스턴스를 재시작합니다. 시작 시 n8n은 자동으로 초기 데이터 암호화 키를 생성하고 암호화하여 데이터베이스에 저장합니다. 기능이 활성화되었는지 확인하려면 Settings > Data Encryption Keys 로 이동합니다. 활성 키가 목록에 표시되어야 합니다. 활성 키 교체 # 기능이 활성화된 후에는 언제든지 새 데이터 암호화 키로 교체할 수 있습니다. UI 사용 # Settings > Data Encryption Keys 로 이동하여 Rotate key 를 선택합니다. API 사용 # /encryption/keys 엔드포인트에 POST 요청을 보냅니다. 해당 요청에는 encryptionKey:manage 글로벌 스코프가 필요합니다. n8n은 API 응답에서 키 자체를 반환하지 않으며, ID, 알고리즘, 상태, 타임스탬프와 같은 메타데이터만 반환합니다. 교체 후 n8n은 모든 새 쓰기에 새 활성 키를 사용합니다. 이전 키로 암호화된 레코드는 계속 읽을 수 있습니다. n8n은 각 레코드를 다음에 업데이트할 때 새 키로 재암호화합니다. 하위 호환성 및 롤백 # 이것은 단방향 마이그레이션입니다 암호화 키 교체를 활성화하기 전에 이 섹션을 주의