[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}

管理員變數

對雲端基礎結構專案具有Adobe Commerce管理存取許可權的使用者可以使用以下專案環境變數覆寫管理使用者帳戶的組態設定,以存取管理UI。

管理員認證

您可以在安裝Commerce期間使用下表中的管理員變數覆寫管理員使用者認證。

如果您要在安裝後變更值,請使用SSH連線至您的環境,並使用Adobe Commerce CLI admin:user命令來建立或編輯管理員使用者認證。

變數
預設
說明
ADMIN_USERNAME
授權擁有者電子郵件地址
管理員使用者的使用者名稱,可建立其他使用者,包括管理員使用者。
ADMIN_EMAIL
管理使用者的電子郵件地址。 此位址用於傳送密碼重設通知。
ADMIN_PASSWORD
管理使用者的密碼。 建立專案時,會產生隨機密碼並傳送電子郵件給授權所有者。 在專案建立期間,授權擁有者應該已經變更密碼。 請連絡授權擁有者,以取得更新的密碼。
ADMIN_LOCALE
en_US
管理員使用的預設地區設定。

管理員URL

使用以下環境變數來保護對管理員UI的存取。 若指定,此值會在安裝期間覆寫預設URL。 在雲端基礎結構上的Adobe Commerce中,您必須使用(Cloud Console或Cloud CLI)中的ADMIN_URL變數來設定或變更管理員URL。 從Admin修改設定僅適用於內部部署安裝。

ADMIN_URL — 存取管理員UI的相對URL。 預設URL為/admin

變更管理員URL

根據預設,Commerce管理員 URL已設定為​<網域名稱>/管理員。 基於安全考量,Adobe建議將其變更為不容易猜測的唯一自訂管理員URL。

在雲端基礎結構​上的Adobe Commerce中,您必須使用(Cloud Console或Cloud CLI)中的ADMIN_URL環境變數變更管理員URL。 從Admin修改設定僅適用於內部部署安裝。 對於內部部署安裝,請遵循使用自訂管理URL

Adobe建議您在安裝後變更Admin URL的環境層級變數。 基於安全考量設定此設定,然後再從複製的master環境進行分支。 除非您將繼承設定為false,否則從master分支建立的所有分支都會繼承環境層級變數及其值。

使用Cloud Console或Cloud CLI來設定或更新ADMIN_URL

選項A:使用Cloud Console變更管理員URL

整合環境

雲端主控台,新增變數並包含:

  • 名稱: ADMIN_URL

  • 值:​您的新管理員URL (例如,magento_A8v10

  • 如需詳細步驟,請參閱開發人員檔案中的新增環境變數環境變數

在Cloud Console中設定管理員URL
  1. 登入雲端主控台

  2. 從​ All projects ​清單中選取專案。

  3. 在專案概述中,選取環境並按一下設定圖示。

  4. 選取​ Variables ​標籤。

  5. 按一下​Create Variable (或編輯現有的ADMIN_URL變數(如果有的話)。

  6. 輸入下列內容:

    • 變數名稱: ADMIN_URL
    • 值:​您的新管理員路徑(例如,magento_A8v10)。

    預設會選取​ Available during runtime ​和​Make inheritable。 若要防止子環境繼承此值,請清除此變數的​Make inheritable

  7. 按一下​Create variable (或​Save)並等候部署完成。 只有當必填欄位包含值時,才會顯示按鈕。

當Cloud Console中無法使用測試和生產時

提交支援票證,要求為您的測試或生產環境新增ADMIN_URL變數。 如果可從Cloud Console存取暫存和生產環境,請依照整合環境中的說明新增變數。

選項B:使用Cloud CLI變更管理員URL

使用magento-cloud variable:update命令更新變數。 (variable:set命令已棄用,無法使用。)

下列範例將master環境ADMIN_URL更新為newAdmin_A8v10並防止子環境繼承值:

magento-cloud variable:update ADMIN_URL --value newAdmin_A8v10 -e master --inheritable false
  • 重新部署:​變更Cloud CLI中的ADMIN_URL變數會觸發環境重新部署。
  • 繼承:​變數預設為可繼承。 若要防止子環境繼承值,請使用--inheritable false選項,如下所示。 如需詳細資訊,請參閱變數層級可見度
NOTE
ADMIN_URL值接受字母(a-z、A-Z)、數字(0-9)和底線字元(_)。 不接受空格或其他字元。
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938