AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

사용 중 암호화

Ruby 운전자 사용하면 사용 중 암호화 설정하다 을 통해 특정 문서 필드를 암호화할 수 있습니다. 사용 중 암호화 사용하면 애플리케이션에서 데이터를 MongoDB 로 보내기 전에 암호화하고 암호화됨 필드가 있는 문서를 쿼리 수 있습니다.

경고

MongoDB 8.2 알려진 문제

mongocryptd 의 8.2.0 버전은 Windows 에서 실행 되지 않을 수 있습니다. 이 버그는 mongocryptd를 시작할 때 --logpath NUL 인수를 지정하는 경우 운전자 의 사용 중 암호화 영향을 줍니다.

이 문제와 해결 방법에 대해 자세히 학습하려면 MongoDB 8.2 의 알려진 문제 를 참조하세요. 릴리스 노트.

사용 중 암호화 는 권한이 없는 사용자가 일반 텍스트 데이터가 MongoDB 로 전송되거나 암호화됨 데이터베이스 에 있는 동안 볼 수 없도록 합니다. 애플리케이션 에서 사용 중 암호화 를 활성화 하고 데이터 암호 해독 권한을 부여하려면 애플리케이션 만 액세스 할 수 있는 암호화 키를 생성해야 합니다. 암호화 키에 액세스 할 수 있는 애플리케이션만 해독된 일반 텍스트 데이터에 액세스 할 수 있습니다. 공격자가 데이터베이스 에 액세스 하는 경우 암호화 키에 액세스 이 없기 때문에 암호화됨 암호 텍스트 데이터만 볼 수 있습니다.

사용 중 암호화 를 사용하여 다음 유형의 민감한 데이터가 포함된 MongoDB 문서의 필드를 암호화할 수 있습니다.

  • 신용 카드 번호

  • 주소

  • 건강 정보

  • 재무 정보

  • 기타 민감한 정보 또는 개인 식별 정보(PII)

MongoDB는 사용 중 암호화를 활성화하기 위해 다음과 같은 기능을 제공합니다.

중요

$rerank 단계는 클라이언트 사이드 필드 레벨 암호화 또는 Queryable Encryption을 사용하여 자동 암호화하도록 구성된 클라이언트에서는 지원되지 않습니다. $rerank을(를) 포함하는 파이프라인은 Unrecognized pipeline stage name: '$rerank'와 같은 오류와 함께 실패합니다.

이 제한은 암호화된 필드가 없는 컬렉션을 포함한 모든 컬렉션과 $unionWith과 같은 하위 파이프라인 내에서 $rerank을 사용하는 경우에 적용됩니다.

Queryable Encryption(QE)은 사용 중 암호화 기능으로서 등호, 범위, 접두사, 접미사 및 부분 문자열 쿼리를 포함하여 암호화된 필드 값에 대한 쿼리를 실행할 수 있습니다. 범위 쿼리 지원에는 MongoDB Server 8.0 이상이 필요합니다. 접두사, 접미사 및 부분 문자열 쿼리 지원에는 MongoDB Server 9.0 이상이 필요합니다.

Queryable Encryption 에 학습 보려면 MongoDB Server 매뉴얼의 Queryable Encryption 을 참조하세요.

클라이언트 사이드 필드 레벨 암호화 (CSFLE)는 암호화됨 필드의 동일성 검색을 지원합니다. CSFLE는 필드를 암호화하기 위해 결정론적 또는 무작위 암호화 알고리즘 선택할 수 있다는 점에서 Queryable Encryption 과 다릅니다. CSFLE를 사용할 때 결정론적 암호화 알고리즘 사용하는 암호화됨 필드만 쿼리 할 수 있습니다. 무작위 암호화 알고리즘 사용하여 CSFLE의 필드를 암호화하는 경우 해독할 수는 있지만 해당 필드에 대해 동일성 쿼리를 수행할 수는 없습니다. Queryable Encryption 사용하면 암호화 알고리즘 지정할 수 없지만 암호화됨 모든 필드를 쿼리 할 수 있습니다.

값을 결정론적으로 암호화하면 동일한 입력 값이 동일한 출력 값을 생성합니다. 결정론적 암호화를 사용하면 암호화된 필드에 대해 쿼리를 수행할 수 있지만 카디널리티가 낮은 암호화된 데이터는 빈도 분석으로 인한 코드 손상에 취약합니다.

팁

이러한 개념에 대해 자세히 알아보려면 다음 Wikipedia 항목을 참조하세요.

CSFLE에 학습 보려면 MongoDB Server 매뉴얼에서 CSFLE 를 참조하세요.

기본적으로 Ruby 드라이버는 문서를 복호화할 때 64비트 정수를 BSON::Int64 값으로, 기호를 BSON::Symbol::Raw 값으로 반환합니다. 이 동작은 암호화되지 않은 필드를 포함하여 복호화된 문서의 모든 필드에 적용됩니다.

이러한 값을 Ruby Integer 및 Symbol 값으로 반환하려면 Mongo.csfle_convert_to_ruby_types 옵션을 true(으)로 설정하세요. 이 옵션은 Queryable Encryption 및 CSFLE 모두에 적용됩니다. 이는 애플리케이션의 모든 클라이언트에 적용되는 전역 설정입니다. 기본값은 false입니다.

다음 예시에서는 auto_encryption_options로 구성된 클라이언트를 사용하여 64비트 정수가 포함된 문서를 삽입합니다. 그런 다음 예시에서는 csfle_convert_to_ruby_types가 false으로 설정된 문서를 조회한 다음 true로 설정된 문서를 조회합니다.

encrypted_client = Mongo::Client.new( '<connection string>', auto_encryption_options: { key_vault_namespace: '<key vault namespace>', kms_providers: { local: { key: '<local master key>' } } }) collection = encrypted_client[:users]collection.insert_one({ _id: 1, large_number: 2**40 }) Mongo.csfle_convert_to_ruby_types = falseresult = collection.find({ _id: 1 }).firstputs result['large_number'].classputs result['large_number'].value Mongo.csfle_convert_to_ruby_types = trueresult = collection.find({ _id: 1 }).firstputs result['large_number'].classputs result['large_number']
BSON::Int641099511627776Integer1099511627776