Skip to main content

admin_users — module reference

Rendered from the module's own manifest, and from nothing written by hand. What the module does is its own page.

Module idadmin_users
NameAdmin users
Version1.0.0
Ships from@endora-commerce/mod-admin-users
LicenceMIT

Activation​

This module cannot be switched off. Owns admin login, sessions and impersonation; switched off, no operator could sign in to the Admin UI at all — including to switch it back on.

Dependencies​

ModuleBindingWhat it means
admin_rolesyesinstalls and migrates after it, and an operator cannot switch it off underneath this module
authyesinstalls and migrates after it, and an operator cannot switch it off underneath this module
customer_accountsgating onlyresolves customerAccountReadPort; withheld from dependencies because the install order cannot carry the edge
organizationsgating onlyresolves organizationRoleReadPort; withheld from dependencies because the install order cannot carry the edge
assets_librarynodegrades-without assetReadPort — An administrator cannot set an author avatar while the library is off; the one already set is kept and comes back with the library. Everything else on the profile still saves.
mfanodegrades-without mfaAdminEnforcementPort — No session is ended when a role starts requiring two-step verification, and no role can start requiring it; a role that already does applies again when MFA is back.
mfanodegrades-without mfaEnrolmentStatePort — Reads "no second factor" for every admin on /admin-users, on /admin/me and on the login response. True while MFA is off — admin sign-in asks for none — and not a claim that nobody is enrolled.
mfanodegrades-without mfaLoginPort — Admin sign-in asks for no second factor, applies no role's two-step requirement and offers no Google/Microsoft button. A peer admin can reset any password, so nobody is locked out.

Permissions​

CodeLabelAlso needs
customers:impersonateImpersonate customers—

Command palette​

ActionOpensPermission
open-admin-users/admin-usersadmin_users:manage

Settings​

None.

Translations​

Bundles at i18n inside the module, one file per shipped language.

Operator commands​

Run these in the root of an instance. In a checkout of the Endora Commerce repository the same commands are pnpm --filter backend run cli -- admin_users <command>.

CommandWhat it does
pnpm run cli admin_users createCreate or update an admin user, bootstrapping the platform_admin role.
pnpm run cli admin_users unlockClear the authentication throttle for one admin account.