README

This Mautic plugin allows logins and sign ups via Auth0.

Requirements for this release

Tip

Other releases of this plugin may cover different Mautic versions!

Mautic 5, 6 or 7
PHP 8.1 or higher

Installation

Composer

This plugin can be installed through composer.

Manual Installation

Alternatively, it can be installed manually, following the usual steps:

Download the plugin
Unzip to the Mautic plugins directory
Rename folder to LeuchtfeuerAuth0Bundle
In the Mautic backend, go to the Plugins page as an administrator
Click on the Install/Upgrade Plugins button to install the Plugin. OR
If you have shell access, execute php bin\console cache:clear and php bin\console mautic:plugins:reload to install the plugins. Don't forget to activate the plugin in the plugin settings.

Configuration

Configuration	Description
domain	Auth0 Domain
audience	Link to audience (should be /api/v2)
client_id	ID of the client
client_secret	Secret of the client

Auth0 Configuration

You can configure the mapping (Auth0 data -> Mautic User data) in the configuration module. There are several options:

Configuration	Title	Default (Auth0) Value
auth0_username	Username	email
auth0_email	Email	email
auth0_firstName	First Name	given_name
auth0_lastName	Last Name	family_name
auth0_signature	Signature
auth0_position	Position
auth0_timezone	Timezone
auth0_locale	Language

Use dot syntax to access arrays (i.e. user_metadata.login_name).

Roles

If you want to map a role from Auth0 to your Mautic-User you have to alter your app_metadata in your Auth0-User (where <ROLE_ID> is the ID of your Mautic-Role):

{
    ...
    "mautic": {
        "role": <ROLE_ID>
    }
}

Update from Mautic 2.x.x to Mautic 3.x.x

When updating the plugin, please make sure to change the callback URL from ../s/sso_login/Auth0Auth to ../s/sso_login/Auth0 in your Auth0 application settings.

Update from Mautic 4.x.x to Mautic 5.x.x

When updating the plugin, please make sure to change the callback URL from ../s/sso_login/Auth0 to ../s/sso_login/LeuchtfeuerAuth0 in your Auth0 application settings.

Known Issues

Troubleshooting

Make sure you have not only installed but also enabled the Plugin. If things are still funny, please try php bin/console cache:clear

Change log

https://github.com/Leuchtfeuer/auth0-for-mautic/releases

Future Ideas

---Mention any planned updates, features, or ideas for future development.---

Sponsoring & Commercial Support

We are continuously improving our plugins. If you are requiring priority support or custom features, please contact us at mautic-plugins@leuchtfeuer.com.

Get Involved

Feel free to open issues or submit pull requests on GitHub. Follow the contribution guidelines in CONTRIBUTING.md.”

Credits

Author

Leuchtfeuer Digital Marketing GmbH Please raise any issues in GitHub. For all other things, please email mautic-plugins@Leuchtfeuer.com

License

“This plugin is licensed under the MIT License. See the LICENSE file for more details.”

leuchtfeuer/mautic-auth0-bundle

包简介

关键字：

README 文档