Documentación Commerce Guía de Commerce en la nube

Administrar el acceso de usuario

Última actualización: 5 de mayo de 2025

Temas:
Nube

Creado para:

Administrador

Los proyectos de Adobe Commerce en infraestructura en la nube utilizan el acceso basado en roles. Hay dos funciones disponibles en el nivel de proyecto:

Administrador de proyectos: tiene acceso de escritura a todos los entornos de proyectos y puede administrar usuarios, insertar código y actualizar la configuración del proyecto. (Anteriormente conocido como Super admin)
Visor de proyectos: acceso de solo vista a todos los entornos de proyectos.

Los visualizadores de proyectos no pueden realizar tareas en ningún entorno; sin embargo, puede conceder a los visualizadores de proyectos acceso de escritura a un tipo de entorno específico.

El acceso a nivel de entorno se basa en el tipo de entorno: producción, ensayo y desarrollo. Conceder permiso al usuario viewer para desarrollar entornos significa que pueden ver todos los entornos de desarrollo en el proyecto. La siguiente tabla aclara las capacidades concedidas a cada nivel de permiso:

Nivel de permisos	Acceso	Acceso SSH
Administrador	Realizar tareas de administrador, como cambiar la configuración, insertar código, realizar tareas y administrar ramas, incluida la combinación con el entorno principal	Sí
Colaborador	Código push y bifurcación del entorno; no se puede cambiar la configuración ni ejecutar acciones	Sí
Visor	Acceso de solo vista al tipo de entorno	No
Sin acceso	Sin acceso al tipo de entorno	No

Puede agregar usuarios y asignar funciones mediante la CLI magento-cloud o Cloud Console.

Requisitos previos:

Un usuario registrado con una Adobe ID. Un usuario debe registrarse para obtener una cuenta de Adobe e inicializar su cuenta de nube para poder agregarla a un proyecto de nube.
Un usuario asignado al rol Admin no puede administrar usuarios con la CLI magento-cloud. Solo los usuarios a los que se les haya concedido el rol Propietario de la cuenta pueden administrar usuarios.

Administrar usuarios con la CLI

Utilice la CLI magento-cloud para administrar usuarios e integrarlos con sistemas automatizados:

magento-cloud user:add: agregar un usuario al proyecto
magento-cloud user:delete: eliminar un usuario
magento-cloud user:list [users]-enumerar usuarios del proyecto
magento-cloud user:role: ver o cambiar la función del usuario
magento-cloud user:update: actualizar el rol de usuario en un proyecto

Los siguientes ejemplos utilizan la CLI magento-cloud para agregar un usuario, configurar roles, modificar asignaciones de proyectos y asignar roles de usuario.

Para agregar un usuario y asignar roles:

Utilice la CLI magento-cloud para agregar al usuario.
magento-cloud user:add
IMPORTANT
El usuario debe tener un Adobe ID; consulte los requisitos previos.

Siga las indicaciones: especifique la dirección de correo electrónico del usuario, defina las funciones de tipo de entorno y proyecto, y añada el usuario.

Ejemplos de peticiones de datos

Enter the user's email address: alice@example.com

Email address: alice@example.com

The user's project role can be admin (a) or viewer (v).

Project role (default: viewer) [a/v]: viewer

The user's environment type role(s) can be admin (a), viewer (v), contributor (c) or none (n).

Role on type development (default: none) [a/v/c/n]: none
Role on type production (default: none) [a/v/c/n]: admin
Role on type staging (default: none) [a/v/c/n]: admin

Adding the user alice@example.com to (project_id):
Project role: viewer
  Role on type production: admin
  Role on type staging: admin

Are you sure you want to add this user? [Y/n] y
Adding the user to the project

Después de agregar el usuario, el Adobe de envía un correo electrónico a la dirección especificada con instrucciones para acceder al proyecto de infraestructura de Adobe Commerce en la nube.

Ver la función de proyecto de un usuario

magento-cloud user:get alice@example.com

Respuesta de ejemplo:

Current role(s) of User (alice@example.com) on Production (project_id):
  Project role: admin

Añadir un usuario a varios entornos

