Cloudflare Worker JWT

一个适用于Cloudflare Workers的轻量级JWT实现，零依赖。

目录

• 安装
• 示例
• 使用方法
  • 签名
  • 验证
  • 解码

安装

npm i @tsndr/cloudflare-worker-jwt

示例

基本示例

async () => {
    import jwt from '@tsndr/cloudflare-worker-jwt'

    // 创建令牌
    const token = await jwt.sign({ name: 'John Doe', email: 'john.doe@gmail.com' }, 'secret')

    // 验证令牌
    const isValid = await jwt.verify(token, 'secret')

    // 检查有效性
    if (!isValid)
        return

    // 解码令牌
    const { payload } = jwt.decode(token)
}

限制时间范围

async () => {
    import jwt from '@tsndr/cloudflare-worker-jwt'

    // 创建令牌
    const token = await jwt.sign({
        name: 'John Doe',
        email: 'john.doe@gmail.com',
        nbf: Math.floor(Date.now() / 1000) + (60 * 60),      // 生效时间：现在 + 1小时
        exp: Math.floor(Date.now() / 1000) + (2 * (60 * 60)) // 过期时间：现在 + 2小时
    }, 'secret')

    // 验证令牌
    const isValid = await jwt.verify(token, 'secret') // false

    // 检查有效性
    if (!isValid)
        return

    // 解码令牌
    const { payload } = jwt.decode(token) // { name: 'John Doe', email: 'john.doe@gmail.com', ... }
}

使用方法

• 签名
• 验证
• 解码

签名

jwt.sign(payload, secret, [options])

签名一个载荷并返回令牌。

参数

返回值

返回一个string类型的令牌。

验证

jwt.verify(token, secret, [options])

验证令牌的完整性并返回一个布尔值。

抛出

如果options.throwError为true且令牌无效，将抛出错误。

返回值

如果签名、nbf（如果设置）和exp（如果设置）有效，则返回true，否则返回false。

解码

jwt.decode(token)

返回载荷，不验证令牌的完整性。请先使用jwt.verify()以确保应用程序的安全！

返回值

返回一个包含header和payload的object：

{
    header: {
        alg: 'HS256',
        typ: 'JWT'
    },
    payload: {
        name: 'John Doe',
        email: 'john.doe@gmail.com'
    }
}

可用算法

• ES256
• ES384
• ES512
• HS256
• HS384
• HS512
• RS256
• RS384
• RS512