Hướng dẫn user token php

ahihi đồ ngốc trương thanh hùng nè

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

tôi thích vậy đó

hùng đẹp trai

Hướng dẫn user token php

hùng ebudezain

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

tôi thích vậy đó

Và JWT token cũng thế, ở khuôn khổ bài này mình không nói về jwt là gì. Mình chỉ hướng dẫn cho các bạn cách nhúng jwt vào laravel cho api.

hùng thông minh lắm

hùng đẹp trai

hùng thông minh lắm

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

Cài đặt

đọc dữ liệu hộ bố

đọc dữ liệu hộ bố

tôi thích vậy đó

hùng thông minh lắm

1. cài package

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng ebudezain

đọc dữ liệu hộ bố

hùng đẹp trai

tôi thích vậy đó

tôi thích vậy đó

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

Chạy lệnh thông qua composer : 

hùng thông minh lắm

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng đẹp trai

composer require tymon/jwt-auth

hùng đẹp trai

ahihi đồ ngốc trương thanh hùng nè

hùng ebudezain

hùng đẹp trai

2. config provider và alias

đọc dữ liệu hộ bố

tôi thích vậy đó

đọc dữ liệu hộ bố

hùng ebudezain

đọc dữ liệu hộ bố

hùng đẹp trai

hùng thông minh lắm

hùng ebudezain

ahihi đồ ngốc trương thanh hùng nè

hùng ebudezain

Sau khi install package hoàn tất, bạn cần thêm service provider vào mảng provider trong file config app.php :

hùng đẹp trai

ahihi đồ ngốc trương thanh hùng nè

Tymon\JWTAuth\Providers\JWTAuthServiceProvider::class,

hùng đẹp trai

tôi thích vậy đó

ahihi đồ ngốc trương thanh hùng nè

'JWTAuth' => Tymon\JWTAuth\Facades\JWTAuth::class,
'JWTFactory' => 'Tymon\JWTAuth\Facades\JWTFactory'::class,

tôi thích vậy đó

3. tạo file config để jwt hoạt động

tôi thích vậy đó

Sau cùng bạn cần publish config của jwt ( kiểu như nó tạo cái file config vào hệ thống laravel )

đọc dữ liệu hộ bố

tôi thích vậy đó

đọc dữ liệu hộ bố

đọc dữ liệu hộ bố

php artisan vendor:publish --provider="Tymon\JWTAuth\Providers\JWTAuthServiceProvider"

hùng thông minh lắm

đọc dữ liệu hộ bố

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng đẹp trai

hùng thông minh lắm

4. Tạo secret key

hùng thông minh lắm

đọc dữ liệu hộ bố

đọc dữ liệu hộ bố

hùng ebudezain

hùng thông minh lắm

hùng thông minh lắm

Theo lý thuyết jwt dĩ nhiên muốn tạo ra 1 token bạn cần cung cấp 1 secret key 
tạo secret key trong laravel khá dễ : 

hùng đẹp trai

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

ahihi đồ ngốc trương thanh hùng nè

Nếu bạn sử dụng jwt để thực hiện xác thực cho việc trao đổi thông tin giữa 2 server 
thì 2 key của 2 server phải giống nhau thì mới có thể giải mã được ... 

Vì vậy, bạn có thể tạo 1 key bất kỳ bên server này và copy cho server kia. 

đọc dữ liệu hộ bố

hùng ebudezain

tôi thích vậy đó

hùng ebudezain

hùng đẹp trai

hùng ebudezain

bài hướng dẫn giải mã jwt của php laravel trong nodejs 

ahihi đồ ngốc trương thanh hùng nè

5. sửa lại model user để tiêm cái id user vào claim

hùng đẹp trai

hùng ebudezain

ahihi đồ ngốc trương thanh hùng nè

đọc dữ liệu hộ bố

hùng ebudezain

hùng ebudezain

đọc dữ liệu hộ bố

hùng đẹp trai

tôi thích vậy đó

ahihi đồ ngốc trương thanh hùng nè

bạn cần implements cái interface tên JWTSubject và thực thi 2 phương thức getJWTIdentifier, getJWTCustomClaims mục tiêu là để khi tạo token thì jwt của bạn được gắn chặt với 1 vái value là id của user. Sau đó khi giải mã thì ta được 1 object user tương ứng

đọc dữ liệu hộ bố

đọc dữ liệu hộ bố

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

namespace App\Models;

/// ... 
use Tymon\JWTAuth\Contracts\JWTSubject;

class User extends Authenticatable implements JWTSubject
{
    use HasFactory, Notifiable;

     /**
     * @return int
     */
    public function getJWTIdentifier() {
        
        return $this->getKey();
    }
    
    /**
     * @return array
     */
    public function getJWTCustomClaims() {
        return [
            "iss" => "http://localhost",
            "ahihi" => "đồ ngốc CustomClaims"
        ];
    }
    //// ..... 
}

đọc dữ liệu hộ bố

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

đọc dữ liệu hộ bố

