2017 © Pedro Peláez
 

cakephp-plugin cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

image

dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  • Wednesday, July 25, 2018
  • by dereuromark
  • Repository
  • 9 Watchers
  • 83 Stars
  • 34,949 Installations
  • PHP
  • 5 Dependents
  • 1 Suggesters
  • 27 Forks
  • 3 Open issues
  • 21 Versions
  • 13 % Grown

The README.md

CakePHP TinyAuth Plugin

CI Latest Stable Version Coverage Status Minimum PHP Version License Total Downloads Coding Standards, (*1)

A CakePHP plugin to handle authentication and user authorization the easy way., (*2)

This branch is for CakePHP 5.0+. For details see version map., (*3)

Features

Authentication

What are public actions, which ones need login?, (*4)

  • Powerful wildcard (*) operator.
  • Quick Setup for 5 minute integration.

Authorization

Once you are logged in, what actions can you see with your role(s)?, (*5)

  • Single-role: 1 user has 1 role (users and roles table for example)
  • Multi-role: 1 user can have 1...n roles (users, roles and a "roles_users" pivot table for example)
  • Quick Setup for 5 minute integration.

Useful helpers

  • AuthUser Component and Helper for stateful and stateless "auth data" access.
  • Authentication Component and Helper for isPublic() check on current other other actions.
  • Auth DebugKit panel for detailed insights into current URL and auth status.

What's the idea?

Default CakePHP authentication and authorization depends on code changes in at least each controller, maybe more classes. This plugin hooks in with a single line of change and manages all that using config files and there is no need to touch all those controllers, including plugin controllers., (*6)

It is also possible to manage the config files without the need to code. And it can with adapters also be moved completely to the DB and managed by CRUD backend., (*7)

Ask yourself: Do you need the overhead and complexity involved with the full blown (RBAC DB) ACL? See also my post acl-access-control-lists-revised/. If not, then this plugin could very well be your answer and a super quick solution to your auth problem :), (*8)

But even if you don't leverage the authentication or authorization, the available AuthUserComponent and AuthUserHelper can be very useful when dealing with role based decisions in your controller or view level. They also work stand-alone., (*9)

Demo

See https://sandbox.dereuromark.de/auth-sandbox, (*10)

auth_allow.ini

Define the public actions (accessible by anyone) per controller:, (*11)

Users = index,view
Admin/Maintenance = pingCheck
PluginName.SomeController = *
MyPlugin.Api/V1 = *

auth_acl.ini

Define what actions may be accessed by what logged-in user role:, (*12)

[Users]
index = *
add,edit = user,super-user

[Admin/Users]
* = admin

[Translate.Admin/Languages]
* = *

AuthUser component and helper

$currentId = $this->AuthUser->id();

$isMe = $this->AuthUser->isMe($userEntity->id);

if ($this->AuthUser->hasRole('mod')) {
}

if ($this->AuthUser->hasAccess(['action' => 'secretArea'])) {
}

// Helper only
echo $this->AuthUser->link('Admin Backend', ['prefix' => 'Admin', 'action' => 'index']);
echo $this->AuthUser->postLink('Delete', ['action' => 'delete', $id], ['confirm' => 'Sure?']);

Installation

Including the plugin is pretty much as with every other CakePHP plugin:, (*13)

composer require dereuromark/cakephp-tinyauth

Then, to load the plugin either run the following command:, (*14)

bin/cake plugin load TinyAuth

or manually add the following line to your app's src/Application.php file's bootstrap() function:, (*15)

$this->addPlugin('TinyAuth');

That's it. It should be up and running., (*16)

Docs

For setup and usage see Docs., (*17)

Also note the original blog post and how it all started., (*18)

The Versions

25/07 2018

dev-master

9999999-dev https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

25/07 2018

1.9.0

1.9.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

18/04 2018

dev-cleanup

dev-cleanup https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

18/04 2018

1.8.0

1.8.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

14/02 2018

dev-develop

dev-develop https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

14/02 2018

1.7.0

1.7.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

25/02 2017

1.6.4

1.6.4.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

20/12 2016

1.6.3

1.6.3.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

18/12 2016

1.6.2

1.6.2.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

24/10 2016

1.6.1

1.6.1.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

22/10 2016

1.6.0

1.6.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

14/09 2016

1.5.2

1.5.2.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

14/09 2016

1.5.1

1.5.1.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authentication and authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authentication authorization cakephp roles tinyauth

27/08 2016

1.5.0

1.5.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authorization cakephp roles tinyauth

15/08 2016

1.4.0

1.4.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authorization cakephp roles tinyauth

26/03 2016

1.3.0

1.3.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authorization the easy way.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Mark Scherer

plugin authorization cakephp roles tinyauth

06/01 2016

1.2.0

1.2.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authorization the easy way.

  Sources   Download

MIT

The Requires

 

by Mark Scherer

plugin authorization cakephp roles tinyauth

31/12 2015

1.1.1

1.1.1.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authorization the easy way.

  Sources   Download

MIT

The Requires

 

by Mark Scherer

plugin authorization cakephp roles tinyauth

29/09 2015

1.1.0

1.1.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authorization the easy way.

  Sources   Download

MIT

The Requires

 

by Mark Scherer

plugin authorization cakephp roles tinyauth

25/04 2015

1.0.0

1.0.0.0 https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authorization the easy way.

  Sources   Download

MIT

The Requires

 

by Mark Scherer

plugin authorization cakephp roles tinyauth

07/03 2015

dev-develop-auth-shell

dev-develop-auth-shell https://github.com/dereuromark/cakephp-tinyauth

A CakePHP plugin to handle user authorization the easy way.

  Sources   Download

MIT

The Requires

 

by Mark Scherer

plugin authorization cakephp roles tinyauth