Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu
Docs Home
/ /
Configuración de acceso
Docs Home
/
Gestión
/
Cloud Manager
/
Configuración de acceso
Docs Home
/
Gestión
/
Cloud Manager
/
Configuración de acceso

Acceso programático a Cloud Manager con una cuenta de servicio

Para otorgar acceso programático a una organización o proyecto utilizando únicamente la API, crea una clave de API o una cuenta de servicio. Esto garantiza que las claves y los tokens de acceso que sirven como nombres de usuario y contraseñas nunca se envíen por la red. API claves y cuentas de servicio:

  • No se puede usar para iniciar sesión en Cloud Manager a través de la Interfaz de Usuario.

  • Se deben otorgar roles como si fueran usuarios para garantizar que las claves de API y las cuentas de servicio puedan llamar a los puntos finales de la API sin errores.

  • Pertenece a una organización, pero puede concederse acceso a cualquier número de proyectos en esa organización.

Para obtener más información sobre estos dos métodos de autenticación, consulte Autenticación.

Gestiona el acceso programático a una organización

Nota

Permisos requeridos

Puede ver el acceso programático a una organización con cualquier rol.

Para realizar cualquier otra acción, debes tener el rol de Organization Owner.

Concede acceso programático a una organización

Utilice los siguientes procedimientos para conceder acceso programático a una organización a través de claves de API o de una cuenta de servicio. Para obtener más información sobre estos dos métodos de autenticación, consulta Autenticación.

1
En MongoDB Cloud Manager, ve a la página Applications para tu organización.

  1. Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.

  2. En la barra lateral, haz clic en Applications` en la sección Identity & Access.

Se muestra la página de Aplicaciones.

2

Haz clic Add new Application Service Account.

3

Ingresar la información de la cuenta de servicio.

  1. Introduce un Name.

  2. Introduce un Description.

  3. Seleccionar una duración del menú Client Secret Expiration.

  4. Desde el menú de Permisos de la organización, seleccionar el nuevo rol o los nuevos roles para la cuenta de servicio.

4

Haga clic en Create.

5

Copia y guarda el Client Secret.

El secreto del cliente actúa como la contraseña al crear tokens de acceso.

Advertencia

Esta es la única vez que podrás ver el secreto de cliente completo. Se debe hacer clic en Copy y guardarlo en una ubicación segura. De lo contrario, se necesitará generar un nuevo secreto de cliente.

6

Añade un API Access List Entry.

  1. Haga clic en Add Access List Entry.

  2. Introduzca una dirección IP o un bloque CIDR desde el que desee que Cloud Manager acepte solicitudes de API para esta cuenta de servicio.

    También puede hacer clic en Use Current IP Address si el host que está utilizando para acceder a Cloud Manager también realizará solicitudes API mediante esta cuenta de servicio.

  3. Haga clic en Save.

Ver acceso programático a una organización

Puedes ver los detalles de todas las claves API o cuentas de servicio que tienen acceso a tu organización.

1
En MongoDB Cloud Manager, ve a la página Applications para tu organización.

  1. Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.

  2. En la barra lateral, haz clic en Applications` en la sección Identity & Access.

Se muestra la página de Aplicaciones.

2

Haz clic en la pestaña Applications.

3

Haga clic en Service Accounts.

Se muestran todas las cuentas de servicio con acceso a tu organización.

Haz clic en el nombre de una cuenta de servicio para ver sus detalles, incluyendo:

  • El secreto cliente ofuscado para la cuenta de servicio

  • La fecha en que se usó por última vez el secreto de cliente

  • La fecha en que se creó el secreto del cliente

  • Las direcciones IP desde las que la cuenta de servicio puede acceder a la API

  • Los roles que se han asignado a la cuenta de servicio

Actualizar el acceso programático a una organización

En una organización, puede modificar las funciones, la descripción o la lista de acceso de una clave API o una cuenta de servicio. También puede generar un nuevo secreto de cliente para una cuenta de servicio.

