請求令牌

建立密碼授權的用戶端後，就可以使用使用者的電子郵件地址和密碼向/oauth/token 路由發出POST請求來獲取存取令牌。而該路由已經由 Passport::routes 方法註冊，因此不需要手動定義它。如果請求成功，會在服務端傳回的JSON 回應中收到一個access_token 和refresh_token：

$http = new GuzzleHttp\Client;
$response = $http->post('http://your-app.com/oauth/token', [
    'form_params' => [   
         'grant_type' => 'password',        
         'client_id' => 'client-id',        
         'client_secret' => 'client-secret',        
         'username' => 'taylor@laravel.com',        
         'password' => 'my-password',        
         'scope' => '',    
         ],]);
   return json_decode((string) $response->getBody(), true);

{tip} 預設情況下，訪問令牌是長期有效的。你可以根據需要 配置存取權杖的有效時間 。

請求所有作用域

使用密碼授權機制時，可以透過請求scope 參數* 來授權應用程式支援的所有範圍的令牌。如果你的請求中包含 scope 為 * 的參數，令牌實例上的 can 方法會始終傳回 true。這種作用域的授權只能指派給使用password 授權時發出的令牌：

$response = $http->post('http://your-app.com/oauth/token', [
    'form_params' => [   
         'grant_type' => 'password',        
         'client_id' => 'client-id',        
         'client_secret' => 'client-secret',        
         'username' => 'taylor@laravel.com',        
         'password' => 'my-password',        
         'scope' => '*',
        ],
      ]);

email 作為「使用者名稱」。但是，你可以透過在模型上定義一個findForPassport 方法來自訂使用者名字段:

<?php
    namespace App;
    use Laravel\Passport\HasApiTokens;
    use Illuminate\Notifications\Notifiable;
    use Illuminate\Foundation\Auth\User as Authenticatable;
    class User extends Authenticatable{  
      use HasApiTokens, Notifiable;    
      /**
     * 通过用户名找到对应的用户信息
     *
     * @param  string  $username
     * @return \App\User
     */   
      public function findForPassport($username) 
         {    
             return $this->where('username', $username)->first(); 
         }
      }

隱含授權類似於授權碼授權，但是它只將令牌傳回給客戶端而不交換授權碼。這種授權最常用於無法安全儲存客戶端憑證的 JavaScript 或行動應用程式。透過呼叫AuthServiceProvider 中的enableImplicitGrant

/**
 * 注册认证 / 授权服务
 *
 * @return void
 */
 public function boot(){
     $this->registerPolicies();    
     Passport::routes();    
     Passport::enableImplicitGrant();
    }

Route::get('/redirect', function () {
    $query = http_build_query([   
         'client_id' => 'client-id',        
         'redirect_uri' => 'http://example.com/callback',        
         'response_type' => 'token',        
         'scope' => '',    
         ]);    
    return redirect('http://your-app.com/oauth/authorize?'.$query);
  });

{tip} 注意， /oauth/authorize 路由已經在Passport::routes

方法中定義好，所以無需再次手動定義此路由。

客戶端憑證授權令牌

客戶端憑證授權適用於機器到機器的認證。例如，你可以在透過 API 執行維護任務中使用此授權。

在客戶端憑證授權之前，需要先建立一個客戶端憑證授權的客戶端，你可以使用passport:client 指令的--client 參數來建立:

php artisan passport:client --client

接下來，要使用這個授權，你首先需要在app/Http/Kernel.php 的$routeMiddleware 變數中新增新的中間件：

use Laravel\Passport\Http\Middleware\CheckClientCredentials;
protected $routeMiddleware = [
    'client' => CheckClientCredentials::class,
  ];

然後，在路由上追加這個中間件：

Route::get('/orders', function (Request $request) {
    ...
 })->middleware('client');

若要將對路由的存取限制在某個作用域內，可在將client中間件附加到路由時提供以逗號分隔的所需作用域清單:

Route::get('/orders', function (Request $request) {
    ...
})->middleware('client:check-status,your-scope');

#取得令牌

透過向oauth/token介面發出請求來取得令牌:

$guzzle = new GuzzleHttp\Client;
$response = $guzzle->post('http://your-app.com/oauth/token', [ 
   'form_params' => [ 
          'grant_type' => 'client_credentials',        
          'client_id' => 'client-id',        
          'client_secret' => 'client-secret',        
          'scope' => 'your-scope',    
         ],]);
   return json_decode((string) $response->getBody(), true)['access_token'];

#個人存取權令牌

有時候，使用者要在不經過傳統的授權碼重定向流程的情況下向自己發出存取權杖。允許使用者透過應用程式使用者介面對自己發出令牌，有助於使用者體驗你的 API，或者也可以將其作為一種更簡單的發布存取令牌的方式。

{note} 個人存取權杖是永久有效的，就算使用了 tokensExpireIn 和 refreshTokensExpireIn 方法也不會修改它的生命週期。

建立個人存取用戶端

在你的應用程式發布個人存取權杖之前，你需要在passport:client 指令後面帶上--personal 參數來建立對應的客戶端。如果你已經執行了passport:install 命令，則無需再執行此命令：

php artisan passport:client --personal

如果你已經建立了個人存取用戶端，你可以透過呼叫AuthServiceProvider 中的personalAccessClientId 方法來啟用：

/**
 * 注册认证 / 授权服务
 *
 * @return void
 */
 public function boot(){ 
    $this->registerPolicies();    
    Passport::routes();    
    Passport::personalAccessClientId('client-id');
  }

管理個人存取權杖

