官术网_书友最值得收藏!

Using prefixes for role-based access control

Even though CakePHP provides a very powerful access control layer, sometimes we just need to implement user roles without having to go into the details of specifying which role is allowed access to which action.

This recipe shows how to limit access to certain actions by role-using routing prefixes, which constitutes a perfect solution for simple role-based authentication. In order to accomplish this recipe, we will assume the need to add three user roles in our application: administrators, managers, and users.

Getting ready

We should have a working authentication system, so follow the recipe, Setting up a basic authentication system. The users table should also contain a field to hold the user's role (named role.) Add this field with the following SQL statement:

ALTER TABLE `users`
ADD COLUMN `role` VARCHAR(255) DEFAULT NULL AFTER `password`;

How to do it...

  1. Edit your app/config/core.php file and look for the line that defines the Routing.prefixes setting. If it is commented out, uncomment it. Then change it to:
    Configure::write('Routing.prefixes', array('admin', 'manager'));
    
  2. Add the following code at the end of your UsersController class definition:
    public function dashboard() {
    $role = $this->Auth->user('role');
    if (!empty($role)) {
    $this->redirect(array($role => true, 'action' => 'dashboard'));
    }
    }
    public function admin_dashboard() {
    }
    public function manager_dashboard() {
    }
    
  3. Create a view for each of these actions, and put content into it to reflect which view is being rendered. Therefore, you would have to create three files:
    • app/views/users/admin_dashboard.ctp
    • app/views/users/manager_dashboard.ctp
    • app/views/users/dashboard.ctp

    For example, the contents for dashboard.ctp could simply be:

    <p>Dashboard (User)</p>
    
  4. Edit your app/controllers/app_controller.php file and change the components property declaration to include the following setting for the Auth component:
    public $components = array(
    'Auth' => array(
    'authorize' => 'controller',
    'loginRedirect' => array(
    'admin' => false,
    'controller' => 'users',
    'action' => 'dashboard'
    )
    ),
    'Session'
    );
    
  5. While still editing your AppController class, change the isAuthorized method and replace it entirely with the following:
    public function isAuthorized() {
    $role = $this->Auth->user('role');
    $neededRole = null;
    $prefix = !empty($this->params['prefix']) ?
    $this->params['prefix'] :
    null;
    if (
    !empty($prefix) &&
    in_array($prefix, Configure::read('Routing.prefixes'))
    ) {
    $neededRole = $prefix;
    }
    return (
    empty($neededRole) ||
    strcasecmp($role, 'admin') == 0 ||
    strcasecmp($role, $neededRole) == 0
    );
    }
    
  6. Copy the default CakePHP layout file named default.ctp from your cake/libs/view/layouts folder to your application's app/views/layouts folder. While editing this layout, place the following code in the app/views/layouts/default.ctp layout file, right where you want the link to the dashboard to appear.
    <?php
    $dashboardUrl = array('controller'=>'users', 'action'=>'dashboard');
    if (!empty($user['role'])) {
    $dashboardUrl[$user['role']] = true;
    }
    echo $this->Html->link('My Dashboard', $dashboardUrl);
    ?>
    

How it works...

CakePHP will recognize prefixes defined in the Routing.prefixes setting as part of the URL, when they are preceding a normal route. For example, if admin is a defined prefix, the route /admin/articles/index will translate to the admin_index action in ArticlesController.

Since we are utilizing the controller authentication scheme in the Auth configuration, we know that every time a user is trying to access a non-public action, AppController::isAuthorized() is executed, and inside the method we set true if the user has access, or false otherwise.

Knowing that, we can check to see if a prefix is being used when a controller action is about to be executed. If the current route being accessed includes a prefix, we can match that prefix against the user's role to make sure they have access to the requested resource.

We are able to link to a role-only resource just by prefixing it with the appropriate prefix in the route. For example, to link to the manager's dashboard, the URL would be:

array(
'manager' => true,
'controller' => 'users',
'action' => 'dashboard'
);

See also

  • Setting up Access Control Layer based authentication.
主站蜘蛛池模板: 泉州市| 卓资县| 饶河县| 吉林省| 龙州县| 泾川县| 顺义区| 永和县| 霍林郭勒市| 定陶县| 宁都县| 平顺县| 宿迁市| 屯留县| 拉萨市| 临桂县| 沂南县| 张家界市| 金沙县| 安西县| 平度市| 龙门县| 湘乡市| 华容县| 依安县| 凌海市| 江孜县| 武定县| 乌鲁木齐市| 闻喜县| 青铜峡市| 禹州市| 新竹县| 新竹市| 吉木萨尔县| 苏尼特右旗| 南华县| 祥云县| 安陆市| 兴国县| 枣强县|