1
En MongoDB Cloud Manager, ve a la página Applications para tu organización.

  1. Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.

  2. En la barra lateral, haz clic en Applications` en la sección Identity & Access.

Se muestra la página de Aplicaciones.

2

Haga clic en Service Accounts.

3

Haz clic en el nombre de una cuenta de servicio.

4

Edite el Service Account Info.

Para modificar el Name o el Description, haz clic en .

5

Genera un nuevo secreto de cliente.

  1. Haga clic Generate New Client Secret

  2. Elija una duración para el secreto del cliente en el menú. El secreto del cliente expira después de este periodo de tiempo.

  3. Haga clic en Generate New.

  4. Haga clic en Copy y guarde el secreto del cliente en una ubicación segura. Esta es la única vez que puede visualizar el secreto completo del cliente.

6

Edite el Organization Permissions.

  1. Haga clic en Edit Permissions.

  2. En el menú Organization Permissions, selecciona el/a nuevo rol o roles para la cuenta de servicio.

  3. Haga clic en Save and next.

    Importante

    Las credenciales de la cuenta de servicio permanecen activas hasta que caduquen o un usuario las revoque.

7

Edite el API Access List.

  1. Para agregar una dirección IP o un bloque CIDR desde el cual desea que Cloud Manager acepte solicitudes de API para esta cuenta de servicio, haga clic en Add Access List Entry y escriba una dirección IP.

    También puedes hacer clic en Use Current IP Address si el host que utilizas para acceder a Cloud Manager también hará solicitudes API utilizando esta cuenta de servicio.

  2. Para eliminar una dirección IP de la lista de acceso, haga clic a la derecha de la dirección IP.

  3. Haga clic en Save.

Revocar el acceso programático a una organización

1
En MongoDB Cloud Manager, ve a la página Applications para tu organización.

  1. Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.

  2. En la barra lateral, haz clic en Applications` en la sección Identity & Access.

Se muestra la página de Aplicaciones.

2

Haga clic en Service Accounts.

3

Borra la cuenta de servicio.

  1. Haz clic en el icono debajo de Actions a la derecha de la cuenta de servicio que deseas borrar.

  2. Haga clic en Delete.

Borrar una cuenta de servicio de una organización también la remueve de cualquier Proyecto al que se le haya concedido acceso a esa cuenta de servicio.

Administrar el acceso programático a un proyecto

Nota

Permisos requeridos

Puedes ver el acceso programático a un proyecto con cualquier rol.

Para realizar cualquier otra acción, debes tener el rol de Project User Admin.

Otorgar acceso programático a un proyecto

Siga los siguientes procedimientos para otorgar acceso programático a un proyecto mediante claves API o una cuenta de servicio. Para obtener más información sobre estos dos métodos de autenticación, consulte la sección Autenticación.

1

En MongoDB Cloud Manager, ve a la página Project Settings.

  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haga clic en Project Settings.

    La página Configuración del proyecto se muestra.

2
Ir a la página Applications.

En la barra lateral, haz clic en Applications en la sección Identity & Access.

Se muestra la página de Aplicaciones.

3

Haz clic en Create Application Service Account.

4

Ingresar la información de la cuenta de servicio.

  1. Introduce un Name.

  2. Introduce un Description.

  3. Seleccionar una duración del menú Client Secret Expiration.

  4. Desde el menú Permisos del proyecto, selecciona el nuevo rol o los nuevos roles para la cuenta de servicio.

5

Haga clic en Create.

6

Copia y guarda el Client Secret.

El secreto del cliente actúa como la contraseña al crear tokens de acceso.

Advertencia

Esta es la única vez que podrás ver el secreto de cliente completo. Se debe hacer clic en Copy y guardarlo en una ubicación segura. De lo contrario, se necesitará generar un nuevo secreto de cliente.

7

Añade un API Access List Entry.

  1. Haga clic en Add Access List Entry.

  2. Introduzca una dirección IP o un bloque CIDR desde el que desee que Cloud Manager acepte solicitudes de API para esta cuenta de servicio.

    También puede hacer clic en Use Current IP Address si el host que está utilizando para acceder a Cloud Manager también realizará solicitudes API mediante esta cuenta de servicio.

  3. Haga clic en Save.

Ver el acceso programático a un proyecto

Puede ver los detalles de todas las API keys o cuentas de servicio que tienen acceso a su proyecto.

1

En MongoDB Cloud Manager, ve a la página Project Settings.

  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haga clic en Project Settings.

    La página Configuración del proyecto se muestra.

2
Ir a la página Applications.

En la barra lateral, haz clic en Applications en la sección Identity & Access.

Se muestra la página de Aplicaciones.

3

Haga clic en Service Accounts.

Se enumeran todas las cuentas de servicio con acceso a su proyecto.

Haz clic en el nombre de una cuenta de servicio para ver sus detalles, incluyendo:

  • El secreto cliente ofuscado para la cuenta de servicio

  • La fecha en que se usó por última vez el secreto de cliente

  • La fecha en que se creó el secreto del cliente

  • Las direcciones IP desde las que la cuenta de servicio puede acceder a la API

  • Los roles que se han asignado a la cuenta de servicio

Actualiza el acceso programático a un proyecto

1

En MongoDB Cloud Manager, ve a la página Project Settings.

  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haga clic en Project Settings.

    La página Configuración del proyecto se muestra.

2
Ir a la página Applications.

En la barra lateral, haz clic en Applications en la sección Identity & Access.

Se muestra la página de Aplicaciones.

3

Haga clic en Service Accounts.

4

Haz clic en el nombre de una cuenta de servicio.

5

Edite el Service Account Info.

