Protege tus datos

Overview

MongoDB admite varios mecanismos para autenticar su aplicación. Esta página contiene ejemplos de código que demuestran cada uno de estos mecanismos.

Para utilizar un ejemplo de autenticación de esta página, copie el ejemplo de código en el Aplicación de ejemplo o su propia aplicación. Asegúrese de reemplazar todos los marcadores de posición en los ejemplos de código, como <hostname>, con los valores relevantes para su implementación de MongoDB.

1
#include <bsoncxx/json.hpp>
2
3
#include <mongocxx/client.hpp>
4
#include <mongocxx/exception/exception.hpp>
5
#include <mongocxx/instance.hpp>
6
#include <mongocxx/uri.hpp>
7
8
#include <iostream>
9
10
int main()
11
{
12
    mongocxx::instance instance;
13
14
    try
15
    {
16
        // Start example code here
17
18
        // End example code here
19
20
        auto admin = client["admin"];
21
        admin.run_command(bsoncxx::from_json(R"({ "ping": 1 })"));
22
23
        std::cout << "Successfully pinged the MongoDB server." << std::endl;
24
    }
25
    catch (const mongocxx::exception &e)
26
    {
27
        std::cout << "An exception occurred: " << e.what() << std::endl;
28
        return EXIT_FAILURE;
29
    }
30
31
    return EXIT_SUCCESS;
32
}

SCRAM-SHA-256

El siguiente código muestra cómo crear una URI de conexión para autenticar mediante el mecanismo de autenticación SCRAM-SHA-256:

auto uri = mongocxx::uri("mongodb://<db_username>:<db_password>@<hostname>:<port>/?"
                         "authSource=admin&authMechanism=SCRAM-SHA-256");
auto client = mongocxx::client(uri);

Para obtener más información sobre256 la autenticación SCRAM-SHA-,consulte SCRAM-SHA-256 en la guía de autenticación.

SCRAM-SHA-1

El siguiente código muestra cómo crear una URI de conexión para autenticar mediante el mecanismo de autenticación SCRAM-SHA-1:

auto uri = mongocxx::uri("mongodb://<db_username>:<db_password>@<hostname>:<port>/?"
                         "authSource=admin&authMechanism=SCRAM-SHA-1");
auto client = mongocxx::client(uri);

Para obtener más información sobre1 la autenticación SCRAM-SHA-,consulte SCRAM-SHA-1 en la guía de autenticación.

MONGODB X.509

El siguiente código muestra cómo crear una URI de conexión para autenticar mediante el mecanismo de autenticación X.509:

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "tls=true&tlsCertificateKeyFile=path/to/client.pem&authMechanism=MONGODB-X509");
auto client = mongocxx::client(uri);

Para obtener más información sobre509 la autenticación X.,consulte MONGODB X.509 en la guía de autenticación.

MONGODB-AWS

Las siguientes secciones muestran cómo conectarse a MongoDB mediante el mecanismo de autenticación MONGODB-AWS. Al usar el mecanismo MONGODB-AWS, el controlador de C++ intenta recuperar sus credenciales de AWS de las siguientes fuentes, en el orden indicado:

1. Parámetros con nombre pasados ​​a la URI de conexión

2. Variables de entorno

3. Solicitud AssumeRoleWithWebIdentity de AWS EKS

4. Metadatos del contenedor ECS

5. Metadatos de la instancia EC2

Cada sección muestra cómo crear la URI de conexión para autenticarse con MONGODB-AWS al recuperar sus credenciales de AWS de la fuente especificada.

Para obtener más información sobre la autenticación con AWS, consulte MONGODB-AWS en la guía de autenticación.

auto uri = mongocxx::uri("mongodb://<AWS IAM access key ID>:<AWS IAM secret access key>@<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

Kerberos

El siguiente código muestra cómo crear una URI de conexión para autenticarse con Kerberos:

auto uri = mongocxx::uri("mongodb://<Kerberos principal>@<hostname>:<port>/?"
                         "authMechanism=GSSAPI"
                         "&authMechanismProperties=SERVICE_NAME:<authentication service name>");
auto client = mongocxx::client(uri);

Para obtener más información sobre la autenticación con Kerberos, consulte Kerberos en la guía de autenticación empresarial.

SASL SENCILLO

El siguiente código muestra cómo crear una URI de conexión para autenticarse con PLAIN SASL:

auto uri = mongocxx::uri("mongodb://<db_username>:<db_password>@<hostname>:<port>/?"
                         "authMechanism=PLAIN&tls=true");
auto client = mongocxx::client(uri);

Para obtener más información sobre la autenticación con PLAIN SASL, consulte PLAIN SASL en la guía de autenticación empresarial.