문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

Queryable Encryption를 위한 자동 암호화 공유 라이브러리

이 페이지의 내용

  • 개요
  • 자동 암호화 공유 라이브러리 다운로드
  • 구성

개요

자동 암호화 공유 라이브러리는 클라이언트 애플리케이션이 자동 Queryable Encryption를 수행할 수 있도록 하는 동적 라이브러리입니다. 동적 라이브러리는 컴파일 타임이 아닌 런타임에 애플리케이션이 액세스하는 기능 세트입니다. 자동 암호화 공유 라이브러리는 다음 작업을 수행합니다:

  • 암호화된 필드 맵을 읽고 암호화하거나 해독할 필드를 결정합니다.

  • 애플리케이션이 암호화된 필드에서 지원되지 않는 작업을 실행하는 것을 방지합니다.

자동 암호화 공유 라이브러리는 다음 중 어느 것도 수행하지 않습니다:

  • 데이터 암호화 또는 복호화 수행

  • 암호화 키 자료에 액세스

  • 네트워크를 통해 데이터 수신

중요

지원되는 MongoDB 서버 제품

자동 Queryable Encryption는 다음 MongoDB 서버 제품에서만 사용할 수 있습니다.

  • MongoDB Atlas 6.0 이상 cluster

  • MongoDB Enterprise 6.0 이상

Queryable Encryption는 모든 버전의 MongoDB 커뮤니티 서버에서 사용할 수 없습니다.

자동 암호화 공유 라이브러리는 mongocryptd 에 대한 선호되는 대안이며 자동 암호화를 수행하기 위해 다른 프로세스를 생성할 필요가 없습니다.

팁

자동 암호화 공유 라이브러리를 사용하는 것이 좋지만 mongocryptd 은 계속 지원됩니다.

mongocryptd 에 대해 자세히 알아보려면 Queryable Encryption을 위한 mongocryptd 설치 및 구성을 참조하세요.

자동 암호화에 대해 자세히 알아보려면 기능을 참조하세요.

자동 암호화 공유 라이브러리 다운로드

MongoDB 다운로드 센터 에서 버전과 플랫폼을 선택한 다음 라이브러리를 선택하여 자동 암호화 공유 라이브러리를 다운로드합니다.

  1. Version 드롭다운 메뉴에서 'current'로 레이블이 지정된 버전을 선택합니다.

  2. Platform 드롭다운에서 플랫폼을 선택합니다.

  3. Package 드롭다운 메뉴에서 crypt_shared를 선택합니다.

  4. Download를 클릭합니다.

팁

사용 가능한 릴리스 및 패키지의 확장된 목록을 보려면 MongoDB 엔터프라이즈 다운로드를 참조하세요.

구성

다음 매개변수를 통해 드라이버가 자동 암호화 공유 라이브러리를 검색하는 방법을 구성할 수 있습니다.

이름
설명
cryptSharedLibPath
자동 암호화 공유 라이브러리 패키지의 절대 경로를 지정합니다.
crypt_shared.
기본값: undefined
cryptSharedLibRequired
드라이버가 자동 암호화 공유 라이브러리를 사용해야 하는지 여부를 지정합니다. true인 경우,
자동 암호화 공유 라이브러리를 사용할 수 없는 경우 드라이버가 오류를 발생시킵니다.
false이면 드라이버는 다음 작업 순서를 수행합니다:

  1. 자동 암호화 공유 라이브러리를 사용하려고 시도합니다.

  2. 자동 암호화 공유 라이브러리를 사용할 수 없는 경우 드라이버는 mongocryptd 생성 및 연결을 시도합니다.

기본값: false

이러한 매개변수를 구성하는 방법을 보여주는 예제를 보려면 Quick Start을 참조하세요.

← Queryable Encryption를 위한 MongoClient 옵션
libmongocrypt 설치 →

이 페이지의 내용