跳到主要内容

JWT

在 n8n 工作流中处理 JSON Web Token(JWT)。

信息

凭据

此节点的身份验证信息,请参阅 JWT 凭据文档。

操作 ​

  • Decode(解码)
  • Sign(签名)
  • Verify(验证)

节点参数 ​

信息

此节点可以用作 AI 工具

此节点可以增强 AI 智能体的能力。以这种方式使用时,许多参数可以自动设置,或根据 AI 提供的信息设置。更多信息请参阅 AI 工具参数文档。

  • Credential to connect with(连接凭据):选择或创建用于连接的 JWT 凭据。
  • Token(令牌):输入要 Verify(验证)或 Decode(解码)的令牌。
  • 选择 Sign(签名)操作后,还会有以下参数:
    • Use JSON to Build Payload(使用 JSON 构建载荷):开启时,节点使用 JSON 构建声明。此选项决定 Payload Claims(载荷声明)部分显示的内容。

Payload Claims(载荷声明) ​

只有选择 Sign(签名)操作时,节点才显示载荷声明。具体内容取决于 Use JSON to Build Payload(使用 JSON 构建载荷)的设置:

  • 开启 Use JSON to Build Payload(使用 JSON 构建载荷)时,此处显示 JSON 编辑器,可在其中构建声明。
  • 未开启 Use JSON to Build Payload(使用 JSON 构建载荷)时,此处提示 Add Claim(添加声明)。

可以添加以下声明。

Audience(受众) ​

Audience(受众)或 aud 声明用于标识 JWT 的预期接收方。

更多信息,请参阅 aud(受众)声明。

Expires In(过期时间) ​

Expires In(过期时间)或 exp 声明标识 JWT 过期的时间,在此时间之后不得再接受该 JWT 进行处理。

更多信息,请参阅 exp(过期时间)声明。

Issuer(签发者) ​

Issuer(签发者)或 iss 声明用于标识签发 JWT 的主体。

更多信息,请参阅 iss(签发者)声明。

JWT ID ​

JWT ID 或 jti 声明为 JWT 提供唯一标识。

更多信息,请参阅 jti(JWT ID)声明。

Not Before(生效时间) ​

Not Before(生效时间)或 nbf 声明标识 JWT 的生效时间,在此时间之前不得接受该 JWT 进行处理。

更多信息,请参阅 nbf(生效时间)声明。

Subject(主题) ​

Subject(主题)或 sub 声明标识 JWT 所涉及的主体。

更多信息,请参阅 sub(主题)声明。

节点选项 ​

Decode(解码)节点选项 ​

Return Additional Info(返回额外信息)开关控制节点返回的信息量。

开启时,节点返回完整的解码后令牌,包含头部和签名信息;关闭时,仅返回载荷。

Sign(签名)节点选项 ​

使用 Override Algorithm(覆盖算法)选择签名令牌所用的算法,此设置覆盖凭据中选择的算法。

Verify(验证)节点选项 ​

此操作包含以下节点选项:

  • Return Additional Info(返回额外信息):控制节点返回的信息量。开启时返回完整的解码后令牌,包含头部和签名信息;关闭时,仅返回载荷。
  • Ignore Expiration(忽略过期时间):控制是否忽略令牌的过期时间声明(exp)。更多信息,请参阅 exp(过期时间)声明。
  • Ignore Not Before Claim(忽略生效时间声明):控制是否忽略令牌的生效时间声明(nbf)。更多信息,请参阅 nbf(生效时间)声明。
  • Clock Tolerance(时钟容差):输入检查 nbf 和 exp 声明时可容忍的秒数,用于应对不同服务器间的微小时钟差异。更多信息,请参阅 exp(过期时间)声明。
  • Override Algorithm(覆盖算法):验证令牌所用的算法,此设置覆盖凭据中选择的算法。

模板与示例 ​

浏览 JWT 集成模板,或搜索所有模板

本文为社区中文翻译。查看对应英文原文