Hướng dẫn user token php

đọc dữ liệu hộ bố

tôi thích vậy đó

6. lưu ý thông tin file config

ahihi đồ ngốc trương thanh hùng nè

tôi thích vậy đó

Secret Key - secret

tôi thích vậy đó

đọc dữ liệu hộ bố

tôi thích vậy đó

hùng ebudezain

hùng đẹp trai

hùng ebudezain

hùng ebudezain

Cái tên nói lên tất cả 😄 Mục 4 mình vừa trình bày là cái key này, khi bạn muốn 2 server giải mã qua lại thì 2 server phải có key giống nhau.
Mặc định load trong env cái biến JWT_SECRET không thì nó lấy đại 

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng thông minh lắm

hùng ebudezain

hùng đẹp trai

'secret' => env('JWT_SECRET', 'hung-dep-trai'),

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

JWT time to live - ttl

đọc dữ liệu hộ bố

hùng ebudezain

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng ebudezain

hùng ebudezain

hùng thông minh lắm

hùng thông minh lắm

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

1 token tạo ra phải có thười gian sống (tính bằng phút). Khuyến nghị ngắn thôi. 

tôi thích vậy đó

đọc dữ liệu hộ bố

hùng đẹp trai

đọc dữ liệu hộ bố

tôi thích vậy đó

Refresh time to live - refresh_ttl

tôi thích vậy đó

hùng ebudezain

hùng đẹp trai

Đây là thời gian (tính bằng phút) bạn có thể tạo mới một token khác từ token cũ mà ko cần xác thực lại... 

tôi thích vậy đó

'refresh_ttl' => 20160, //2 week

ahihi đồ ngốc trương thanh hùng nè

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

Tạo một token đơn giản

ahihi đồ ngốc trương thanh hùng nè

Tạo một token dự trên user

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng ebudezain

hùng đẹp trai

hùng thông minh lắm

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

ahihi đồ ngốc trương thanh hùng nè

ahihi đồ ngốc trương thanh hùng nè

hùng thông minh lắm

hùng ebudezain

class LoginCotnroller trong thư mục api như sau: 

hùng đẹp trai

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng ebudezain

hùng thông minh lắm

only('email', 'password');

        try {
            // xác nhận thông tin người dùng gửi lên có hợp lệ hay không
            if (! $token = JWTAuth::attempt($credentials)) {
                return response()
                    ->error(
                        'có lỗi validate trong controller', 
                        ['error' => 'invalid_credentials'],
                        Response::HTTP_UNAUTHORIZED
                    )
                    ->setStatusCode(Response::HTTP_UNAUTHORIZED);
            }
        } catch (JWTException $e) {
            // Xử lý ngoại lệ 
            return response()
                    ->error(
                        'có lỗi validate trong controller', 
                        ['error' => 'could_not_create_token'],
                        Response::HTTP_INTERNAL_SERVER_ERROR
                    )
                    ->setStatusCode(Response::HTTP_INTERNAL_SERVER_ERROR);
        }

        return response()
                    ->success('Your custom login', $token)
                    ->setStatusCode(Response::HTTP_OK);
    }

    /**
     * Nếu bạn sử dụng function login ở trên nhìn thấy phức tạp hay thấy gớm, khó hiểu quá thì dùng function dưới này nhìn dễ hiểu hơn 1 tí :D
     */
    public function simpleLogin(Request $request){
        // lấy thông tin từ các request gửi lên
        $credentials = $request->only('email', 'password');

        try {
            // xác nhận thông tin người dùng gửi lên có hợp lệ hay không
            if (! $token = JWTAuth::attempt($credentials)) {
                return response()->json(['error' => 'invalid_credentials'], 401);
            }
        } catch (JWTException $e) {
            // Xử lý ngoại lệ 
            return response()->json(['error' => 'could_not_create_token'], 500);
        }

        // xác nhận thành công thì trả về 1 token hợp lệ
        return response()->json(compact('token'));
    }
}

 

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng ebudezain

Tạo token dự trên một đối tượng .

hùng thông minh lắm

hùng đẹp trai

tôi thích vậy đó

hùng thông minh lắm

hùng đẹp trai

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

Ngoài phương pháp thông thường, 
chúng ta còn có thể tạo một mã Token dựa trên một user instance như sau :

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng thông minh lắm

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

$user = User::where('email', '')->first();
if(!$user){
    return response()->json(['error' => 'user_not_found'], 500);
}

$token = JWTAuth::fromUser($user);

tôi thích vậy đó

đọc dữ liệu hộ bố

hùng đẹp trai

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

claims - ghi thêm dữ liệu vào token

hùng đẹp trai

hùng thông minh lắm

$customClaims = ['foo' => 'bar', 'baz' => 'bob'];

// JWTAuth::attempt($credentials, $customClaims); -> phương thức để login
// or
JWTAuth::fromUser($user, $customClaims);

tôi thích vậy đó

hùng đẹp trai

ahihi đồ ngốc trương thanh hùng nè

