Visão geral
Neste tutorial, você aprenderá a usar a criptografia automática no nível do campo do lado do cliente (CSFLE) e um driver MongoDB para criptografar um documento.
O tutorial inclui as seguintes seções:
Configure seu projeto: configure seus arquivos de projeto e atribua as variáveis necessárias.
**Configurar criptografia**: crie uma chave de criptografia e configure seu aplicativo para criptografia no nível do campo do lado do cliente.
Execute operações criptografadas: insira e query documentos criptografados.
Importante
Não use este aplicativo em produção
Como esse aplicativo de exemplo armazena uma chave de criptografia no sistema de arquivos do aplicativo, você corre o risco de acesso não autorizado à chave ou de perda da chave para descriptografar seus dados.
Para exibir um tutorial que demonstra como criar um aplicação habilitado para CSFLE pronto para produção, consulte Tutoriais de CSFLE.
Pré-requisitos
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.
Código completo do aplicativo
Tutorial
Saiba mais
Para aprender a criar um CSFLE pronto para produção com um KMS remoto, consulte os Tutoriais do CSFLE.
Para saber como funciona o CSFLE, consulte Fundamentos do CSFLE.
Para saber mais sobre os tópicos mencionados neste guia, consulte os seguintes recursos: