Laravel Passport是Laravel框架下的一款完整的OAuth2服務端實現(xiàn)， 允許你透過API對使用者身分進行認證和授權，使得API服務可以在無需暴露使用者憑證的情況下進行訪問，這大大降低了客戶端開發(fā)的難度，提高了應用程式的安全性。

Laravel Passport背後的OAuth2協(xié)議是業(yè)界標準，所以你可以使用相同的工具和流程，輕鬆地在其他語言和框架中整合OAuth2認證和授權。下面，本文將詳細介紹Laravel Passport的流程、配置和使用。

安裝Passport

在使用Laravel Passport之前，需要先安裝它。我們可以使用composer指令來安裝Passport，指令如下：

composer?require?laravel/passport

啟用Passport

Laravel Passport安裝完畢後，需要將其服務提供者新增至config/app.php檔案中的providers在數(shù)組中，打開該文件，找到providers數(shù)組並添加Laravel Passport的服務提供程序，如下所示：

'providers'?=>?[
????//?Other?Service?Providers...
????Laravel\Passport\PassportServiceProvider::class,
],

創(chuàng)建資料庫表

在使用Laravel Passport之前，還需要新建Passport所需的資料庫表，可以使用以下artisan指令來產(chǎn)生遷移檔案：

php?artisan?migrate

執(zhí)行以上指令後，Laravel Passport將在你的資料庫中建立幾個新的表來儲存OAuth2客戶端、Access Token和Refresh Token等數(shù)據(jù)。

發(fā)布設定檔

執(zhí)行下列artisan指令，將Passport的設定檔發(fā)佈到Laravel專案的config目錄下：

php?artisan?vendor:publish?--tag=passport-config

建立金鑰

到此，我們已經(jīng)做好了使用Laravel Passport所需的前置條件。接下來，我們需要使用以下artisan指令來產(chǎn)生加密金鑰：

php?artisan?passport:keys

以上指令將產(chǎn)生encryption keys，用於簽署cookie和access token等資料。

設定Passport

完成上述步驟後，我們接下來需要設定Passport，以便使其運作。在config/auth.php設定檔中，將api驅(qū)動程式的driver變更為passport，並設定guards和providers，如下所示：

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

在同一個檔案中設定providers，如下所示：

'providers'?=>?[
????'users'?=>?[
????????'driver'?=>?'eloquent',
????????'model'?=>?App\Models\User::class,
????],
],

一旦設定檔完成， API認證就已經(jīng)就緒。

建立Route

接下來，我們需要在app/Http路由檔案中建立API路由，如下所示：

Route::middleware('auth:api')->get('/user',?function?(Request?$request)?{
????return?$request->user();
});

在上述路由範例中，定義了auth :api中間件，用於驗證請求是否來自已認證用戶，若非已認證用戶，則在驗證失敗時傳回401狀態(tài)碼。

建立Client

現(xiàn)在，我們已經(jīng)完成了應用程式配置和API路由的設置，接下來需要建立API客戶端。在Laravel Passport中，提供了artisan指令passport:client，用於建立新的OAuth2客戶端。執(zhí)行如下所示的指令：

php?artisan?passport:client?--client

在執(zhí)行指令後，我們需要輸入客戶端名稱和授權重定向URI，如下所示：

php?artisan?passport:client?--client
Which?user?ID?should?the?client?be?assigned?to??[0]:
?>?1
What?should?we?name?the?client?
?>?Test
Where?should?we?redirect?the?request?after?authorization?
?>?http://example.com/callback

以上指令將建立一個新的OAuth2客戶端，用於向此應用程式的API發(fā)送請求。我們將得到一個客戶端ID和客戶端金鑰，用於後面的API請求中。

取得授權

客戶端已經(jīng)建立完成，並獲得了授權重定向URI，現(xiàn)在我們需要向該URI發(fā)送一個請求，以取得授權。之後，Passport將會為客戶端產(chǎn)生存取令牌，並傳回給該用戶端。使用如下所示的URL，取代其中的Client ID和重定向URI：

http://your-app.com/oauth/authorize?client_id={client-id}&redirect_uri={redirect-uri}?&response_type=code&scope=

在輸入URL後，如下所示的OAuth2授權畫面將會顯示：

在點擊'Authorize'按鈕後，將會發(fā)生授權並重定向到重定向URI。

取得存取權杖

現(xiàn)在，我們已經(jīng)獲得了授權，並且客戶端已經(jīng)被授予存取API的權限。我們需要使用OAuth2授權碼，與客戶端金鑰換取存取令牌，我們可以使用如下所示的curl指令，從API授權伺服器取得存取權令牌：

$?curl?-X?POST?-H?"Accept:?application/json"?-F?"client_id={client-id}"?-F?"client_secret={client-secret}"?-F?"grant_type=authorization_code"?-F?"code={code}"?-F?"redirect_uri={redirect-uri}"?http://your-app.com/oauth/token

執(zhí)行以上指令後，將會得到如下所示的JSON對象，其中包含access_token和refresh_token等資訊：

{
????"token_type":?"Bearer",
????"expires_in":?86400,
????"access_token":?"{access-token}",
????"refresh_token":?"{refresh-token}",
}

使用存取權令牌進行API請求

現(xiàn)在，我們已經(jīng)獲得了存取權令牌，我們可以使用存取令牌與API進行請求。我們需要在API請求頭部中增加Authorization頭，並設定Bearer鑑權方案，將存取權杖作為令牌內(nèi)容即可，如下所示：

$client?=?new?\GuzzleHttp\Client();
$response?=?$client->request('GET',?'http://your-app.com/api/user',?[
????'headers'?=>?[
????????'Authorization'?=>?'Bearer?'.$accessToken,
????????'Accept'?=>?'application/json',
????],
]);

在以上程式碼中，我們將存取命令牌以Bearer TOKEN 的格式提交到API服務端進行驗證，成功後將會得到API的回應結(jié)果。

總結(jié)

在本文中，我們講述了Laravel Passport的流程、配置和使用。使用Laravel Passport，我們可以快速地為API應用程式添加安全的認證和授權，同時支援OAuth2協(xié)議，與其他程式語言和框架實現(xiàn)OAuth2授權的應用程式進行互通，這使得開發(fā)者能夠快速地建立安全性高、易於使用的API應用程式。

以上是詳細介紹Laravel Passport的流程、配置與使用的詳細內(nèi)容。更多資訊請關注PHP中文網(wǎng)其他相關文章！