hùng đẹp trai

tôi thích vậy đó

hùng ebudezain

Và đương nhiên, những dữ liệu bạn ghi thêm vào sẽ có mặt cùng với những dữ liệu khác khi giải mã token.

tôi thích vậy đó

ahihi đồ ngốc trương thanh hùng nè

đọc dữ liệu hộ bố

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng ebudezain

tôi thích vậy đó

tôi thích vậy đó

Lưu ý: Hết sức chú ý những dữ liệu bạn ghi thêm vào token vì chúng sẽ làm tăng độ dài cũng như dung lượng của token

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

Tạo token từ 1 object bất kì

hùng ebudezain

hùng thông minh lắm

hùng đẹp trai

ahihi đồ ngốc trương thanh hùng nè

$customClaims = ['foo' => 'bar', 'baz' => 'bob'];

$payload = JWTFactory::make($customClaims);

$token = JWTAuth::encode($payload);

đọc dữ liệu hộ bố

ahihi đồ ngốc trương thanh hùng nè

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

Xác thực

hùng thông minh lắm

ahihi đồ ngốc trương thanh hùng nè

hùng ebudezain

tôi thích vậy đó

đọc dữ liệu hộ bố

hùng thông minh lắm

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng thông minh lắm

Có token rồi thì khi người dùng gọi api phải gửi lên kèm header hoặc query params 
Với token này thì server có thể check token đó đúng không ? nếu đúng thì lấy được thông tin đăng nhập .

đọc dữ liệu hộ bố

ahihi đồ ngốc trương thanh hùng nè

hùng thông minh lắm

tôi thích vậy đó

Đoạn mã đó có dạng như sau :

hùng thông minh lắm

đọc dữ liệu hộ bố

hùng đẹp trai

hùng thông minh lắm

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

đọc dữ liệu hộ bố

ahihi đồ ngốc trương thanh hùng nè

đọc dữ liệu hộ bố

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

Authorization: Bearer {your_token_here}

ahihi đồ ngốc trương thanh hùng nè

hùng thông minh lắm

hùng ebudezain

hùng ebudezain

ví dụ cụ thể: 

hùng đẹp trai

hùng ebudezain

tôi thích vậy đó

hùng thông minh lắm


Hoặc nếu bạn không muốn sử dụng header thì có thể sử dụng query string . Ví dụ

hùng ebudezain

hùng thông minh lắm

đọc dữ liệu hộ bố

http://domain.xyz/users?token={your_token_here}

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

ahihi đồ ngốc trương thanh hùng nè

JWTAuth::parseToken();
$user = JWTAuth::parseToken()->authenticate();

hùng đẹp trai

hùng đẹp trai

hùng ebudezain

hùng ebudezain

ahihi đồ ngốc trương thanh hùng nè

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

hùng thông minh lắm

hùng thông minh lắm

đọc dữ liệu hộ bố

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

Để lấy giá trị token thì có thể làm như sau :

tôi thích vậy đó

tôi thích vậy đó

$token = JWTAuth::getToken();

ahihi đồ ngốc trương thanh hùng nè

đọc dữ liệu hộ bố

hùng ebudezain

hùng ebudezain

public function getAuthenticatedUser()
{
    try {

        if (! $user = JWTAuth::parseToken()->authenticate()) {
            return response()->json(['user_not_found'], 404);
        }

    } catch (Tymon\JWTAuth\Exceptions\TokenExpiredException $e) {

        return response()->json(['token_expired'], $e->getStatusCode());

    } catch (Tymon\JWTAuth\Exceptions\TokenInvalidException $e) {

        return response()->json(['token_invalid'], $e->getStatusCode());

    } catch (Tymon\JWTAuth\Exceptions\JWTException $e) {

        return response()->json(['token_absent'], $e->getStatusCode());

    }

    return response()->json(compact('user'));
}

hùng ebudezain

exception global

hùng thông minh lắm

tôi thích vậy đó

ahihi đồ ngốc trương thanh hùng nè

tôi thích vậy đó

ahihi đồ ngốc trương thanh hùng nè

hùng ebudezain

hùng ebudezain

hùng đẹp trai

hùng đẹp trai

Mình sẽ viết 1 bài nói về cách dùng exception trong laravel trông có vẻ xịn hơn khi viết api hay xử lý các vấn đề về error để code clean hơn. Riêng phần này mình nói ngắn gọn để bắt lỗi exception global là bạn vào file app/Exceptions/Handler.php: bnaj thêm khúc này vào để xuất json: 

hùng đẹp trai

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

bài viết được viết bởi trương thanh hùng https://ebudezain.com/

public function render($request, Exception $e)
{
    if ($e instanceof Tymon\JWTAuth\Exceptions\TokenExpiredException) {
        return response()->json(['token_expired'], $e->getStatusCode());
    } else if ($e instanceof Tymon\JWTAuth\Exceptions\TokenInvalidException) {
        return response()->json(['token_invalid'], $e->getStatusCode());
    }

    return parent::render($request, $e);
}