2017 © Pedro Peláez
 

library auth-mongodb

Authentification and users for MongoDB

image

photon/auth-mongodb

Authentification and users for MongoDB

  • Saturday, March 3, 2018
  • by delkia
  • Repository
  • 2 Watchers
  • 0 Stars
  • 306 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 11 Versions
  • 0 % Grown

The README.md

auth-mongodb

Build Status, (*1)

MongoDB Backend for user, group, acl storage in photon, (*2)

Quick start

1) Add the module in your project, (*3)

composer require "photon/auth-mongodb:dev-master"

or for a specific version, (*4)

composer require "photon/auth-mongodb:^2.0"

2) Define a MongoDB connection in your project configuration, (*5)

Declare your MongoBD database, (*6)

'databases' => array(
    'default' => array(
        'engine' => '\photon\db\MongoDB',
        'server' => 'mongodb://localhost:27017/',
        'database' => 'orm',
        'options' => array(
            'connect' => true,
        ),
    ),
),

3) Enable session backend, (*7)

The authentification module use a session to store user information, (*8)

'session_storage' => '\photon\session\storage\MongoDB',
'session_cookie_path' => '/',
'session_timeout' => 4 * 60 * 60,
'session_mongodb' => array(
    'database' => 'default',
    'collection' => 'session',
),

4) Configure the authentification backend, (*9)

Configure the authentification backend to use this module, (*10)

'auth_backend' => '\photon\Auth\MongoDBBackend',

5) Create a user, (*11)

Create your first user to be able to login, (*12)

$user = new \photon\auth\MongoDBUser;
$user->setLogin('jd@exemple.com');
$user->setPassword('strong');
$user->save();

6) Create a login view, (*13)

Add a login view in your app, the following code is the minimal one, (*14)

class MyViews {
    public function login($request, $match)
    {
        if ($request->method === 'POST') {
            $user = \photon\auth\Auth::authenticate($request->POST);
            if ($user !== false) {
                \photon\auth\Auth::login($request, $user);
                return new Redirect('/');
            }
        }

        return shortcuts\Template::RenderToResponse('login.html', array(), $request);
    }
}

Declare the login view in your urls., (*15)

array('regex' => '#^/login$#',
      'view' => array('\Dummy', 'dummy'),
      'name' => 'login_view')

7) Enjoy !, (*16)

Advanced usage

Custom user class

If you want to add application specific content to the user class, you just have to extends it. It's allow you to change the collection name where object are stored., (*17)

class MyUser extends \photon\auth\MongoDBUser
{
    const collectionName = 'foobarcollection';

    public function isAdmin()
    {
        return $this->admin;
    }
}

Then, you must configure the MongoDB auth backend to use your class. Edit your photon configuration file to add :, (*18)

'auth_mongodb' => array(
    'user_class' => '\My\App\MyUser',
)

Protect your view with ACLs

The following view dummy is protected by precondition. The class MongoDBPrecondition will load the ACL with name adminPanel and ensure the user can access to this view, otherwize a 403 will be generated., (*19)

class Dummy
{
  public $dummy_precond = array(
  '\photon\auth\MongoDBPrecondition::adminPanel'
  );
  public function dummy($request, $match)
  {
    return new \photon\http\response\NoContent;
  }
}

The ACL can be created with the following code, (*20)

$acl = new \photon\auth\MongoDBAcl;
$acl->setName('adminPanel');
$acl->addUser($user);
$acl->save();

You can ensure all ACL are created with the following code, users can be added later., (*21)

\photon\auth\MongoDBAcl::ensureExists(['admin', 'api', 'ntp']);

Conditional rendering in templates

You can use MongoDBTemplateTag in your template to test user ACL., (*22)

{acl 'adminPanel'}
Will be display only if the user have the adminPanel acl
{/acl}

The template must be declared in your configuration file, (*23)

'template_tags' => array(
    'acl' => '\photon\auth\MongoDBTemplateTag',
)

The Versions

03/03 2018

dev-master

9999999-dev http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

03/03 2018

v2.1.1

2.1.1.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

26/02 2018

v2.1.0

2.1.0.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

10/01 2018

v2.0.2

2.0.2.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

26/09 2017

v2.0.1

2.0.1.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

19/04 2017

v2.0.0

2.0.0.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

18/02 2017

v1.2.0

1.2.0.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

18/02 2017

v1.1.2

1.1.2.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

22/12 2016

v1.1.1

1.1.1.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

19/12 2016

v1.1.0

1.1.0.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon

01/12 2016

v1.0.0

1.0.0.0 http://www.photon-project.com/

Authentification and users for MongoDB

  Sources   Download

LGPL-2.1

The Requires

 

The Development Requires

by William MARTIN

mongodb user auth photon