Para agregar un usuario como viewer en un entorno de Production y como contributor en un entorno de Integration:

magento-cloud user:add alice@example.com -r production:v -r integration:c

Actualizar permisos de entorno de usuario

Para actualizar los permisos del entorno de usuario a admin en el entorno Production:

magento-cloud user:update alice@example.com -r production:a

Administrar usuarios de Cloud Console

Puede usar Cloud Console para agregar permisos y usar la característica Editar para modificar los permisos de un usuario existente.

IMPORTANT

El usuario debe tener un Adobe ID; consulte los requisitos previos.

Agregar un usuario al proyecto

Inicie sesión en Cloud Console.
Seleccione un proyecto de la lista Todos los proyectos.
En el panel Proyecto, haga clic en el icono de configuración en la esquina superior derecha.
En Configuración del proyecto, haga clic en Access.
En la vista Acceso, haga clic en Add.
Complete el formulario Add User:
- Introduzca la dirección de correo electrónico del usuario.
- Project admin: conceder derechos de administrador a todas las configuraciones y tipos de entornos.
- Environment types and permissions: conceder acceso y niveles de permisos específicos a ciertos tipos de entornos. Sin acceso, Administrador (cambiar configuración, ejecutar acción, combinar código), Colaborador (código push) o Visor (solo vista).
TIP
Solo un administrador de proyecto puede administrar usuarios en cualquier entorno. Para conceder a un usuario acceso a la ficha Acceso, otro administrador del proyecto o el Propietario de la cuenta debe asignarle el rol Administrador del proyecto.
Haga clic en Add User.

IMPORTANT
Añadir un usuario no almacena en déclencheur una implementación automáticamente.
Después de agregar usuarios, vuelva a implementar todos los entornos para aplicar los cambios. Añadir un usuario no almacena en déclencheur una implementación automáticamente. La reimplementación es un paso importante para garantizar que el usuario puede acceder a un entorno mediante SSH o realizar tareas de administrador.

Después de agregar el usuario, el Adobe de envía un correo electrónico a la dirección especificada con instrucciones para acceder al proyecto de infraestructura de Adobe Commerce en la nube.

Requisitos de autenticación de usuario

Para obtener más seguridad, el Adobe de proporciona aplicación de autenticación multifactor (MFA) a nivel de proyecto para requerir autenticación de doble factor (TFA) para el acceso SSH a Adobe Commerce en el código fuente y los entornos del proyecto de infraestructura en la nube. Consulte Habilitar MFA para SSH.

Cuando la aplicación de MFA está habilitada en un proyecto de infraestructura en la nube de Adobe Commerce, todos los usuarios con acceso SSH a un entorno de ese proyecto deben habilitar TFA en su cuenta de infraestructura en la nube de Adobe Commerce. Para los procesos automatizados, puede crear un usuario del equipo y un token de API para autenticarse desde la línea de comandos.

Después de agregar un usuario a un proyecto de Cloud, pídale que revise la configuración de seguridad de su cuenta y agregue las siguientes configuraciones de seguridad según sea necesario:

Habilitar TFA: cumpla con los estándares de seguridad y cumplimiento mediante la configuración de la autenticación de doble factor. Los proyectos configurados con aplicación MFA requieren TFA en cuentas que usan SSH para acceder a los proyectos.
Habilitar claves SSH: los usuarios que requieran acceso a repositorios de código fuente de Adobe Commerce en la infraestructura de la nube deben habilitar claves SSH en su cuenta. Consulte Conexiones seguras.
Crear un token de API: los usuarios deben generar un token de API que se use para el acceso SSH a un entorno. Necesita el token para habilitar los flujos de trabajo de autenticación para los procesos automatizados.

En proyectos con la aplicación MFA habilitada, debe usar el token de API para autenticar solicitudes de acceso SSH desde cuentas automatizadas. El token permite que los procesos automatizados omitan los flujos de trabajo de autenticación que requieren TFA.

Habilitar TFA para cuentas de Cloud

Adobe Commerce en la infraestructura en la nube es compatible con TFA mediante cualquiera de las siguientes aplicaciones:

