$secure_link_expires

$secure_link_expires 返回 NGINX 中安全链接的过期时间戳。 — NGINX Core (HTTP)

$secure_link_expires NGINX Core (HTTP)

说明

`$secure_link_expires` 变量在 NGINX 中保存安全链接的过期时间,特别是在使用 `secure_link` 指令时定义。该变量通常与 `$secure_link` 变量一起设置,后者为安全 URL 访问生成唯一签名。它返回的过期时间以 Unix 时间戳格式表示,指示安全资源何时不再可访问。如果未显式设置,默认值为 0,使链接无限期有效,除非通过配置设置限制。 在使用 `$secure_link` 机制时,通常同时定义链接及其过期时间以提供对资源的临时访问。过期时间可以通过 `secure_link` 指令中的 `expires` 参数设置,该指令在你的 NGINX 配置中指定。通过提供合适的过期值,例如当前时间加上某个有效持续时间(例如一天的秒数),你可以基于时间敏感的参数有效地管理对资源的访问。 该变量在需要对文件(例如媒体内容、下载文件或其他敏感资源)实施时限访问的场景中非常有用。将其与访问控制指令结合使用,可以为经过身份验证的用户创建安全的短期链接,从而增强应用的安全性。

配置示例

location /protected {
    secure_link $arg_md5,$secure_link_expires;
    secure_link_md5 "$uri$time$key";
    if ($secure_link = 0) {
        return 403;
    }
}

子系统

http

可缓存

上下文

http, server, location, if

确保 secure link 指令已正确设置;否则,该变量可能无法返回有效值。

不要依赖该变量来处理应该永久有效的链接,除非在配置中明确将其定义为如此。