bantenprov/advancetrust

Laravel package untuk mengolah role / hak akses pengguna aplikasi

Advance Trust

This package inspired and extend the ., _(*1)

![Software License][ico-license] , _(*2)

DEMO

Demo for this package is available here Role, _(*3)

Version

Install

• Advancetrust for laravel : composer require bantenprov/advancetrust "1.0.1", _(*4)

• Advancetrust for laravel with vue js : composer require bantenprov/advancetrust "1.0.2", _(*5)

• Advancetrust available API request : composer require bantenprov/advancetrust "1.0.3", _(*6)

1. In your config/app.php add for laravel <= 5.4 only:

``` php 'providers' => array(, <sub>(*7)</sub>

App\Providers\EventServiceProvider::class,
App\Providers\RouteServiceProvider::class,
...
Bantenprov\Advancetrust\advancetrustServiceProvider::class,
Bantenprov\LaravelApiManager\LaravelApiManagerServiceProvider::class,
Laratrust\LaratrustServiceProvider::class,
Collective\Html\HtmlServiceProvider::class,
'That0n3guy\Transliteration\TransliterationServiceProvider',

),, <sub>(*8)</sub>

``` php
'aliases' => [

    'Validator' => Illuminate\Support\Facades\Validator::class,
    'View' => Illuminate\Support\Facades\View::class,
    ...
    'Laratrust'   => Laratrust\LaratrustFacade::class,
    'Form' => Collective\Html\FormFacade::class,
    'Html' => Collective\Html\HtmlFacade::class,

2. php artisan

``` bash $ php artisan vendor:publish --tag="laratrust" $ php artisan vendor:publish $ php artisan laratrust:setup $ php artisan laratrust:seeder $ php artisan laravel-api-manager:add-route $ php artisan migrate $ composer dump-autoload $ php artisan db:seed --class=LaratrustSeeder $ php artisan serve, <sub>(*9)</sub>

## Please run this available command after finished installation
``` bash
$ php artisan advancetrust:add-route
$ php artisan advancetrust:create-controller
$ php artisan advancetrust:create-view
$ php artisan advancetrust:version

Add authentication to use the package

``` bash $ php artisan make:auth, <sub>(*10)</sub>

## Edit `resources/views/home.blade.php`

```html
@extends('layouts.app')

@section('content')



    

        

            

                
Dashboard

                

                    @if (session('status'))
                        

                            {{ session('status') }}
                        
                    @endif
                    {{-- 
                    add menu content here
                    --}}
                    @yield('advancetrust_content')
                
            
        
    



@endsection

Server config

Tambahkan pada .env anda parameter berikut 1. Host yang digunakan sebagai role controller sebagai eksekutor penambahan role, <sub>(*11)</sub>

BANTENPROV_ROLEHOST=rolehost.domain.tld

setting ini harus digunakan pada semua site yang menggunakan advantrust., <sub>(*12)</sub>

1. Host yang digunakan sebagai requestor penambahan role

BANTENPROV_DRIVERHOST=driverhost.domain.tld

Contoh penggunaan

Request menggunakan guzzle pada client

Request menggunakan package guzzle caranya install terlebih dahulu package guzzle dengan cara : composer require guzzlehttp/guzzle, <sub>(*13)</sub>

pada client tambahkan BANTENPROV_ROLEHOST=http://localhost:8000 pada file .env Host yang digunakan sebagai role controller sebagai eksekutor penambahan role, <sub>(*14)</sub>

pada contoh di atas menggunakan http://localhost:8000 sebagai host, <sub>(*15)</sub>

``` php, <sub>(*16)</sub>

// method get, <sub>(*17)</sub>

Route::get('/guzzle/permission/get',function(){ $hostname = \Request::root(); $client = new GuzzleHttp\Client(['base_uri' => env('BANTENPROV_ROLEHOST').'/api/v1/advancetrust/']);
$response = $client->request('GET', 'permission',[ 'headers' => [ 'secret_key' => 'QwQjR4V8VKXqvWR3l7v056VU9l2d2JKkcXvM9GQKYhn8J5gsGKNdEYj6cHaoP5HOne51TwSRk4CT0ksZjCUCEEKi6V1a34bQqXEI', 'client' => $hostname ] ]);, <sub>(*18)</sub>

return $response->getBody();

});, <sub>(*19)</sub>

Route::get('/guzzle/role/get',function(){ $hostname = \Request::root(); $client = new GuzzleHttp\Client(['base_uri' => env('BANTENPROV_ROLEHOST').'/api/v1/advancetrust/']);
$response = $client->request('GET', 'role',[ 'headers' => [ 'secret_key' => 'QwQjR4V8VKXqvWR3l7v056VU9l2d2JKkcXvM9GQKYhn8J5gsGKNdEYj6cHaoP5HOne51TwSRk4CT0ksZjCUCEEKi6V1a34bQqXEI', 'client' => $hostname ] ]);, <sub>(*20)</sub>

return $response->getBody();

});, <sub>(*21)</sub>

//method post, <sub>(*22)</sub>

Route::get('/guzzle/permission/post',function(){, <sub>(*23)</sub>

$hostname = \Request::root();
$client = new GuzzleHttp\Client(['base_uri' => env('BANTENPROV_ROLEHOST').'/api/v1/advancetrust/']);    
$response = $client->request('POST', 'permission/store',[
                                    'headers' => [
                                        'secret_key' => 'QwQjR4V8VKXqvWR3l7v056VU9l2d2JKkcXvM9GQKYhn8J5gsGKNdEYj6cHaoP5HOne51TwSRk4CT0ksZjCUCEEKi6V1a34bQqXEI',
                                        'client' => $hostname
                                    ],
                                    'form_params' => [
                                        'name' => 'example name',
                                        'description' => 'example description',
                                        'display_name' => 'example display name'
                                    ]
]);    

return $response->getBody();

});, <sub>(*24)</sub>

Route::get('/guzzle/role/post',function(){, <sub>(*25)</sub>

$hostname = \Request::root();
$client = new GuzzleHttp\Client(['base_uri' => env('BANTENPROV_ROLEHOST').'/api/v1/advancetrust/']);    
$response = $client->request('POST', 'role/store',[
                                    'headers' => [
                                        'secret_key' => 'QwQjR4V8VKXqvWR3l7v056VU9l2d2JKkcXvM9GQKYhn8J5gsGKNdEYj6cHaoP5HOne51TwSRk4CT0ksZjCUCEEKi6V1a34bQqXEI',
                                        'client' => $hostname
                                    ],
                                    'form_params' => [
                                        'name' => 'example name',
                                        'description' => 'example description',
                                        'display_name' => 'example display name'
                                    ]
]);    

return $response->getBody();

});, <sub>(*26)</sub>

### secret key `secret_key`
ini dibuat menggunakan package `laravel-api-manager`, caranya akses pada browser : `http://localhost:8000/api_manager` dan tambahkan data baru. 
client : `localhost:9090`
description : `cient`

setelah berhasil di tambahkan

gunakan `api keys` untuk pada value `secret_key` pada header 
`'secret_key' => 'api_keys'`


Pada host tambahkan `BANTENPROV_DRIVERHOST=http://localhost:9090` pada file `.env` Host yang digunakan sebagai requestor penambahan role 

jadi pada contoh ini host yang diberi hak akses untuk melakukan penambahan data baru sesuai dengan `BANTENPROV_DRIVERHOST` yaitu `http://localhost:9090` dan selain dari `http://localhost:9090` hanya mempunyai hak akses untuk meminta data dari `http://localhost:8000` 

command run server pada client :
```bash
$ php artisan serve --port=9090

command run server pada host :, <sub>(*27)</sub>

$ php artisan serve

jika masih binggung untuk cara penggunaan guzzle silahkan baca-baca dokumentasinya disini, <sub>(*28)</sub>

The MIT License (MIT). Please see License File for more information., <sub>(*29)</sub>