cakedc/users

Users Plugin for CakePHP

14.3 2024-09-05 07:50 UTC

Requires

• php: >=8.1
• cakedc/auth: ^10.0
• cakephp/authentication: ^3.0
• cakephp/authorization: ^3.0
• cakephp/cakephp: ^5.0

Requires (Dev)

• cakephp/cakephp-codesniffer: ^5.0
• google/recaptcha: @stable
• league/oauth1-client: ^1.7
• league/oauth2-facebook: @stable
• league/oauth2-google: @stable
• league/oauth2-instagram: @stable
• league/oauth2-linkedin: @stable
• luchianenco/oauth2-amazon: ^1.1
• phpunit/phpunit: ^10.0
• robthree/twofactorauth: ^2.0
• thenetworg/oauth2-azure: ^2.1
• web-auth/webauthn-lib: ^4.4

Suggests

• cakephp/authorization: Provide authorization for users
• google/recaptcha: Provides reCAPTCHA validation for registration form
• league/oauth1-client: Provides Social Authentication with Twitter
• league/oauth2-facebook: Provides Social Authentication with Facebook
• league/oauth2-google: Provides Social Authentication with Google+
• league/oauth2-instagram: Provides Social Authentication with Instagram
• league/oauth2-linkedin: Provides Social Authentication with LinkedIn
• luchianenco/oauth2-amazon: Provides Social Authentication with Amazon
• robthree/twofactorauth: Provides Google Authenticator functionality
• thenetworg/oauth2-azure: Provides Social Authentication with MS Azure

MIT

• CakeDC
• Others

• Authentication
• oauth2
• cakephp
• auth
• cakedc

README

Versions and branches

The Users plugin covers the following features:

• User registration
• Login/logout
• Social login (Facebook, Twitter, Instagram, Google, Linkedin, etc)
• Simple RBAC via https://github.com/CakeDC/auth
• Remember me (Cookie) via https://github.com/CakeDC/auth
• Manage user's profile
• Admin management
• One-Time Password for Two-Factor Authentication
• Webauthn for Two-Factor Authentication (Yubico Key compatible)
• reCaptcha v3 (14.2 only) and v2 supported in all versions
• Password Meter

The plugin is here to provide users related features following 2 approaches:

• Quick drop-in working solution for users login/registration. Get users working in 5 minutes.
• Extensible solution for a bigger/custom application. You'll be able to extend:
  • UsersAuth Component
  • Use your own UsersTable
  • Use your own Controller

On the previous versions of the plugin, extensibility was an issue, and one of the main objectives of the 3.0 rewrite is to guarantee all the pieces could be extended/reused as easily.

Another decision made was limiting the plugin dependencies on other packages as much as possible.

Requirements

• CakePHP 5.0+
• PHP 8.1+

Documentation

For documentation, as well as tutorials, see the Docs directory of this repository.

Support

For bugs and feature requests, please use the issues section of this repository.

Commercial support is also available, contact us for more information.

Contributing

This repository follows the CakeDC Plugin Standard. If you'd like to contribute new features, enhancements or bug fixes to the plugin, please read our Contribution Guidelines for detailed instructions.

Security

If you've found a security issue in CakeDC Users plugin, please use the procedure described in SECURITY.md

License

Copyright 2019 Cake Development Corporation (CakeDC). All rights reserved.

Licensed under the MIT License. Redistributions of the source code included in this repository must retain the copyright notice found in each file.