欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

php JWT在web端中的使用方法教程

程序员文章站 2023-02-16 11:04:57
解释一下jwt jwt就是一个字符串,经过加密处理与校验处理的字符串,由三个部分组成。基于token的身份验证可以替代传统的cookie+session身份验证方法。...

解释一下jwt

jwt就是一个字符串,经过加密处理与校验处理的字符串,由三个部分组成。基于token的身份验证可以替代传统的cookie+session身份验证方法。三个部分分别如下:

 header.payload.signature

header部分组成

header 格式为:

{
"typ":"jwt",
"alg":"hs256"
}

这就是一个json串,两个字段都是必须的,alg字段指定了生成signature的算法,默认值为 hs256,可以自己指定其他的加密算法,如rsa.经过base64encode就可以得到 header.

payload 部分组成

playload 基本组成部分:

简单点:

$payload=[
  'iss' => $issuer, //签发者
  'iat' => $_server['request_time'], //什么时候签发的
  'exp' => $_server['request_time'] + 7200 //过期时间
  'uid'=>1111
 ];

复杂点:官方说法,三个部分组成(reserved claims,public claims,private claims)

 $token = [
  #非必须。issuer 请求实体,可以是发起请求的用户的信息,也可是jwt的签发者。
  "iss" => "http://example.org",
  #非必须。issued at。 token创建时间,unix时间戳格式
  "iat" => $_server['request_time'],
  #非必须。expire 指定token的生命周期。unix时间戳格式
  "exp" => $_server['request_time'] + 7200,
  #非必须。接收该jwt的一方。
  "aud" => "http://example.com",
  #非必须。该jwt所面向的用户
  "sub" => "jrocket@example.com",
  # 非必须。not before。如果当前时间在nbf里的时间之前,则token不被接受;一般都会留一些余地,比如几分钟。
  "nbf" => 1357000000,
  # 非必须。jwt id。针对当前token的唯一标识
  "jti" => '222we',
  # 自定义字段
  "givenname" => "jonny",
  # 自定义字段
  "name" => "rocket",
  # 自定义字段
  "email" => "jrocket@example.com",
  
 ];

payload 也是一个json数据,是表明用户身份的数据,可以自己自定义字段,很灵活。你也可以简单的使用,比如简单的方式。经过json_encode和base64_encode就可得到payload

signature组成部分

将 header和 payload使用header中指定的加密算法加密,当然加密过程还需要自定秘钥,自己选一个字符串就可以了。
官网实例:

hmacsha256(
 base64urlencode(header) + "." +
 base64urlencode(payload),
 secret)

自己使用:

<?php

 public static function encode(array $payload, string $key, string $alg = 'sha256')
 {
 $key = md5($key);
 $jwt = self::urlsafeb64encode(json_encode(['typ' => 'jwt', 'alg' => $alg])) . '.' . self::urlsafeb64encode(json_encode($payload));
 return $jwt . '.' . self::signature($jwt, $key, $alg);
 }

 public static function signature(string $input, string $key, string $alg)
 {
 return hash_hmac($alg, $input, $key);
 }

这三个部分使用.连接起来就是高大上的jwt,然后就可以使用了.

jwt使用流程

官方使用流程说明:

php JWT在web端中的使用方法教程

翻译一下:

  • 初次登录:用户初次登录,输入用户名密码
  • 密码验证:服务器从数据库取出用户名和密码进行验证
  • 生成jwt:服务器端验证通过,根据从数据库返回的信息,以及预设规则,生成jwt
  • 返还jwt:服务器的http response中将jwt返还
  • 带jwt的请求:以后客户端发起请求,http request header中的authorizatio字段都要有值,为jwt

jwt 验证过程

因为自己写的,没有使用框架,所以还是得简单记录一下验证过程

客户端在请求头中带有jwt信息,后端获取$_server[http_authorization]:

php JWT在web端中的使用方法教程

不过注意一点,我这个authorization没有加bearer,官方使用中就使用了bearer,你也可以自己使用:

authorization: bearer <token>

php 验证伪代码:

<?php
public static function decode(string $jwt, string $key)
 {
  $tokens = explode('.', $jwt);
  $key = md5($key);

  if (count($tokens) != 3)
   return false;

  list($header64, $payload64, $sign) = $tokens;

  $header = json_decode(self::urlsafeb64decode($header64), json_object_as_array);
  if (empty($header['alg']))
   return false;

  if (self::signature($header64 . '.' . $payload64, $key, $header['alg']) !== $sign)
   return false;

  $payload = json_decode(self::urlsafeb64decode($payload64), json_object_as_array);

  $time = $_server['request_time'];
  if (isset($payload['iat']) && $payload['iat'] > $time)
   return false;

  if (isset($payload['exp']) && $payload['exp'] < $time)
   return false;

  return $payload;
 }

 public static function urlsafeb64decode(string $input)
 {
  $remainder = strlen($input) % 4;

  if ($remainder)
  {
   $padlen = 4 - $remainder;
   $input .= str_repeat('=', $padlen);
  }

  return base64_decode(strtr($input, '-_', '+/'));
 }
 
 
  public static function urlsafeb64encode(string $input)
 {
  return str_replace('=', '', strtr(base64_encode($input), '+/', '-_'));
 }

jwt 在使用中的注意事项

使用了 jwt 我们一般都会考虑两点:

1. 签名是否正确?

2. token是否到期?

这两块可以通过校验几个字段来处理

1. 建立 token 吊销机制,将 token 写入数据库,

2. 无效 token 因未入数据库,所以确信传入的 token 是有效的。

3. 对有效的 token 进行签名验证,获取到 token 后重新生成签名进行校验 token 的签名部分( c 位的值)是否一致。

4. 确认是否 token 超时可以通过 exp(expire 指定token的生命周期。unix时间戳格式) 和 nbf(not before。如果当前时间在nbf里的时间之前,则token不被接受。unix时间戳格式。) 声明,获取到 token 后,对时间进行判断。

5. 为了防止replay attack,可加上 iss(issuer 请求实体,可以是发起请求的用户的信息,也可是jwt的签发者。),jti (jwt id。针对当前token的唯一标识) 和 iat(issued at。 token创建时间,unix时间戳格式) 声明,然后获取到 token 后,对声明信息进行匹配。

参考文章:


总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对的支持。