#建立個人存取客戶端後，你可以使用User 模型實例上的createToken 方法來為給定使用者發布令牌。 createToken 方法接受令牌的名稱作為其第一個參數和可選的 作用域 陣列作為其第二個參數：

$user = App\User::find(1);
// 创建没有作用域的访问令牌...
$token = $user->createToken('Token Name')->accessToken;
// 创建有作用域的访问令牌...
$token = $user->createToken('My Token', ['place-orders'])->accessToken;

JSON API

Passport 中也有用來管理個人存取權杖的 JSON API，你可以將其與自己的前端配對，為使用者提供管理個人存取權杖的儀表板。下面我們將介紹用於管理個人存取權杖的所有 API 介面。方便起見，我們使用  Axios 來示範對 API 的介面發出 HTTP 請求。

JSON API 由 web 和 auth 中間件保護；因此，只能從您自己的應用程式中呼叫它。無法從外部來源呼叫它。

{tip} 如果你不想實現自己的個人存取權杖管理的前端介面，可以根據  前端快速上手 在幾分鐘內組成功能齊全的前端介面。

GET /oauth/scopes

#此路由會傳回應用程式中定義的所有作用域 。你可以使用此路由列出使用者可能指派給個人存取權杖的範圍：

axios.get('/oauth/scopes')
    .then(response => {
        console.log(response.data);    
      });

#GET /oauth/personal-access-tokens

##此路由傳回認證使用者建立的所有個人存取權令牌。這主要用於列出所有使用者的令牌，以便他們可以編輯或刪除它們：

axios.get('/oauth/personal-access-tokens')
    .then(response => {
        console.log(response.data);   
      });

#POST /oauth/personal-access-tokens

#此路由用於建立新的個人存取令牌。它需要兩個資料：令牌的name 和scpoe：

const data = {
    name: 'Token Name',
    scopes: []};
    axios.post('/oauth/personal-access-tokens', data)
        .then(response => {
            console.log(response.data.accessToken);    
        })    
        .catch (response => { 
               // 列出响应中错误...    
        });

DELETE /oauth/personal-access-tokens /{token-id}

此路由可用來刪除個人存取權杖：

axios.delete('/oauth/personal-access-tokens/' + tokenId);

api 的看守器使用passport 驅動程式後，只需要在需要有效存取權杖的任何路由上指定auth:api 中間件：

Route::get('/user', function () {
    //
 })->middleware('auth:api');

Bearer 令牌放在請求頭Authorization 中。例如，使用 Guzzle HTTP 函式庫時：

$response = $client->request('GET', '/api/user', [
    'headers' => [  
          'Accept' => 'application/json',        
          'Authorization' => 'Bearer '.$accessToken,    
         ],
      ]);

use Laravel\Passport\Passport;
Passport::tokensCan([
    'place-orders' => 'Place orders',    
    'check-status' => 'Check order status',
  ]);

use Laravel\Passport\Passport;Passport::setDefaultScope([
    'check-status',    
    'place-orders',
  ]);

Route::get('/redirect', function () {
    $query = http_build_query([  
          'client_id' => 'client-id',        
          'redirect_uri' => 'http://example.com/callback',        
          'response_type' => 'code',        
          'scope' => 'place-orders check-status',   
        ]);    
 return redirect('http://your-app.com/oauth/authorize?'.$query);});

$token = $user->createToken('My Token', ['place-orders'])->accessToken;

'scopes' => \Laravel\Passport\Http\Middleware\CheckScopes::class,
'scope' => \Laravel\Passport\Http\Middleware\CheckForAnyScope::class,

Route::get('/orders', function () { 
   // Access token has both "check-status" and "place-orders" scopes...
   })->middleware('scopes:check-status,place-orders');

Route::get('/orders', function () {
    // 访问令牌具有 "check-status" 或 "place-orders" 作用域...
  })->middleware('scope:check-status,place-orders');

use Illuminate\Http\Request;
Route::get('/orders', function (Request $request) {
    if ($request->user()->tokenCan('place-orders')) { 
           //    
         }
     });

Laravel\Passport\Passport::scopeIds();

Laravel\Passport\Passport::scopes();

Laravel\Passport\Passport::scopesFor(['place-orders', 'check-status']);

Laravel\Passport\Passport::hasScope('place-orders');

'web' => [ 
   // 其他中间件...
    \Laravel\Passport\Http\Middleware\CreateFreshApiToken::class,
   ],

axios.get('/api/user')
    .then(response => {
        console.log(response.data);    
     });

/**
 * 注册认证 / 授权服务
 *
 * @return void
 */
 public function boot(){
     $this->registerPolicies();    
     Passport::routes();    
     Passport::cookie('custom_name');
   }

// In your application layout...
<meta name="csrf-token" content="{{ csrf_token() }}">
// Laravel's JavaScript scaffolding...
window.axios.defaults.headers.common = {
    'X-Requested-With': 'XMLHttpRequest',
   };

/**
 * 应用程序事件监听映射
 *
 * @var array
 */
 protected $listen = [
     'Laravel\Passport\Events\AccessTokenCreated' => [
             'App\Listeners\RevokeOldTokens', 
               ],    
      'Laravel\Passport\Events\RefreshTokenCreated' => [ 
             'App\Listeners\PruneOldTokens',   
             ],
         ];

use App\User;
use Laravel\Passport\Passport;
public function testServerCreation(){
    Passport::actingAs(  
          factory(User::class)->create(),   
               ['create-servers']  
             );    
         $response = $this->post('/api/create-server');    
        $response->assertStatus(201);
     }