Verwalten des Benutzerzugriffs
Adobe Commerce-Projekte zur Cloud-Infrastruktur nutzen rollenbasierten Zugriff. Auf Projektebene stehen zwei Rollen zur Verfügung:
- Projektadministrator: Schreiben Sie Zugriff auf alle Projektumgebungen und können Benutzer verwalten, Code pushen und Projekteinstellungen aktualisieren. (Zuvor als Super Admin bezeichnet)
- Projekt-Viewer: Schreibgeschützter Zugriff auf alle Projektumgebungen.
Projekt-Viewer können in keiner Umgebung Aufgaben ausführen. Sie können jedoch Projekt-Viewern Schreibzugriff auf einen bestimmten Umgebungstyp gewähren.
Der Zugriff auf Umgebungsebene basiert auf dem Umgebungstyp: Produktion, Staging und Entwicklung. Wenn einem Benutzer Viewer Berechtigungen für Entwicklungsumgebungen gewährt werden, können alle 5} Entwicklungsumgebungen im Projekt angezeigt werden. In der folgenden Tabelle werden die den einzelnen Berechtigungsebenen zugewiesenen Fähigkeiten erläutert:
Sie können Benutzer hinzufügen und Rollen mithilfe der CLI magento-cloud
oder der Cloud Console zuweisen.
Voraussetzungen:
- Ein registrierter Benutzer bei einem Adobe ID. Benutzer müssen sich für ein Adobe-Konto registrieren und dann ihr Cloud-Konto initialisieren, bevor sie einem Cloud-Projekt hinzugefügt werden können.
- Benutzer mit der Rolle Admin können Benutzer mit der CLI
magento-cloud
nicht verwalten. Benutzer, denen die Rolle Kontoinhaber zugewiesen wurde, können diese verwalten.
Benutzer mit der CLI verwalten
Verwenden Sie die magento-cloud
-CLI, um Benutzer zu verwalten und in automatisierte Systeme zu integrieren:
magento-cloud user:add
- Hinzufügen eines Benutzers zum Projektmagento-cloud user:delete
- Löschen eines Benutzersmagento-cloud user:list [users]
list-Projektbenutzermagento-cloud user:role
- Anzeigen oder Ändern der Benutzerrollemagento-cloud user:update
Benutzerrolle in einem Projekt aktualisieren
In den folgenden Beispielen wird die CLI magento-cloud
verwendet, um einen Benutzer hinzuzufügen, Rollen zu konfigurieren, Projektzuweisungen zu ändern und Benutzerrollen zuzuweisen.
So fügen Sie einen Benutzer hinzu und weisen die Rollen zu:
-
Verwenden Sie die CLI
magento-cloud
, um den Benutzer hinzuzufügen.code language-bash magento-cloud user:add
note important IMPORTANT Der Benutzer muss über eine Adobe ID verfügen; siehe die Voraussetzungen. -
Befolgen Sie die Anweisungen: Geben Sie die E-Mail-Adresse des Benutzers an, legen Sie die Rollen "Projekt"und "Umgebung"fest und fügen Sie den Benutzer hinzu.
Beispielaufforderungen
code language-none 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
Nachdem Sie den Benutzer hinzugefügt haben, sendet Adobe eine E-Mail mit Anweisungen zum Zugriff auf Adobe Commerce im Cloud-Infrastrukturprojekt an die angegebene Adresse.
Anzeigen der Projektrolle eines Benutzers
magento-cloud user:get alice@example.com
Beispielantwort:
Current role(s) of User (alice@example.com) on Production (project_id):
Project role: admin
Benutzer zu mehreren Umgebungen hinzufügen
So fügen Sie einen Benutzer als viewer
in einer Production
-Umgebung und als contributor
in einer Integration
-Umgebung hinzu:
magento-cloud user:add alice@example.com -r production:v -r integration:c
Berechtigungen der Benutzerumgebung aktualisieren
Aktualisieren der Benutzerumgebungsberechtigungen auf admin
in der Production
-Umgebung:
magento-cloud user:update alice@example.com -r production:a
Verwalten von Benutzern über die Cloud Console
Sie können die Cloud Console verwenden, um Berechtigungen hinzuzufügen, und die Funktion Bearbeiten verwenden, um Berechtigungen für einen vorhandenen Benutzer zu ändern.
Einen Benutzer zum Projekt hinzufügen
-
Melden Sie sich bei Cloud Console an.
-
Wählen Sie ein Projekt aus der Liste Alle Projekte aus.
-
Klicken Sie im Projekt-Dashboard auf das Konfigurationssymbol oben rechts.
-
Klicken Sie unter "Projekteinstellungen"auf "Access".
-
Klicken Sie in der Ansicht Zugriff auf Add.
-
Füllen Sie das Formular Add User aus:
-
Geben Sie die E-Mail-Adresse des Benutzers ein.
-
Project admin - Erteilen Sie Administratorrechte für alle Einstellungen und Umgebungstypen.
-
Environment types and permissions - Gewähren Sie bestimmten Umgebungstypen Zugriff und spezifische Berechtigungsstufen. Kein Zugriff, Admin (Einstellungen ändern, Aktion ausführen, Zusammenführungscode), Mitarbeiter (Push-Code) oder Betrachter (nur Ansicht).
note tip TIP Nur ein Projektadministrator kann Benutzer in jeder Umgebung verwalten. Um einem Benutzer Zugriff auf die Registerkarte Zugriff zu gewähren, muss diesem Benutzer ein anderer Projektadministrator oder der Kontoinhaber die Rolle Projektadministrator zuweisen. -
-
Klicken Sie auf Add User.
note important IMPORTANT Beim Hinzufügen eines Benutzers wird eine Bereitstellung nicht automatisch Trigger. -
Stellen Sie nach dem Hinzufügen von Benutzern alle Umgebungen erneut bereit, um die Änderungen anzuwenden. Beim Hinzufügen eines Benutzers wird eine Bereitstellung nicht automatisch Trigger. Die Neubereitstellung ist ein wichtiger Schritt, um sicherzustellen, dass der Benutzer über SSH auf eine Umgebung zugreifen oder Administratoraufgaben ausführen kann.
Nachdem Sie den Benutzer hinzugefügt haben, sendet Adobe eine E-Mail mit Anweisungen zum Zugriff auf Adobe Commerce im Cloud-Infrastrukturprojekt an die angegebene Adresse.
Authentifizierungspflichten für Benutzer
Für zusätzliche Sicherheit bietet Adobe eine Durchsetzung der Multi-Factor-Authentifizierung (MFA) auf Projektebene, sodass eine Zweifaktorauthentifizierung (TFA) für den SSH-Zugriff auf Adobe Commerce über den Quellcode und die Umgebungen von Cloud-Infrastruktur-Projekten erforderlich ist. Siehe MFA für SSH aktivieren.
Wenn die MFA-Durchsetzung in einem Adobe Commerce-Projekt zur Cloud-Infrastruktur aktiviert ist, müssen alle Benutzer mit SSH-Zugriff auf eine Umgebung in diesem Projekt TFA in ihrem Adobe Commerce-Konto für die Cloud-Infrastruktur aktivieren. Für automatisierte Prozesse können Sie einen Maschinenbenutzer und ein API-Token erstellen, die über die Befehlszeile authentifiziert werden.
Nachdem Sie einen Benutzer zu einem Cloud-Projekt hinzugefügt haben, bitten Sie den Benutzer, seine Kontosicherheitseinstellungen zu überprüfen und die folgenden Sicherheitskonfigurationen nach Bedarf hinzuzufügen:
-
Aktivieren Sie TFA: Erfüllen Sie die Sicherheits- und Compliance-Standards durch Konfiguration der Authentifizierung mit zwei Faktoren. Für Projekte, die mit der MFA-Durchsetzung konfiguriert wurden, ist TFA für Konten erforderlich, die SSH verwenden, um auf die Projekte zuzugreifen.
-
SSH-Schlüssel aktivieren - Benutzer, die Zugriff auf Adobe Commerce in Cloud-Infrastruktur-Quellcode-Repositorys benötigen, müssen SSH-Schlüssel in ihrem Konto aktivieren. Siehe Sichere Verbindungen.
-
API-Token erstellen: Benutzer müssen ein API-Token generieren, das für den SSH-Zugriff auf eine Umgebung verwendet wird. Sie benötigen das Token, um Authentifizierungs-Workflows für automatisierte Prozesse zu aktivieren.
Bei Projekten mit aktivierter MFA-Durchsetzung müssen Sie das API-Token verwenden, um SSH-Zugriffsanfragen von automatisierten Konten zu authentifizieren. Das Token ermöglicht automatisierte Prozesse, um Authentifizierungs-Workflows zu umgehen, die TFA erfordern.
Aktivieren von TFA für Cloud-Konten
Adobe Commerce on Cloud Infrastructure unterstützt TFA mit einer der folgenden Anwendungen:
Anweisungen zum Installieren der Authentifizierungsanwendung und Aktivieren von TFA finden Sie auf der Seite Kontoeinstellungen im Abschnitt Cloud Console.
Aktivieren von TFA für Ihr Benutzerkonto:
-
Melden Sie sich bei Ihrem Konto an.
-
Klicken Sie oben rechts im Kontomenü auf My Profile.
-
Klicken Sie auf der Registerkarte Sicherheit auf Set up application.
-
Wenn Sie auf Ihrem Mobilgerät keine genehmigte Authentifizierungsanwendung haben, installieren Sie eine mit den verknüpften Anweisungen.
-
Fügen Sie Ihr Adobe Commerce on Cloud-Infrastrukturkonto zur Authentifizierungsanwendung hinzu.
-
Öffnen Sie auf Ihrem Mobilgerät die Authentifizierungsanwendung. Fügen Sie dann den Einrichtungscode zur Anwendung hinzu.
-
Geben Sie auf der Seite TFA set up - Application den TFA-Code von Ihrem Mobilgerät in das Feld Application verification code ein.
-
Klicken Sie auf Verify and save.
Wenn der Code gültig ist, sendet Adobe eine Benachrichtigung an die E-Mail-Adresse des Kontos, die bestätigt, dass das Konto jetzt über TFA verfügt.
-
-
Optional. Aktivieren Sie die Einstellungen für vertrauenswürdigen Browser , um den Authentifizierungscode 30 Tage lang im Browser zwischenzuspeichern.
Diese Konfiguration reduziert die Anzahl der Authentifizierungsprobleme während der Projektanmeldung.
-
Klicken Sie auf Speichern oder Überspringen.
-
Speichern Sie die Wiederherstellungscodes.
-
Kopieren Sie auf der Seite "TFA-Setup - Recovery -Codes"die Wiederherstellungscodes und speichern Sie sie, damit Sie sich bei Ihrem Adobe Commerce-Projekt in der Cloud-Infrastruktur anmelden können, wenn Sie nicht auf Ihr Mobilgerät oder Ihre Authentifizierungsanwendung zugreifen können.
-
Kopieren Sie die Wiederherstellungscodes an einen anderen Speicherort oder schreiben Sie sie auf, falls Sie den Zugriff auf Ihr Gerät oder Ihre Authentifizierungsanwendung verlieren.
-
Klicken Sie auf Speichern , um die Codes in Ihrem Konto zu speichern, damit Sie sie in Ihren Kontosicherheitseinstellungen anzeigen und verwalten können.
note warning WARNING Wenn Sie den Zugriff auf ein Konto mit TFA verlieren und nicht über die Liste der Wiederherstellungscodes verfügen, müssen Sie sich an Ihren Projektadministrator wenden oder Senden Sie ein Adobe Commerce-Supportticket , um die TFA-Anwendung zurückzusetzen.
-
-
Klicken Sie nach Abschluss des TFA-Setups auf Speichern , um Ihr Konto zu aktualisieren.
-
Authentifizieren Sie Ihre aktuelle Sitzung mit TFA.
- Melden Sie sich von Ihrem Konto ab.
- Melden Sie sich mit Ihrem Benutzernamen und Kennwort an.
- Geben Sie bei Aufforderung den TFA-Code für den Eintrag
accounts.magento.cloud
aus der Authentifizierungsanwendung auf Ihrem Mobilgerät ein.
Verwalten von TFA-Konfigurations- und Wiederherstellungscodes
Sie können die TFA-Konfiguration für ein Adobe Commerce-Konto für Cloud-Infrastruktur im Abschnitt Sicherheit auf der Seite Mein Profil verwalten.
-
Melden Sie sich bei Ihrem Konto an.
-
Klicken Sie oben rechts im Kontomenü auf My Profile.
-
Klicken Sie auf der Seite Mein Profil auf die Registerkarte Security .
-
Verwenden Sie die verfügbaren Links, um die TFA-Einstellungen für Ihr Adobe Commerce-Konto für die Cloud-Infrastruktur zu aktualisieren:
- TFA deaktivieren
- Zurücksetzen der Authentifizierungsanwendung
- Hinzufügen oder Entfernen von vertrauenswürdigen Browsern
- Anzeigen oder Aktualisieren von TFA-Wiederherstellungscodes in Ihrem Konto
API-Token erstellen
Ein API-Token kann gegen ein OAuth 2-Zugriffstoken ausgetauscht werden, das dann zum Authentifizieren von Anfragen verwendet werden kann.
Bei Projekten mit aktivierter MFA-Durchsetzung müssen Sie über ein API-Token verfügen, um den SSH-Zugriff für Maschinenbenutzer und automatisierte Prozesse zu ermöglichen.
So erstellen Sie ein API-Token:
-
Melden Sie sich bei Ihrem Konto an.
-
Klicken Sie oben rechts im Kontomenü auf My Profile.
-
Klicken Sie auf der Seite Mein Profil auf die Registerkarte API tokens .
-
Klicken Sie auf Create API token und geben Sie einen Namen ein, z. B. einen Namen, der dem maschinellen Benutzer oder automatisierten Prozess entspricht, der das API-Token verwendet.
-
Klicken Sie auf Create API token.