siewwp/laravel-service-host

laravel server-to-server service host with HMAC authentication

Laravel service host

Installation

composer require siewwp/laravel-service-host:^1.0.0

Publish service host config ``` bash php artisan vendor:publish --provider="Siewwp\LaravelServiceHost\ServiceHostServiceProvider" --tag="config", _(*1)

Publish service host migration
``` bash
php artisan vendor:publish --provider="Siewwp\LaravelServiceHost\ServiceHostServiceProvider" --tag="migrations"

Run migration, _(*2)

php artisan migrate

run the command below on console to create host, _(*3)

php artisan service-host:client {name} {webhook_url}

Guide

Authenticating client request

Add clients user provider in your auth.php configuration file., _(*4)

'providers' => [
    'clients' => [
        'driver' => 'eloquent',
        'model' => Siewwp\LaravelServiceHost\Client::class,
    ],
],

Finally, you may use this provider in your guards configuration:, _(*5)

'guards' => [
    'client' => [
        'driver' => 'service-host',
        'provider' => 'clients',
    ],
],

Sending a webhook notification

To send notification, create a notification and specify WebhookChannel::class like below:, _(*6)

<?php

namespace App\Notifications;

use Illuminate\Notifications\Notification;
use Siewwp\LaravelServiceHost\Channels\WebhookChannel;

class InvoicePaid extends Notification
{
    public function via($notifiable)
    {
        return [WebhookChannel::class];
    }

    public function toWebhook($notifiable)
    {
        return [
            // ...
        ];
    }

    // ...
}

TODO

TEST, _(*7)