Para modificar el Name o el Description, haz clic en .

6

Genera un nuevo secreto de cliente.

  1. Haga clic Generate New Client Secret

  2. Elija una duración para el secreto del cliente en el menú. El secreto del cliente expira después de este periodo de tiempo.

  3. Haga clic en Generate New.

  4. Haga clic en Copy y guarde el secreto del cliente en una ubicación segura. Esta es la única vez que puede visualizar el secreto completo del cliente.

7

Edite el Project Permissions.

  1. Haga clic en Edit Permissions.

  2. En el menú Project Permissions, selecciona el/a nuevo rol o roles para la cuenta de servicio.

  3. Haga clic en Save and next.

    Importante

    Las credenciales de la cuenta de servicio permanecen activas hasta que caduquen o un usuario las revoque.

8

Edite el API Access List.

  1. Para agregar una dirección IP o un bloque CIDR desde el cual desea que Cloud Manager acepte solicitudes de API para esta cuenta de servicio, haga clic en Add Access List Entry y escriba una dirección IP.

    También puedes hacer clic en Use Current IP Address si el host que utilizas para acceder a Cloud Manager también hará solicitudes API utilizando esta cuenta de servicio.

  2. Para eliminar una dirección IP de la lista de acceso, haga clic a la derecha de la dirección IP.

  3. Haga clic en Save.

Revocar el acceso programático a un proyecto

1

En MongoDB Cloud Manager, ve a la página Project Settings.

  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haga clic en Project Settings.

    La página Configuración del proyecto se muestra.

2
Ir a la página Applications.

En la barra lateral, haz clic en Applications en la sección Identity & Access.

Se muestra la página de Aplicaciones.

3

Haga clic en Service Accounts.

4

Remover la cuenta de servicio.

  1. Haga clic en el icono en Actions a la derecha de la cuenta de servicio que desea remover del proyecto.

  2. Haga clic en Remove from this project.

Importante

La cuenta de servicio aún existe en la organización y cualquier credencial existente permanece activa hasta que expire o sea revocada manualmente.

Realizar una solicitud de API.

La API de Cloud Manager utiliza uno de dos métodos de autenticación para validar las solicitudes: claves deAPI o una cuenta de servicio. Necesitará las claves o el secreto que guardó al configurar su método de autenticación preferido para completar los siguientes pasos.

Para realizar una solicitud API utilizando una cuenta de servicio, use la cuenta de servicio para generar un token de acceso y luego use el token de acceso en su solicitud:

1

Se debe recuperar el secreto del cliente para su cuenta de servicio.

Se debe localizar el secreto del cliente que comienza con mdb_sa_sk_ y que se guardó inmediatamente después de crear la cuenta de servicio, que fue la única vez que se pudo ver el secreto del cliente. Si no se guardó el secreto del cliente, debe generar uno nuevo.

2

Codifique en Base64el ID del cliente y el secreto.

Por ejemplo, ejecute:

echo -n {clientId}:{clientSecret} | base64 -w0
3

Se debe solicitar un token de acceso.

Se debe reemplazar {base64Auth} en el siguiente ejemplo con el resultado del paso anterior, luego se debe ejecutar:

1curl --request POST \
2     --url https://cloud.mongodb.com/api/oauth/token \
3     --header 'accept: application/json' \
4     --header 'cache-control: no-cache' \
5     --header 'authorization: Basic {base64Auth}' \
6     --header 'content-type: application/x-www-form-urlencoded' \
7     --data 'grant_type=client_credentials'
{"access_token":"{accessToken}""expires_in":3600,"token_type":"Bearer"}%

Importante

El token de acceso es válido por 1 hora (3600 segundos). No se puede actualizar un token de acceso. Cuando este token de acceso expire, se debe repetir este paso para generar uno nuevo.

4

Haz una llamada a la API.

Reemplace {accessToken} en el siguiente ejemplo con el resultado del paso anterior. Por ejemplo, --header 'Authorization: Bearer eyJ...pSnF' \.

La siguiente solicitud de muestra GET devuelve todos los proyectos para el usuario actual:

curl --request GET \
      --url https://cloud.mongodb.com/api/public/v1.0/groups \
      --header 'Authorization: Bearer {accessToken}' \
      --header 'Accept: application/json' \

La siguiente solicitud de muestra de POST toma un cuerpo de solicitud y crea un proyecto llamado MyProject en tu organización:

curl --header 'Authorization: Bearer {accessToken}' \
     --header 'Content-Type: application/json' \
     --header 'Accept: application/json' \
     --include \
     --request POST 'https://cloud.mongodb.com/api/public/v1.0/groups' \
     --data '
       {
         "name": "MyProject",
         "orgId": "5a0a1e7e0f2912c554080adc"
       }'
Volver
Configuración de acceso
Next
Tutorials
Califique esta página

En esta página