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

암호화된 컬렉션 생성 및 문서 삽입

이 가이드 에서는 Queryable Encryption 이 활성화된 컬렉션 을 만들고 암호화됨 필드가 있는 문서 를 삽입하는 방법을 설명합니다.

이 가이드의 단계를 완료하면 암호화된 컬렉션을 만들고 고객 마스터 키로 암호화된 필드가 포함된 문서를 삽입할 수 있습니다.

암호화됨 컬렉션 을 만들기 전에 Queryable Encryption 이 활성화된 애플리케이션 을 만듭니다.

명시적 암호화 를 사용하는 경우, 암호화됨 각 필드 에 대해 고유한 데이터 암호화 키 도 미리 생성해야 합니다. 자세한 내용은 암호화 키 및 키 볼트를 참조하세요.

1

필드 를 암호화하려면 암호화 스키마 에 추가합니다. 필드 에 대한 쿼리를 활성화 하려면 queries 속성 을 추가합니다. 동일성 쿼리 또는 범위 쿼리를 통해 필드를 쿼리할 수 활성화 설정할 수 있습니다. 다음 단계에서는 각 쿼리 유형으로 암호화할 필드를 지정하는 방법을 보여 줍니다.

  1. 동일성 쿼리에 대한 필드 지정

    필드 에서 동등성 쿼리를 활성화 하려면 queryType 가 "equality" 인 암호화 스키마 에 필드 를 추가합니다. 다음 코드 샘플 은 ssn 및 billing 필드를 모두 암호화하지만 ssn 필드 만 쿼리할 수 있습니다.

    const collectionOpts = { encryptedFields: { fields: [ { path: "patientRecord.ssn", bsonType: "string", queries: { queryType: "equality" }, }, { path: "patientRecord.billing", bsonType: "object", }, ], },};
  2. 범위 쿼리에 대한 필드 지정

    필드 에서 범위 쿼리를 활성화 하려면 queryType 가 "range" 인 암호화 스키마 에 필드 를 추가합니다. 다음 예시 에서는 이전 단계에서 만든 암호화 스키마 에 billAmount 필드 를 추가하고 해당 필드에 대한 범위 쿼리를 활성화합니다.

    const collectionOpts = { encryptedFields: { fields: [ { path: "patientRecord.ssn", bsonType: "string", queries: { queryType: "equality" }, }, { path: "patientRecord.billing", bsonType: "object", }, { path: "patientRecord.billAmount", bsonType: "int", queries: { queryType: "range", sparsity: 1, trimFactor: 4, min: 100, max: 2000, }, }, ], },};

이 단계의 확장 버전은 암호화 스키마 생성을 참조하세요.

2
const clientEncryption = encryptedClient.getClientEncryption();
3

중요

삽입 작업을 통해 암시적으로 컬렉션을 생성하는 대신 명시적으로 컬렉션을 생성합니다. createCollection()을 사용하여 컬렉션을 생성하면 MongoDB는 암호화된 필드에 인덱스을 생성합니다. 이 인덱스가 없으면 암호화된 필드에 대한 쿼리가 느리게 실행될 수 있습니다.

ClientEncryption 클래스를 통해 액세스하는 암호화 헬퍼 메서드를 사용하여 암호화됨 컬렉션 을 만듭니다. 이 메서드는 암호화됨 필드에 대한 데이터 암호화 키를 자동으로 생성하고 암호화됨 컬렉션 을 생성합니다.

await clientEncryption.createEncryptedCollection( encryptedDatabaseName, encryptedCollectionName, { provider: kmsProviderName, createCollectionOptions: collectionOpts, masterKey: customerMasterKeyCredentials, });

자세한 내용 은 컬렉션 생성 시 Queryable Encryption 활성화를 참조하세요.

4

환자의 개인 정보를 설명하는 샘플 문서를 만듭니다. 다음 예시와 같이 암호화된 클라이언트를 사용하여 patients 컬렉션에 삽입합니다.

const patientDocument = { patientName: "Jon Doe", patientId: 12345678, patientRecord: { ssn: "987-65-4320", billing: { type: "Visa", number: "4111111111111111", }, billAmount: 1500, },}; const encryptedCollection = encryptedClient .getDB(encryptedDatabaseName) .getCollection(encryptedCollectionName); const insertResult = await encryptedCollection.insertOne(patientDocument);

Queryable Encryption 이 활성화된 컬렉션 을 만든 후 암호화됨 필드를 쿼리 할 수 있습니다.

언어 선택
이 페이지 평가하기