Skip to main content

Permissions

Super Admin includes a built-in RBAC (Role-Based Access Control) system with users, roles, and permissions.

Editing an administrator: roles and direct permissions

Editing a role: permissions in the dual list box

Built-in Management Pages​

Access these from the sidebar under Auth:

  • Users (/admin/auth/users) - Manage admin accounts
  • Roles (/admin/auth/roles) - Manage roles
  • Permissions (/admin/auth/permissions) - Manage permissions
  • Menu (/admin/auth/menu) - Manage sidebar menu

Route Permissions​

Permissions are bound to HTTP routes. When creating a permission:

  1. Set a slug (e.g., manage-posts)
  2. Select HTTP methods (GET, POST, PUT, DELETE, etc.)
  3. Enter path patterns (e.g., /posts*)

A path of /posts* matches /admin/posts, /admin/posts/create, etc.

Checking Permissions in Code​

Permission Check​

use SuperAdmin\Admin\Auth\Permission;

// Throws 403 if user doesn't have permission
Permission::check('manage-posts');

Role Check​

// Throws 403 if user doesn't have role
Permission::allow('administrator');

User Helper Methods​

// Get current admin user
$user = Admin::user();

// Check permission
if ($user->can('manage-posts')) {
// Has permission
}

// Check role
if ($user->isRole('editor')) {
// Has role
}

// Check multiple roles
if ($user->inRoles(['administrator', 'editor'])) {
// Has one of these roles
}

// Check if administrator
if ($user->isAdministrator()) {
// Is super admin
}

Permission Middleware​

Apply permissions to route groups:

Allow Roles​

Route::group([
'middleware' => 'admin.permission:allow,administrator,editor',
], function ($router) {
$router->resource('posts', PostController::class);
});

Deny Roles​

Route::group([
'middleware' => 'admin.permission:deny,guest',
], function ($router) {
// ...
});

Check Permission​

Route::group([
'middleware' => 'admin.permission:check,manage-posts',
], function ($router) {
$router->resource('posts', PostController::class);
});

Permission in Controller​

class PostController extends AdminController
{
public function index(Content $content)
{
Permission::check('view-posts');
// ...
}

public function create(Content $content)
{
Permission::check('create-posts');
// ...
}
}

Conditional UI Elements​

// In grid
$grid->actions(function ($actions) {
if (!Admin::user()->can('delete-posts')) {
$actions->disableDelete();
}
});

// In form
if (Admin::user()->can('manage-settings')) {
$form->text('advanced_setting');
}

When menu_bind_permission is enabled in config/admin.php, menu items are only visible to users with the associated role.

// config/admin.php
'menu_bind_permission' => true,

The menu editor: drag to reorder, form to add an item

Operation Log​

All admin actions are logged to the admin_operation_log table. Configure in config/admin.php:

'operation_log' => [
'enable' => true,
'allowed_methods' => ['GET', 'HEAD', 'POST', 'PUT', 'DELETE'],
'secret_fields' => ['password', 'password_confirmation'],
'except' => [
'admin/auth/logs*', // Exclude log viewing from logging
],
],