pta_1st_key
`pta_1st_key` 指令为 NGINX 中的 Period of Time Authentication 模块设置第一个加密密钥。
Period of Time Authentication module for NGINX
·
server
语法pta_1st_key keystring;
默认值none
上下文server
参数1
说明
pta_1st_key 指令是 NGINX 的 Period of Time Authentication (PTA) 模块的一部分,该模块通过强制使用时限加密的查询字符串或 cookie 参数来控制对内容的访问。该指令专门指定用于处理以查询参数或 cookie 形式表示的 PTA 令牌的两个加密密钥中的第一个。提供给该指令的值应是对应于 128 位密钥的十六进制字符串,这对于模块所采用的加密和解密过程的初始阶段至关重要。
在请求处理期间,PTA 模块使用由 pta_1st_key 设置的密钥,配合其对应的初始化向量(通过 pta_1st_iv 指令定义)来解密 PTA 令牌。该令牌包含关键信息,包括到期时间戳和 URI 路径。如果解密成功——通过检查 CRC32 校验和进行验证——模块会将过期时间与当前时间比较,以确定是否应允许访问所请求的内容。如果请求不满足 PTA 令牌中指定的条件,或者令牌已过期,则会拒绝访问。
配置 pta_1st_key 对 PTA 模块的安全性至关重要。没有它,无法解密加密令牌,从而使任何访问控制机制无法运行。建议妥善管理该密钥,例如对其进行保护并确保每个部署使用唯一的密钥。
配置示例
pta_1st_key 0102030405060708090a0b0c0d0e0f00;
⚠
确保提供的 key 是有效的 128-bit hexadecimal string (32 hexadecimal characters).
⚠
如果重新配置 PTA 模块,必须更新 key,以防现有 tokens 出现访问问题。
⚠
key 或 IV 的错误配置可能导致 request validation 失败,从而拒绝合法访问。