Gestion de l’accès des utilisateurs

Les projets Adobe Commerce sur l’infrastructure cloud utilisent un accès basé sur les rôles. Deux rôles sont disponibles au niveau du projet :

  • Administrateur de projet: accès en écriture à tous les environnements de projet et peut gérer les utilisateurs, le code push et mettre à jour les paramètres du projet.
  • Visionneuse de projet: accès en lecture seule à tous les environnements de projet.

Les visionneuses de projets ne peuvent pas effectuer de tâches sur un environnement, mais vous pouvez accorder aux visionneuses de projets l’accès en écriture à un type d’environnement spécifique.

L’accès au niveau de l’environnement est basé sur le type d’environnement : production, évaluation et développement. Octroi d’un utilisateur observateur autorisation de development environnements signifie qu’ils peuvent afficher all environnements de développement du projet. Le tableau suivant clarifie les fonctionnalités accordées à chaque niveau d’autorisation :

Niveau d’autorisation
Accès
Accès SSH
Administration
Effectuez les tâches de l’administrateur, telles que les paramètres de modification, le code push, les tâches et la gestion des branches, y compris la fusion avec l’environnement parent.
Oui
Contributeur
code push et branche l’environnement ; ne peut pas modifier les paramètres ni exécuter des actions.
Oui
Visionneuse
Accès en lecture seule au type d'environnement
Non
Accès interdit
Accès au type d'environnement interdit
Non

Vous pouvez ajouter des utilisateurs et affecter des rôles à l’aide de la fonction magento-cloud Interface en ligne de commande ou la variable Cloud Console.

recommendation-more-help

Conditions préalables :

  • Un utilisateur enregistré avec une Adobe ID. Un utilisateur doit s’enregistrer pour un compte Adobe puis initialisation de leur compte Cloud avant de pouvoir les ajouter à un projet Cloud.
  • Un utilisateur a affecté la variable Administration ne peut pas gérer les utilisateurs avec magento-cloud Interface de ligne de commande. Seuls les utilisateurs qui se voient accorder le Propriétaire du compte peut gérer les utilisateurs.

Gestion des utilisateurs à l’aide de l’interface en ligne de commande

Utilisez la variable magento-cloud Interface en ligne de commande pour gérer les utilisateurs et intégrer les systèmes automatisés :

  • magento-cloud user:add-ajout d’un utilisateur au projet
  • magento-cloud user:delete-supprimer un utilisateur
  • magento-cloud user:list [users]Liste des utilisateurs de projet
  • magento-cloud user:role-afficher ou modifier le rôle d’utilisateur
  • magento-cloud user:update-mise à jour du rôle utilisateur sur un projet

Les exemples suivants utilisent la méthode magento-cloud Interface en ligne de commande pour ajouter un utilisateur, configurer des rôles, modifier des affectations de projet et affecter des rôles utilisateur.

Ajout d’un utilisateur et affectation de rôles:

  1. Utilisez la variable magento-cloud Interface de ligne de commande pour ajouter l’utilisateur.

    code language-bash
    magento-cloud user:add
    
    note important
    IMPORTANT
    L’utilisateur doit disposer d’une Adobe ID ; voir conditions préalables.
  2. Suivez les invites : spécifiez l’adresse électronique de l’utilisateur, définissez les rôles de type projet et environnement, puis ajoutez l’utilisateur.

    Exemples de invites

    code language-terminal
    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
    

    Une fois l’utilisateur ajouté, Adobe envoie un courrier électronique à l’adresse spécifiée avec des instructions pour accéder au projet d’infrastructure cloud Adobe Commerce.

Affichage du rôle de projet d’un utilisateur

magento-cloud user:get alice@example.com

Exemple de réponse :

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

Ajout d’un utilisateur à plusieurs environnements

Pour ajouter un utilisateur en tant que viewer sur un Production et en tant que contributor sur un Integration environnement :

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

Mise à jour des autorisations d’environnement utilisateur

Pour mettre à jour les autorisations d’environnement utilisateur vers admin sur le Production environnement :

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

Gestion des utilisateurs à partir de Cloud Console

Vous pouvez utiliser la variable Cloud Console pour ajouter des autorisations et utiliser la variable Modifier pour modifier les autorisations d’un utilisateur existant.

