Proteja seus dados

Visão geral

O MongoDB oferece suporte a vários mecanismos que você pode usar para autenticar seu aplicação. Esta página contém exemplos de código que demonstram cada um desses mecanismos.

Para usar um exemplo de autenticação desta página, copie o exemplo de código noaplicação de amostra ou em seu próprio aplicação. Certifique-se de substituir todos os espaços reservados nos exemplos de código, como <hostname>, pelos valores relevantes para sua implantação do MongoDB .

1
#include <mongoc/mongoc.h>
2
#include <bson/bson.h>
3
4
int main(void) {
5
6
  mongoc_uri_t* uri = NULL;
7
  mongoc_client_t *client = NULL;
8
  mongoc_database_t *database = NULL;
9
  bson_t *ping = NULL, reply = BSON_INITIALIZER;
10
  bson_error_t error;
11
12
  mongoc_init();
13
14
  // Start example code here
15
16
  // End example code here
17
18
  database = mongoc_client_get_database (client, "admin");
19
    
20
  ping = BCON_NEW ("ping", BCON_INT32 (1));
21
   
22
  if (!mongoc_client_command_simple (client, "admin", ping, NULL, &reply, &error)) {
23
    fprintf (stderr, "%s\n", error.message);
24
    goto cleanup;
25
  }
26
  printf ("Pinged your deployment. You successfully connected to MongoDB!\n");
27
28
  cleanup:
29
    bson_destroy (&reply);
30
    bson_destroy (ping);
31
    mongoc_database_destroy (database);
32
    mongoc_client_destroy (client);
33
    mongoc_uri_destroy (uri);
34
    mongoc_cleanup ();
35
}

SCRAM-SHA-256

O seguinte código mostra como autenticar utilizando o mecanismo de autenticação SCRAM-SHA-256 :

const char *uri = "mongodb://<percent-encoded username>:<percent-encoded password>@<hostname>:<port>/?authMechanism=SCRAM-SHA-256&authSource=<authentication database>";
mongoc_client_t *client = mongoc_client_new(uri);

Para saber mais sobre a autenticação SCRAM-SHA-256 , consulte SCRAM-SHA-256 no guia Autenticação.

SCRAM-SHA-1

O seguinte código mostra como autenticar utilizando o mecanismo de autenticação SCRAM-SHA-1 :

const char *uri = "mongodb://<percent-encoded username>:<percent-encoded password>@<hostname>:<port>/?authMechanism=SCRAM-SHA-1&authSource=<authentication database>";
mongoc_client_t *client = mongoc_client_new(uri);

Para saber mais sobre a autenticação SCRAM-SHA-1 , consulte SCRAM-SHA-1 no guia Autenticação.

MONGODB X.509

O seguinte código mostra como criar um URI de conexão para autenticar utilizando o mecanismo de autenticação do X.509 :

mongoc_client_t *client;
mongoc_ssl_opt_t ssl_opts = {0};
ssl_opts.pem_file = "mycert.pem";
const char *uri = "mongodb://<percent-encoded username>@<hostname>:<port>/?authMechanism=MONGODB-X509";
mongoc_client_t *client = mongoc_client_new(uri);
mongoc_client_set_ssl_opts(client, &ssl_opts);

Para saber mais sobre a autenticação X.509 , consulte MONGODB-X509 no guia Autenticação.

MONGODB-AWS

As seções a seguir mostram como se conectar ao MongoDB usando o mecanismo de autenticação MONGODB-AWS . Quando você usa o mecanismo MONGODB-AWS , o driver C tenta recuperar suas credenciais da AWS das seguintes fontes, na ordem listada:

1. Parâmetros nomeados passados para o URI de conexão

2. Variáveis de ambiente

3. Solicitação de Amazon Web Services EKS AssumeRoleWithWebIdentity

4. Metadados do container ECS

5. Metadados de instância do EC2

Cada seção mostra como autenticar com MONGODB-AWS ao recuperar suas credenciais da AWS a partir de um URI de conexão ou de fontes externas alternativas.

Para saber mais sobre como autenticar com Amazon Web Services, consulte MONGODB-Amazon Web Services no guia de autenticação.

const char *uri = "mongodb://<AWS IAM access key ID>:<AWS IAM secret access key>@<hostname>:<port>/?authMechanism=MONGODB-AWS");
mongoc_client_t *client = mongoc_client_new(uri);

const char *uri = "mongodb://<hostname>:<port>/?authMechanism=MONGODB-AWS");
mongoc_client_t *client = mongoc_client_new(uri);