Las instrucciones para instalar la aplicación autenticadora y habilitar TFA están disponibles en la página Configuración de la cuenta en Cloud Console.

Para habilitar TFA en su cuenta de usuario:

Inicie sesión en su cuenta.
En el menú superior derecho de la cuenta, haga clic en My Profile.
En la ficha Seguridad, haga clic en Set up application.
Si no tiene una aplicación autenticadora aprobada en su dispositivo móvil, utilice las instrucciones vinculadas para instalar una.
Añada su cuenta de Adobe Commerce en la infraestructura de la nube a la aplicación autenticadora.
- En el dispositivo móvil, abra la aplicación autenticadora. A continuación, añada el código de configuración a la aplicación.
- En la página TFA set up - Application, escriba el código TFA de su dispositivo móvil en el campo Application verification code.
- Haga clic en Verify and save.
  
  Si el código es válido, Adobe envía una notificación a la dirección de correo electrónico de la cuenta para confirmar que la cuenta ahora tiene TFA.
Opcional. Habilite la configuración de Explorador de confianza para almacenar en caché el código de autenticación en el explorador durante 30 días.

Esta configuración reduce el número de desafíos de autenticación durante el inicio de sesión del proyecto.
Haga clic en Guardar o en Omitir.
Guarde los códigos de recuperación.
- En la página Configuración de TFA: códigos de recuperación, copie y guarde los códigos de recuperación para poder iniciar sesión en su proyecto de infraestructura de Adobe Commerce en la nube cuando no pueda acceder a su dispositivo móvil o aplicación de autenticación.
- Copie los códigos de recuperación en otra ubicación o anótelos en caso de que pierda el acceso a su dispositivo o aplicación de autenticación.
- Haz clic en Guardar para guardar los códigos en tu cuenta y así poder verlos y administrarlos desde la configuración de seguridad de la cuenta.
  
  WARNING
  Si pierde el acceso a una cuenta con TFA y no tiene la lista de códigos de recuperación, debe ponerse en contacto con el administrador del proyecto o enviar un vale de soporte técnico de Adobe Commerce para restablecer la aplicación TFA.
Después de completar la configuración de TFA, haz clic en Guardar para actualizar tu cuenta.
Autentique la sesión actual con TFA.
- Cierre la sesión de su cuenta.
- Inicie sesión con su nombre de usuario y contraseña.
- Cuando se le solicite, introduzca el código TFA para la entrada accounts.magento.cloud desde la aplicación autenticadora en su dispositivo móvil.

Administrar la configuración de TFA y los códigos de recuperación

Puede administrar la configuración de TFA para una cuenta de Adobe Commerce en la infraestructura de la nube desde la sección Seguridad en la página Mi perfil.

Inicie sesión en su cuenta.
En el menú superior derecho de la cuenta, haga clic en My Profile.
En la página Mi perfil, haga clic en la ficha Security.
Utilice los vínculos disponibles para actualizar la configuración de TFA de su cuenta de Adobe Commerce en la infraestructura de la nube:
- Deshabilitar TFA
- Restablecer la aplicación autenticadora
- Agregar o quitar exploradores de confianza
- Ver o actualizar los códigos de recuperación de TFA en su cuenta

Creación de un token de API

Se puede intercambiar un token de API por un token de acceso de OAuth 2, que luego se puede utilizar para autenticar solicitudes.

En los proyectos que tengan habilitada la aplicación MFA, debe tener un token de API para habilitar el acceso SSH para los usuarios del equipo y los procesos automatizados.

IMPORTANT

Valores de token de la API de Protect para su cuenta. No exponga el valor en muestras de código, capturas de pantalla o comunicaciones cliente-servidor no seguras. Además, no exponga el valor en el código fuente almacenado en repositorios públicos.

Para crear un token de API:

Inicie sesión en su cuenta.
En el menú superior derecho de la cuenta, haga clic en My Profile.
En la página Mi perfil, haga clic en la ficha API tokens.
Haga clic en Create API token e introduzca un nombre, por ejemplo, especifique un nombre que coincida con el usuario del equipo o el proceso automatizado que utiliza el token de API.
Haga clic en Create API token.