README

The http RPC driver of laravel-distributable: signed calls between modules.

composer require mk-josias/laravel-distributable-rpc-http

Its provider is discovered. It registers the driver of the shipped http transport, and serves POST {module}/rpc/{version}/{message} for each module this process runs. Its settings are in config/rpc-http.php (php artisan vendor:publish --tag=rpc-http-config). It declares the http transport and takes it as the default when distributable.rpc.transport names none. The secret is shared by caller and called:

return [
    // signs every call; it falls back to APP_KEY
    'secret' => env('DISTRIBUTABLE_RPC_SECRET', env('APP_KEY', '')),
    // the same in every process
    'path' => env('DISTRIBUTABLE_RPC_PATH', '{module}/rpc/{version}/{message}'),
    // the group of those routes, which checks the signature
    'middleware_group' => 'rpc',
    // the port the RPC answers on, in a process of its own (`php artisan rpc:serve`);
    // null: wherever the application is served
    'port' => env('DISTRIBUTABLE_RPC_PORT'),
    // seconds a signature stays valid
    'signature_ttl' => 30,
];

Signed: an HMAC of the timestamp, a nonce, the path, the body and the propagated context
Fresh: a call older than signature_ttl is rejected
Once: each nonce is accepted once, through the cache
Answers: 200 the return value as JSON · 404 null · 400 no such message or version · 403 bad signature · 422 a payload its rules refuse

What a program written in another language has to send is in Programs in other languages.

mk-josias / laravel-distributable-rpc-http

Package info

Security

Statistics

README