Is an Impersonation package for the Laravel Framework. With this package you can easily impersonate other users either manually or using the interface we provide.
You don't have to worry about authorizing who can impersonate or who can be impersonated, coz we provided it by default, just need to adjust it a little according to your rules.
| Impersonate | Laravel | Impersonate | Laravel |
|---|---|---|---|
| v4.x | 10.x - 11.x | v2.x | 7.x - 8.x |
| v3.x | 9.x - 10.x | v1.x | 7.x - 8.x |
Warning
This version is a breaking change, many changes were made to the addition of new features, new UI design, and code structure.
If you are upgrade from an old version, please delete the old assets and republish the assets, configure and reset the limitations on the User Model according to this version.
To install the package, simply follow the steps below.
composer require octopyid/laravel-impersonate:^4artisan vendor:publish --tag="impersonate"Note
Sometimes some users experience the problem of layout after upgrading the package, this can be solved by deleting the
public/vendor/octopyid/impersonatefolder then republish the assets.
Add the trait Octopy\Impersonate\Concerns\HasImpersonation to your User model.
namespace App\Models;
use Octopy\Impersonate\Concerns\HasImpersonation;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
use HasImpersonation;
/**
* @return string
*/
public function getImpersonateDisplayText() : string
{
return $this->name;
}
/**
* This following is useful for performing user searches through the interface,
* You can use fields in relations freely using dot notation,
*
* example: posts.title, department.name.
*/
public function getImpersonateSearchField() : array
{
return [
'name', 'posts.title',
];
}
}There are two events available that can be used to improve your workflow:
Octopy\Impersonate\Events\BeginImpersonationis fired when an impersonation is begin.Octopy\Impersonate\Events\LeaveImpersonationis fired when an impersonation is leave.
This configuration is intended to customize the appearance of Laravel Impersonate, if you don't need a UI, don't forget to set IMPERSONATE_ENABLED to false in your environment
file because it is enabled by default.
Please refer to the impersonate.php file to see the available configurations.
By default, you don't need to do anything, but keep in mind, Impersonation can be done by anyone if you don't define the rules of who can do impersonation or who can be impersonated.
To limit who can do impersonation or who is can be impersonated, add
setImpersonateAuthorization(Authorization $authorization) on the Model to enforce the limitation.
The impersonator method is intended for who can perform the impersonation and the impersonated method is intended for anyone who is allowed to be imitated.
Warning
Not defining the Authorization rules in the Model or misdefining them can lead to serious security issues.
The example below uses Laratrust for role management where SUPER_ADMIN can perform impersonation against CUSTOMER. Feel free to use any other Role Management you like.
use Octopy\Impersonate\Concerns\HasImpersonation;
use Octopy\Impersonate\Authorization;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
use HasImpersonation;
/**
* @param Authorization $authorization
* @return void
*/
public function setImpersonateAuthorization(Authorization $authorization) : void
{
$authorization->impersonator(function (User $user) {
return $user->hasRole('SUPER_ADMIN');
});
$authorization->impersonated(function (User $user) {
return $user->hasRole('CUSTOMER');
});
}
}Sometimes you need Impersonating manually, to perform it, you can use the impersonate singleton.
impersonate()->begin($admin, $customer);Or just simply call the impersonation method directly through the User Model.
$admin->impersonate($customer);Sometimes, you want to use custom guards for authentication, instead of the built-in guards.
impersonate()->guard('foo')->begin($admin, $customer);To leave Impersonation mode, you just need to call the leave method on impersonate singleton. This will return you to the original user.
impersonate()->leave();Or via Model directly
$admin->impersonate()->leave();Don't hesitate to use a guard if you need it.
This package can pose a serious security issue if used incorrectly, as anybody will be able to take control of any user's account.
By using this package, you agree that Octopy ID and the contributors of this package cannot be held responsible for any damages caused by using this package.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.
