Admin-Variablen

Last update: Wed Mar 04 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

Entwickler

Benutzer mit administrativem Zugriff auf das Adobe Commerce on Cloud-Infrastrukturprojekt können die folgenden Projektumgebungsvariablen verwenden, um die Konfigurationseinstellungen für das Administratorbenutzerkonto für den Zugriff auf die Admin-Benutzeroberfläche zu überschreiben.

Admin-Anmeldedaten

Sie können die Admin-Benutzeranmeldeinformationen während der Commerce-Installation mit den ADMIN-Variablen in der folgenden Tabelle überschreiben.

Wenn Sie die Werte nach der Installation ändern möchten, stellen Sie eine Verbindung mit Ihrer Umgebung her, indem Sie SSH verwenden, und verwenden Sie den Adobe Commerce CLI-admin:user, um die Admin-Benutzeranmeldeinformationen zu erstellen oder zu bearbeiten.

Variable

Standard

Beschreibung

ADMIN_USERNAME

Lizenzinhaber - E-Mail-Adresse

Ein Benutzername für den Benutzer mit Administratorrechten, der andere Benutzer erstellen kann, einschließlich Benutzer mit Administratorrechten.

ADMIN_EMAIL

E-Mail-Adresse des Administrationsbenutzers. Diese Adresse wird verwendet, um Benachrichtigungen zum Zurücksetzen des Kennworts zu senden.

ADMIN_PASSWORD

Kennwort für den Benutzer mit Administratorrechten. Wenn das Projekt erstellt wird, wird ein zufälliges Kennwort generiert und eine E-Mail an den Lizenzinhaber gesendet. Bei der Projekterstellung sollte der Lizenzinhaber das Kennwort bereits geändert haben. Wenden Sie sich an den Lizenzinhaber, um das aktualisierte Passwort zu erhalten.

ADMIN_LOCALE

en_US

Das vom Administrator verwendete Standardgebietsschema.

Admin-URL

Verwenden Sie die folgende Umgebungsvariable, um den Zugriff auf Ihre Admin-Benutzeroberfläche zu sichern. Falls angegeben, überschreibt dieser Wert die Standard-URL während der Installation. In Adobe Commerce auf der Cloud-Infrastruktur müssen Sie die Admin-URL mithilfe der ADMIN_URL in der (Cloud Console oder Cloud CLI) festlegen oder ändern. Das Ändern der Einstellung über die Admin gilt nur für lokale Installationen.

ADMIN_URL - Die relative URL für den Zugriff auf die Admin-Benutzeroberfläche. Die Standard-URL lautet /admin.

Admin-URL ändern

Standardmäßig ist die URL Commerce Admin auf <domain_name>/admin festgelegt. Aus Sicherheitsgründen empfiehlt Adobe, sie in eine eindeutige, benutzerdefinierte Admin-URL zu ändern, die nicht einfach zu erraten ist.

In Adobe Commerce auf der Cloud Infrastruktur müssen Sie die Admin-URL mithilfe der ADMIN_URL Umgebungsvariablen in der (Cloud Console oder Cloud CLI) ändern. Das Ändern der Einstellung über die Admin gilt nur für lokale Installationen. Bei On-Premise-Installationen folgen Sie Benutzerdefinierte Admin-URL verwenden.

Adobe empfiehlt, die Variable auf Umgebungsebene für die Admin-URL nach der Installation zu ändern. Konfigurieren Sie diese Einstellung aus Sicherheitsgründen, bevor Sie eine Verzweigung aus der geklonten master erstellen. Alle aus der master Verzweigung erstellten Verzweigungen übernehmen die Variablen und deren Werte auf Umgebungsebene, es sei denn, die Vererbung wird auf „false“ festgelegt.

Verwenden Sie entweder die Cloud Console oder die Cloud CLI, um ADMIN_URL festzulegen oder zu aktualisieren.

Option A: Ändern der Admin-URL mithilfe der Cloud Console

Integrationsumgebung

Fügen Sie in Cloud-" eine neue Variable hinzu mit:

name: ADMIN_URL
Wert: Ihre neue Admin-URL (z. B. magento_A8v10)
Detaillierte Anweisungen finden Sie unter Hinzufügen von oder Umgebungsvariablen in unserer Entwicklerdokumentation.

Admin-URL im Cloud Console festlegen

Melden Sie sich bei der Cloud-Konsole an.
Wählen Sie ein Projekt aus der Liste All projects aus.
Wählen Sie in der Projektübersicht die Umgebung aus und klicken Sie auf das Konfigurationssymbol.
Wählen Sie die Registerkarte Variables aus.
Klicken Sie auf Create Variable (oder bearbeiten Sie die vorhandene ADMIN_URL, falls vorhanden).
Geben Sie Folgendes ein:
- Variablenname: ADMIN_URL
- Wert: Ihr neuer Administratorpfad (z. B. magento_A8v10).
Standardmäßig sind Available during runtime und Make inheritable ausgewählt. Um zu verhindern, dass untergeordnete Umgebungen diesen Wert erben, löschen Sie die Make inheritable für diese Variable.
Klicken Sie auf Create variable (oder Save) und warten Sie, bis die Bereitstellung abgeschlossen ist. Die Schaltfläche ist nur sichtbar, wenn die erforderlichen Felder Werte enthalten.

Wenn Staging und Produktion in der Cloud Console nicht verfügbar sind

Senden eines Support-Tickets mit der Aufforderung, die ADMIN_URL Variable für Ihre Staging- oder Produktionsumgebung hinzuzufügen. Wenn über die Cloud Console auf Staging- und Produktionsumgebung zugegriffen werden kann, fügen Sie die Variable hinzu, wie in Integrationsumgebung beschrieben.

Option B: Ändern der Admin-URL mithilfe der Cloud CLI

Verwenden Sie den Befehl magento-cloud variable:update , um die Variable zu aktualisieren. (Der variable:set-Befehl wird nicht mehr unterstützt und ist nicht verfügbar.)

Im folgenden Beispiel wird der ADMIN_URL der master Umgebung auf newAdmin_A8v10 aktualisiert und untergeordnete Umgebungen werden daran gehindert, den Wert zu erben:

magento-cloud variable:update ADMIN_URL --value newAdmin_A8v10 -e master --inheritable false

Neu-Bereitstellung Das Ändern der ADMIN_URL in den Cloud CLI Triggern führt zu einer erneuten Bereitstellung der Umgebung.
Vererbung Variablen werden standardmäßig vererbt. Um zu verhindern, dass der Wert an untergeordnete Umgebungen vererbt wird, verwenden Sie die --inheritable false Option wie abgebildet. Weitere Informationen finden Sie unter Sichtbarkeit auf Variablenebene.

NOTE

Der ADMIN_URL akzeptiert Buchstaben (a-z, A-Z), Zahlen (0-9) und den Unterstrich (_). Leerzeichen oder andere Zeichen werden nicht akzeptiert.

recommendation-more-help

7c2b03ac-000c-497d-aba3-2c6dc720a938