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.
Tip
Para obtener más información sobre cualquiera de los mecanismos que se muestran en esta página, consulte el enlace proporcionado en cada sección.
Para utilizar un ejemplo de autenticación de esta página, copie el ejemplo de código en el
Aplicación de muestra 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.
Aplicación de muestra
Puede utilizar la siguiente aplicación de muestra para probar los ejemplos de código en esta página. Para usar la aplicación de muestra, siga los siguientes pasos:
Asegúrate de tener instalado el controlador C.
Copia el siguiente código y pégalo en un nuevo archivo
.c.Copia un ejemplo de código de esta página y pégalo en las líneas especificadas del archivo.
1 2 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 if (!client) { 19 fprintf(stderr, "client initialization failure\n"); 20 goto cleanup; 21 } 22 23 database = mongoc_client_get_database(client, "admin"); 24 25 ping = BCON_NEW("ping", BCON_INT32(1)); 26 27 if (!mongoc_client_command_simple(client, "admin", ping, NULL, &reply, &error)) { 28 fprintf(stderr, "%s\n", error.message); 29 goto cleanup; 30 } 31 printf("Pinged your deployment. You successfully connected to MongoDB!\n"); 32 33 cleanup: 34 bson_destroy(&reply); 35 bson_destroy(ping); 36 mongoc_database_destroy(database); 37 mongoc_client_destroy(client); 38 mongoc_uri_destroy(uri); 39 mongoc_cleanup(); 40 }
SCRAM-SHA-256
El siguiente código muestra cómo autenticarse utilizando el mecanismo de autenticación SCRAM-SHA-256:
const char *uri = "mongodb://<percentEncodedUsername>:<percentEncodedPassword>@<hostname>:<port>/?authMechanism=SCRAM-SHA-256&authSource=<authenticationDatabase>"; mongoc_client_t *client = mongoc_client_new(uri);
Para obtener más información sobre la autenticación SCRAM-SHA-256, consulte SCRAM-SHA-256 en la guía de autenticación.
SCRAM-SHA-1
El siguiente código muestra cómo autenticarse utilizando el mecanismo de autenticación SCRAM-SHA-1:
const char *uri = "mongodb://<percentEncodedUsername>:<percentEncodedPassword>@<hostname>:<port>/?authMechanism=SCRAM-SHA-1&authSource=<authenticationDatabase>"; mongoc_client_t *client = mongoc_client_new(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:
mongoc_client_t *client; mongoc_ssl_opt_t ssl_opts = {0}; ssl_opts.pem_file = "mycert.pem"; const char *uri = "mongodb://<percentEncodedUsername>@<hostname>:<port>/?authMechanism=MONGODB-X509"; mongoc_client_t *client = mongoc_client_new(uri); mongoc_client_set_ssl_opts(client, &ssl_opts);
Para obtener más información sobre509 la autenticación X.,consulte MONGODB-X509 en la guía de autenticación.
MONGODB-AWS
Las siguientes secciones muestran cómo conectarse a MongoDB utilizando el mecanismo de autenticación MONGODB-AWS. Cuando usas el mecanismo MONGODB-AWS, el controlador C intenta recuperar tus credenciales de AWS de las siguientes fuentes, en el orden indicado:
Parámetros con nombre pasados a la URI de conexión
Variables de entorno
Solicitud AssumeRoleWithWebIdentity de AWS EKS
Metadatos del contenedor ECS
Metadatos de la instancia EC2
Cada sección muestra cómo autenticarse con MONGODB-AWS al recuperar sus credenciales de AWS desde una URI de conexión o fuentes externas alternativas.
Para obtener más información sobre la autenticación con AWS, consulte MONGODB-AWS en la guía de autenticación.
URI de conexión
El siguiente código muestra cómo pasar credenciales de AWS en una URI de conexión para autenticarse con MONGODB-AWS:
const char *uri = "mongodb://<awsIamAccessKeyId>:<awsIamSecretAccessKey>@<hostname>:<port>/?authMechanism=MONGODB-AWS"; mongoc_client_t *client = mongoc_client_new(uri);
Para obtener más información sobre cómo autenticarse con AWS mediante la recuperación de credenciales de URI de conexión, consulte URI de conexión en la guía de autenticación.
Credenciales externas
El siguiente código muestra cómo autenticarse con MONGODB-AWS al obtener credenciales de variables de entorno, metadatos de ECS o metadatos de instancia EC2:
const char *uri = "mongodb://<hostname>:<port>/?authMechanism=MONGODB-AWS"; mongoc_client_t *client = mongoc_client_new(uri);
Para obtener más información sobre cómo autenticarse con AWS mediante la obtención de credenciales externas, consulte las siguientes secciones en la guía de autenticación: