Este guia mostra como criar um aplicativo habilitado para criptografia de nível de campo (CSFLE) do lado do cliente usando a Amazon Web Services (AWS) KMS.
Depois de concluir as etapas deste guia, você deverá ter:
Uma Chave mestre do cliente hospedada em uma instância do AWS KMS.
Uma aplicação funcional que insere documento criptografados usando sua chave mestra do cliente.
Antes de começar
Antes de iniciar este tutorial, conclua as seguintes etapas de pré-requisito:
Baixe a Biblioteca Compartilhada de Criptografia Automática do Centro de Download do MongoDB. Navegue até a seção MongoDB Enterprise Server Download e selecione as seguintes opções:
No menu suspenso Version, selecione a versão marcada como
"current".No menu suspenso Platform, selecione sua plataforma.
No menu suspenso Package, selecione
crypt_shared.
Extraia o arquivo e salve o caminho para o arquivo da biblioteca compartilhada para uso futuro.
Observação
Componente de análise de query
A Biblioteca compartilhada de criptografia automática é uma alternativa preferencial ao
mongocryptde não requer a geração de um novo processo para realizar a criptografia automática. Este tutorial usa a Biblioteca compartilhada de criptografia automática, mas omongocryptdainda é suportado.Configure um cluster MongoDB Atlas ou uma implantação de conjunto de réplicas local e salve sua string de conexão para uso futuro. Para saber mais, consulte o tutorial Introdução.
Neste guia, os exemplos de código usam texto de espaço reservado. Antes de executar os exemplos, substitua seus valores por esses espaços reservados.
Por exemplo:
dek_id := "<Your Base64 DEK ID>"
Você substituiria tudo entre aspas pelo seu ID DEK.
dek_id := "abc123"
Código completo do aplicativo
Saiba mais
Para saber como funciona o CSFLE, consulte Fundamentos do CSFLE.
Para saber mais sobre os tópicos mencionados neste guia, consulte os seguintes links:
Saiba mais sobre componentes CSFLE na página Referência.
Saiba como funcionam as chaves mestras do cliente e as chaves de criptografia de dados na página Chaves de criptografia e cofres de chaves
Veja como os provedores de KMS gerenciam suas chaves CSFLE na página Provedores de KMS .