photon/auth-mongodb

Authentification and users for MongoDB

auth-mongodb

, _(*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',
)