IMPORTANT
L’utilisateur doit disposer d’une Adobe ID ; voir conditions préalables.

Ajout d’un utilisateur au projet

  1. Connectez-vous au Cloud Console.

  2. Sélectionnez un projet dans le Tous les projets liste.

  3. Dans le tableau de bord du projet, cliquez sur l’icône de configuration en haut à droite.

  4. Sous Paramètres du projet, cliquez sur Access.

  5. Dans le Accès afficher, cliquez sur Add.

  6. Procédez comme suit : Add User ​form :

    • Saisissez l’adresse électronique de l’utilisateur.

    • Project admin: octroyez des droits d’administrateur à tous les paramètres et types d’environnements.

    • Environment types and permissions: accordez l’accès et des niveaux d’autorisation spécifiques à certains types d’environnements. Accès interdit, Administration (modifier les paramètres, exécuter une action, fusionner le code), Contributeur (code push), ou Visionneuse (affichage uniquement).

    note tip
    TIP
    Uniquement un Administrateur de projet peut gérer les utilisateurs dans n’importe quel environnement. Pour accorder à un utilisateur l’accès à la variable Accès onglet, autre Administrateur de projet ou le Propriétaire du compte doit affecter à l’utilisateur la variable Administrateur de projet rôle.
  7. Cliquez sur Add User.

    note important
    IMPORTANT
    L’ajout d’un utilisateur ne déclenche pas automatiquement un déploiement.
  8. Après avoir ajouté des utilisateurs, redéployez tous les environnements pour appliquer les modifications. L’ajout d’un utilisateur ne déclenche pas automatiquement un déploiement. Le redéploiement est une étape importante pour s’assurer que l’utilisateur peut accéder à un environnement à l’aide de SSH ou effectuer des tâches d’administrateur.

Une fois l’utilisateur ajouté, Adobe envoie un courrier électronique à l’adresse spécifiée avec des instructions pour accéder au projet d’infrastructure cloud Adobe Commerce.

Exigences d’authentification des utilisateurs

Pour plus de sécurité, Adobe fournit une application d’authentification multifactorielle au niveau du projet (MFA) qui nécessite une authentification à deux facteurs (TFA) pour l’accès SSH à Adobe Commerce sur le code source et les environnements du projet d’infrastructure cloud. Voir Activation de MFA pour SSH.

Lorsque l’application MFA est activée sur un projet d’infrastructure cloud Adobe Commerce, tous les utilisateurs disposant d’un accès SSH à un environnement dans ce projet doivent activer TFA sur leur compte d’infrastructure cloud Adobe Commerce. Pour les processus automatisés, vous pouvez créer un utilisateur de machine et un jeton API pour vous authentifier à partir de la ligne de commande.

Après avoir ajouté un utilisateur à un projet Cloud, demandez à l’utilisateur de vérifier les paramètres de sécurité de son compte et d’ajouter les configurations de sécurité suivantes, le cas échéant :

  • Activer TFA: respectez les normes de sécurité et de conformité en configurant l’authentification à deux facteurs. Projets configurés avec Application MFA nécessitent TFA sur les comptes qui utilisent SSH pour accéder aux projets.

  • Activation des clés SSH: les utilisateurs qui ont besoin d’un accès à Adobe Commerce dans les référentiels de code source de l’infrastructure cloud doivent activer les clés SSH sur leur compte. Voir Connexions sécurisées.

  • Création d’un jeton API: les utilisateurs doivent générer un jeton API utilisé pour l’accès SSH à un environnement. Vous avez besoin du jeton pour activer les workflows d’authentification pour les processus automatisés.

    Sur les projets pour lesquels l’application de la loi MFA est activée, vous devez utiliser le jeton API pour authentifier les demandes d’accès SSH provenant de comptes automatisés. Le jeton permet aux processus automatisés de contourner les workflows d’authentification qui nécessitent TFA.

Activation de TFA pour les comptes cloud

Adobe Commerce sur l’infrastructure cloud prend en charge TFA à l’aide de l’une des applications suivantes :

Les instructions d’installation de l’application d’authentification et d’activation de TFA sont disponibles sur la page Paramètres du compte dans la Cloud Console.

