Skip to content

Commit 080320f

Browse files
committed
Add warning to environments/magento2.html regarding core issue w/ --lock-env
1 parent 4d8b828 commit 080320f

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

environments/magento2.md

+28
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,34 @@ In addition to the below manual process, there is a `Github Template available f
192192
segno "${OTPAUTH_URL}" -s 4 -o "pub/media/${ADMIN_USER}-totp-qr.png"
193193
printf "%s\n\n" "https://${TRAEFIK_SUBDOMAIN}.${TRAEFIK_DOMAIN}/media/${ADMIN_USER}-totp-qr.png?t=$(date +%s)"
194194

195+
:::{warning}
196+
**Adobe Commerce 2.4.8 core issue with ``--lock-env``**
197+
198+
Until [this core issue](https://github.com/magento/magento2/issues/39836) is addressed, the following command will result in a broken (unable to run ``bin/magento`` and ``mr`` commands) environment:
199+
``bin/magento config:set --lock-env twofactorauth/general/force_providers google``
200+
201+
The issue is due to the ``DuoSecurity`` 2FA Provider improperly reading the ``force-providers`` value from ``env.php``.
202+
203+
The workaround is to, after running the command, manually adjust the following content in ``env.php``:
204+
````
205+
'twofactorauth' => [
206+
'general' => [
207+
'force_providers' => [
208+
'google'
209+
]
210+
]
211+
]
212+
````
213+
with:
214+
````
215+
'twofactorauth' => [
216+
'general' => [
217+
'force_providers' => 'google'
218+
]
219+
]
220+
````
221+
:::
222+
195223
:::{note}
196224
Use of 2FA is mandatory on Magento ``2.4.x`` and setup of 2FA should be skipped when installing ``2.3.x`` or earlier. Where 2FA is setup manually via UI upon login rather than using the CLI commands above, the 2FA configuration email may be retrieved from `the Mailhog service <https://mailhog.warden.test/>`_.
197225
:::

0 commit comments

Comments
 (0)