README.md

Remote Control for Laravel

Grant remote access to user account without sharing credentials.

• Installation
  • Configuration
• Usages
  • Routing
  • Creating Remote Access
  • Using Generated Access Token

Installation

Remote Control can be installed via composer:

composer require "katsana/remote-control"

Configuration

The package will automatically register a service provider.

Next, you need to publish the Remote Control configuration file:

php artisan vendor:publish --provider="RemoteControl\RemoteServiceProvider" --tag="config"

Usages

Routing

Before creating any remote access, we need to declare verification route:

RemoteControl\Remote::verifyRoute('remote-control')->middleware('web');

To use signed URL you should include signed middleware:

RemoteControl\Remote::verifyRoute('remote-control')->middleware(['signed', 'web']);

Creating Remote Access

You can create a remote access by running the following code:

$user = request()->user();

$recipientEmail = 'email@example.org';
$content = 'Please help me';

$accessToken = RemoteControl\Remote::create($user, $recipientEmail, $content);

Using Generated Access Token

You can get the URL using the following method:

$accessToken->getUrl();

You can also get signed URL using the following method:

$accessToken->getSignedUrl();

You can automatically send an email to the recipient via the following Mailable:

Mail::send(new RemoteControl\Mail\GrantRemoteAccess($user, $accessToken, $content));