HTTP 基礎認證

HTTP 基礎認證 提供了一種快速方法來驗證你應用程式中的用戶，而無需設定專用的「登入」頁面。開始之前， 先把 auth.basic 中間件 附加到你的路由中。 auth.basic 中間件已包含在Laravel 框架中，所以你不需要定義它：

Route::get('profile', function () { 
   // 只有认证过的用户可以进入...
 })->middleware('auth.basic');

將中間件附加到路由後，在瀏覽器中訪問此路由時將自動提示您輸入憑證。預設的，auth.basic 中間件把使用者記錄上的 email 欄位 作為「使用者名稱」。

FastCGI 的注意事項

如果你正在使用 PHP FastCGI 模式，HTTP 基礎認證可能無法正常運作。需要把下面幾行加到你的.htaccess 檔案中：

RewriteCond %{HTTP:Authorization} ^(.+)$
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

無狀態HTTP 基礎認證

你也可以使用HTTP 基礎驗證，而無需在會話中設定使用者識別碼cookie，這對API 的身份驗證特別有用。為此 ，請定義一個中間件 它將呼叫 onceBasic 方法。如果onceBasic 方法沒有回傳任何回應，那麼請求就可以進一步傳遞到應用程式：

<?php
  namespace App\Http\Middleware;
  use Illuminate\Support\Facades\Auth;
  class AuthenticateOnceWithBasicAuth{   
       /**
     * 处理传入的请求
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */  
  public function handle($request, $next)  
    {       
       return Auth::onceBasic() ?: $next($request);  
     }
   }

接著， 註冊路由中間件並將它附加到路由：

Route::get('api/user', function () {  
  // 只有认证过的用户可以进入...
})->middleware('auth.basic.once');

退出

要手動把使用者從應用程式中退出登錄，你可以使用Auth facade 上的logout 方法。這將清除使用者會話中的身份認證資訊：

use Illuminate\Support\Facades\Auth;Auth::logout();

#讓它裝置上的Session 失效

Laravel還提供了一種機制，用於將其它設備上的用戶Session 失效和“註銷”，而不會使其當前設備上的Session 失效。首先，你需要保證Illuminate\Session\Middleware\AuthenticateSession 中間件在你的app/Http/Kernel.php 類別中的web 中間件群組中，並且沒有被註解掉：

'web' => [   
    // ...
    \Illuminate\Session\Middleware\AuthenticateSession::class,  
    // ...
  ],

然後， 你就可以使用Auth facade 上的logoutOtherDevices 方法。此方法要求使用者提供其目前密碼，你的應用程式應透過輸入表單接受該密碼：

use Illuminate\Support\Facades\Auth;
Auth::logoutOtherDevices($password);

{note} 當呼叫logoutOtherDevices 方法後，使用者的其它Session將完全失效，這意味著他們將“退出”他們之前通過身份認證的所有看守器。

新增自訂的看守器

你可以使用 Auth facade 的 extend 方法來定義自己的驗證看守器。你應該在 服務提供器 中呼叫  extend 方法。由於Laravel 已經附帶了AuthServiceProvider，我們可以將程式碼放在該提供者中：

<?php
  namespace App\Providers;
  use App\Services\Auth\JwtGuard;
  use Illuminate\Support\Facades\Auth;
  use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
  class AuthServiceProvider extends ServiceProvider{   
      /**
     * 注册任意应用认证／授权服务。
     *
     * @return void
     */   
  public function boot()  
   {      
     $this->registerPolicies();        
     Auth::extend('jwt', function ($app, $name, array $config) {         
       // 返回一个 Illuminate\Contracts\Auth\Guard 实例...           
        return new JwtGuard(Auth::createUserProvider($config['provider']));     
         });   
    }}

如你在上面的範例中所看到的，傳遞給extend 方法的回呼應該傳回一個實作Illuminate\Contracts\Auth\Guard 介面的實例。這個介麵包含了一些你需要在自訂的看守器中實現的方法。當你的自訂看守器定義完成之後，你可以在auth.php 設定檔的guards 設定中使用這個看守器：

'guards' => [  
  'api' => [     
     'driver' => 'jwt',        
     'provider' => 'users',    
     ],
  ],

#請求閉包看守器

實作基於HTTP 請求的自訂身分驗證系統最簡單的方法，是使用Auth::viaRequest 方法。此方法可讓您使用單一閉包來快速定義身份驗證流程。

首先，在 AuthServiceProvider 的 boot 方法中呼叫 Auth::viaRequest 方法。 viaRequest 方法接受一個看守器名稱作為其第一個參數。此名稱可以是描述你自訂看守器的任何字串。傳遞給該方法的第二個參數應該是一個閉包函數，它接收傳入的HTTP 請求並傳回一個使用者實例，或者，如果驗證失敗，則為null：

use App\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
  /**
 * 注册任意应用认证／授权服务。
 *
 * @return void
 */
 public function boot(){  
   $this->registerPolicies();  
    Auth::viaRequest('custom-token', function ($request) {     
       return User::where('token', $request->token)->first();  
       });
     }

當你完成了自訂看守器後，就可以在auth.php 設定檔的guards 設定中使用這個看守器：

'guards' => [   
 'api' => [      
   'driver' => 'custom-token',  
   ],
 ],

#新增自訂用戶提供器

如果不使用傳統的關聯式資料庫儲存用戶，就需要使用自己的驗證用戶提供器擴充Lavarel 。可以使用Auth facade 的provider 方法自訂使用者提供者：