Pour activer TFA sur votre compte utilisateur:

  1. Connexion à votre compte.

  2. Dans le menu supérieur droit du compte, cliquez sur My Profile.

  3. Sur le Sécurité , cliquez sur Set up application.

  4. Si vous ne disposez pas d’une application d’authentification approuvée sur votre périphérique mobile, utilisez les instructions associées pour l’installer.

  5. Ajoutez votre compte Adobe Commerce sur l’infrastructure cloud à l’application d’authentification.

    • Sur votre périphérique mobile, ouvrez l’application d’authentification. Ajoutez ensuite le code de configuration à l’application.

    • Dans le TFA set up - Application , saisissez le code TFA de votre périphérique mobile dans la variable Application verification code champ .

    • Cliquez sur Verify and save.

      Si le code est valide, Adobe envoie une notification à l’adresse électronique du compte confirmant que le compte dispose désormais de TFA.

  6. Facultatif. Activer Navigateur approuvé paramètres pour mettre le code d’authentification en cache dans le navigateur pendant 30 jours.

    Cette configuration réduit le nombre de problèmes d’authentification lors de la connexion au projet.

  7. Cliquez sur Enregistrer ou Ignorer.

  8. Enregistrez les codes de récupération.

    • Sur le Configuration TFA - Récupération codes, copiez et enregistrez les codes de récupération afin que vous puissiez vous connecter à votre projet d’infrastructure cloud Adobe Commerce lorsque vous ne pouvez pas accéder à votre périphérique mobile ou à votre application d’authentification.

    • Copiez les codes de récupération à un autre emplacement ou notez-les si vous ne pouvez plus accéder à votre périphérique ou application d’authentification.

    • Cliquez sur Enregistrer pour enregistrer les codes dans votre compte afin de pouvoir les afficher et les gérer à partir des paramètres de sécurité de votre compte.

      note warning
      WARNING
      Si vous n’avez plus accès à un compte avec TFA et que vous ne disposez pas de la liste des codes de récupération, vous devez contacter votre administrateur de projet, ou Envoi d’un ticket d’assistance Adobe Commerce pour réinitialiser l’application TFA.
  9. Une fois la configuration TFA terminée, cliquez sur Enregistrer pour mettre à jour votre compte.

  10. Authentifiez la session en cours avec TFA.

    • Déconnectez-vous de votre compte.
    • Connectez-vous avec votre nom d’utilisateur et votre mot de passe.
    • Lorsque vous y êtes invité, saisissez le code TFA correspondant au accounts.magento.cloud entrée de l’application d’authentification sur votre appareil mobile.

Gestion des codes de configuration et de récupération TFA

Vous pouvez gérer la configuration TFA d’un compte Adobe Commerce sur l’infrastructure cloud à partir du Sécurité de la section Mon profil page.

  1. Connexion à votre compte.

  2. Dans le menu supérieur droit du compte, cliquez sur My Profile.

  3. Sur le Mon profil , cliquez sur Security .

  4. Utilisez les liens disponibles pour mettre à jour les paramètres TFA de votre compte Adobe Commerce sur l’infrastructure cloud :

    • Désactiver TFA
    • Réinitialisation de l’application d’authentification
    • Ajout ou suppression de navigateurs approuvés
    • Afficher ou actualiser les codes de récupération TFA sur votre compte

Création d’un jeton API

Un jeton API peut être échangé contre un jeton d’accès OAuth 2, qui peut ensuite être utilisé pour authentifier les requêtes.

Sur les projets pour lesquels l’application de la loi MFA est activée, vous devez disposer d’un jeton API pour activer l’accès SSH pour les utilisateurs de la machine et les processus automatisés.

IMPORTANT
Valeurs de jeton API Protect pour votre compte. N’exposez pas la valeur dans des exemples de code, des captures d’écran ou des communications client-serveur non sécurisées. De plus, n’exposez pas la valeur dans le code source stocké dans des référentiels publics.

Pour créer un jeton API:

  1. Connexion à votre compte.

  2. Dans le menu supérieur droit du compte, cliquez sur My Profile.

  3. Sur le Mon profil , cliquez sur API tokens .

  4. Cliquez sur Create API token et saisissez un nom, par exemple, qui correspond à l’utilisateur de l’ordinateur ou au processus automatisé qui utilise le jeton API.

    Jetons API

  5. Cliquez sur Create API token.

05f2f56e-ac5d-4931-8cdb-764e60e16f26