进阶 yourls.org 2026-11-19 17:39:56 · 1 阅读
第10章 YOURLS 表单安全性
第10章 YOURLS 表单的安全性
YOURLS 的表单和内部链接大量使用 nonce(一次性数字)来防止你被诱导执行非本意的操作。
能进入后台区域说明你有权限,而 nonce 的作用是确保这些操作确实出于你的本意。
什么是 nonce
Nonce 是一些看似乱码的字符串,常见于内部链接中,比如后台界面里激活插件时链接里的这段:
https://sho.rt/admin/plugins.php?action=activate&plugin=joe-plugin&nonce=47876625a6
这个 nonce 用于验证用户的操作是有意为之,且确实来自 YOURLS 后台。 每个 nonce 都与 YOURLS 实例、当前用户、所请求的操作以及操作发生的时间(默认 12 小时有效,可自定义,见下文)绑定。只要其中任何一项变化,nonce 就会失效。 举例来说,正因为有 nonce 的保护,没人能诱导你去停用某个插件(或删除短链接,或执行后台里的任何操作),因为下面这样的链接缺少有效的 nonce: https://sho.rt/admin/plugins.php?action=deactivate&plugin=joe-plugin
用 nonce 保护链接 如果你的操作是通过点击链接触发的,可以用 yourls_nonce_url() 给链接加上 nonce。它接受两个参数:操作名称和 URL。 示例: $url = yourls_admin_url('plugins.php?page=joe-plugin');
var_dump($url);
// "http://sho.rt/admin/plugins.php?page=joe-plugin"
var_dump(yourls_nonce_url('joe-plugin-some-action', $url));
// "http://sho.rt/admin/plugins.php?page=joe-plugin&nonce=845aa035e4"
之后在目标页面就可以校验这个 nonce 是否有效,方法见下文。 用 nonce 保护表单 要给
校验 nonce 在执行受 nonce 保护的操作之前,需用 yourls_verify_nonce() 传入所请求的操作名称进行校验。示例: // Process form to delete all URLs as requested
function joe-plugin-delete-everything() {
// make sure there's a valid nonce -- if not the script will abort
yourls_verify_nonce( 'joe-plugin-some-action' );
// Now delete everything
...
自定义 nonce 有效期 默认情况下,nonce 的有效期为 12 小时。源码中这样定义: // nonce 的有效期(单位:秒)
if (!defined( 'YOURLS_NONCE_LIFE' ))
define( 'YOURLS_NONCE_LIFE', 43200 ); // 3600 * 12
若需自定义有效期(例如1小时,即3600秒),请在 config.php 中添加: define( 'YOURLS_NONCE_LIFE', 3600 );
这个 nonce 用于验证用户的操作是有意为之,且确实来自 YOURLS 后台。 每个 nonce 都与 YOURLS 实例、当前用户、所请求的操作以及操作发生的时间(默认 12 小时有效,可自定义,见下文)绑定。只要其中任何一项变化,nonce 就会失效。 举例来说,正因为有 nonce 的保护,没人能诱导你去停用某个插件(或删除短链接,或执行后台里的任何操作),因为下面这样的链接缺少有效的 nonce: https://sho.rt/admin/plugins.php?action=deactivate&plugin=joe-plugin
用 nonce 保护链接 如果你的操作是通过点击链接触发的,可以用 yourls_nonce_url() 给链接加上 nonce。它接受两个参数:操作名称和 URL。 示例: $url = yourls_admin_url('plugins.php?page=joe-plugin');
var_dump($url);
// "http://sho.rt/admin/plugins.php?page=joe-plugin"
var_dump(yourls_nonce_url('joe-plugin-some-action', $url));
// "http://sho.rt/admin/plugins.php?page=joe-plugin&nonce=845aa035e4"
之后在目标页面就可以校验这个 nonce 是否有效,方法见下文。 用 nonce 保护表单 要给
校验 nonce 在执行受 nonce 保护的操作之前,需用 yourls_verify_nonce() 传入所请求的操作名称进行校验。示例: // Process form to delete all URLs as requested
function joe-plugin-delete-everything() {
// make sure there's a valid nonce -- if not the script will abort
yourls_verify_nonce( 'joe-plugin-some-action' );
// Now delete everything
...
自定义 nonce 有效期 默认情况下,nonce 的有效期为 12 小时。源码中这样定义: // nonce 的有效期(单位:秒)
if (!defined( 'YOURLS_NONCE_LIFE' ))
define( 'YOURLS_NONCE_LIFE', 43200 ); // 3600 * 12
若需自定义有效期(例如1小时,即3600秒),请在 config.php 中添加: define( 'YOURLS_NONCE_LIFE', 3600 );