<?php
    namespace App\Providers;
    use Illuminate\Support\Facades\Auth;
    use App\Extensions\RiakUserProvider;
    use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
    class AuthServiceProvider extends ServiceProvider{   
        /**
     * 注册任意应用身份验证 / 授权服务Register any application authentication / authorization services.
     *
     * @return void
     */   
      public function boot()   
       {      
         $this->registerPolicies();       
         Auth::provider('riak', function ($app, array $config) {         
            // 返回 Illuminate\Contracts\Auth\UserProvider 实例...            
            return new RiakUserProvider($app->make('riak.connection'));       
           });   
        }}

一旦使用provider 方法註冊完畢，就可以在auth.php 設定檔中切換到新的使用者提供者。先定義一個使用新驅動的provider ：

'providers' => [  
  'users' => [      
    'driver' => 'riak',  
      ],
  ],

隨後就可以在guards 設定中使用這個提供者：

'guards' => [   
    'web' => [     
       'driver' => 'session',        
       'provider' => 'users',    
     ],
  ],

使用者提供器契約

Illuminate\Contracts\Auth\UserProvider 實作僅負責從MySQL、Riak 等持久化儲存系統中提取Illuminate\Contracts\Auth\Authenticatable 實作。無論使用者如何儲存及用於表示它的類別是什麼類型，這兩個介面都允許Laravel 驗證機制繼續運作：

我們來看看Illuminate\Contracts\Auth\UserProvider 契約：

<?php
    namespace Illuminate\Contracts\Auth;
    interface UserProvider {  
      public function retrieveById($identifier);    
      public function retrieveByToken($identifier, $token);    
      public function updateRememberToken(Authenticatable $user, $token);    
      public function retrieveByCredentials(array $credentials);    
      public function validateCredentials(Authenticatable $user, array $credentials);
     }

retrieveById 函數通常接受用於表示類別的key（如MySQL 資料庫中自動遞增的ID）作為參數，並且取得並傳回與這個ID 相符的Authenticatable 實作。

retrieveByToken 函數透過使用者的唯一 $identifier 和儲存在 remember_token 列的 「記得我」 令牌取得使用者。與前一方法相同，它會傳回 Authenticatable 實作。

updateRememberToken 方法以新  $token 更新  $user 的 remember_token 欄位。在「記得我」登入校驗成功或使用者登出時指派「刷新令牌」。

在嘗試登入應用程式時，retrieveByCredentials 方法接受憑證陣列傳遞給 Auth::attempt 方法。此方法在底層持久化儲存中「查詢」與這些憑證相符的使用者。通常，此方法執行一個基於 $credentials['username'] 的 “where” 條件，它應該會傳回一個 Authenticatable 實作。 此方法不就嘗試進行任何密碼校驗或身份驗證。

validateCredentials 方法應該比較給定的 $user 與 $credentials 來驗證使用者身分。例如，此方法或許應該使用Hash::check 來比較$user->getAuthPassword() 的值與$credentials['password'] 的值。它應該傳回 true 或 false ，以表示使用者密碼是否有效。

身份驗證契約

我們已經剖析了 UserProvider 的每個方法。下面再來看看 Authenticatable 契約。切記，使用者提供器的 retrieveById、 retrieveByToken 和 retrieveByCredentials 方法將傳回此介面的實例：

<?php
   namespace Illuminate\Contracts\Auth;
   interface Authenticatable {   
      public function getAuthIdentifierName();    
      public function getAuthIdentifier();    
      public function getAuthPassword();    
      public function getRememberToken();    
      public function setRememberToken($value);    
      public function getRememberTokenName();
     }

這個介面很簡單。 getAuthIdentifierName 方法應該傳回使用者 「主鍵」 欄位的名字， getAuthIdentifier 方法則傳回使用者 「主鍵」。在 MySQL 後台，它會是自增主鍵。 getAuthPassword 方法應該傳回使用者的雜湊密碼。此介面允許驗證系統與任一 User 類別一直運作，不管使用的是哪種 ORM 或抽象儲存層。預設情況下，Laravel 的 app 目錄會包含一個實作了此介面的 User 類，你可以以這個實作範例作為參考。

事件

#在身分驗證處理過程中 Laravel 引發了多種 事件 。可以在  EventServiceProvider 中附著這些事件的監聽器:

/**
 * 应用的事件监听器映射。
 *
 * @var array
 */
 protected $listen = [   
    'Illuminate\Auth\Events\Registered' => [     
       'App\Listeners\LogRegisteredUser',  
       ],  
     'Illuminate\Auth\Events\Attempting' => [     
        'App\Listeners\LogAuthenticationAttempt', 
         ],  
      'Illuminate\Auth\Events\Authenticated' => [    
         'App\Listeners\LogAuthenticated',   
        ],  
      'Illuminate\Auth\Events\Login' => [     
         'App\Listeners\LogSuccessfulLogin',   
        ],  
      'Illuminate\Auth\Events\Failed' => [     
         'App\Listeners\LogFailedLogin',   
        ], 
      'Illuminate\Auth\Events\Logout' => [      
           'App\Listeners\LogSuccessfulLogout',  
           ],   
       'Illuminate\Auth\Events\Lockout' => [     
         'App\Listeners\LogLockout',   
         ],  
       'Illuminate\Auth\Events\PasswordReset' => [     
         'App\Listeners\LogPasswordReset',   
         ],
      ];