如何使用 JWT 安全保护 PHP API(适用于 Android 应用)

冬枫姑娘_5588

冬枫姑娘_5588

2026-06-29

479人浏览

原创

如何使用 JWT 安全保护 PHP API(适用于 Android 应用)

本文详解如何通过 jwt(json web token)为 php 后端 api 添加身份认证与访问控制,确保仅授权的 android 原生应用可调用接口(如添加图书),同时抵御 postman 等非授权客户端请求。

本文详解如何通过 jwt(json web token)为 php 后端 api 添加身份认证与访问控制,确保仅授权的 android 原生应用可调用接口(如添加图书),同时抵御 postman 等非授权客户端请求。

在移动应用与后端 API 的通信中,“仅允许正版 Android 应用调用”是一个常见但无法 100% 绝对实现的安全目标——因为任何客户端代码(包括 APK)都可能被逆向分析。因此,真正的安全策略应聚焦于:防止未授权用户访问、阻断非法请求、最小化攻击面,而非试图“识别设备来源”。JWT 正是实现这一目标的核心机制:它将用户身份与权限以加密签名的方式封装在令牌中,服务端无需查库即可高效验证其真实性与有效性。

✅ 正确的安全实践:JWT 认证流程

  1. 登录鉴权(一次):Android 应用提交用户名/密码 → PHP 后端验证凭证 → 成功后生成并返回 JWT(含 user_id、role、exp 等声明)
  2. API 调用(每次):Android 在请求头携带 Authorization: Bearer → PHP 解析并验证 JWT 签名与时效性 → 检查 role 是否具备操作权限(如 "admin": true)→ 通过则执行业务逻辑,否则返回 401 Unauthorized

⚠️ 注意:JWT 不用于识别“是否来自 Android”,而是识别“是否为合法授权用户”。所谓“防 Postman”本质是要求所有请求必须携带有效令牌——Postman 可模拟,但无合法登录凭据就无法获取有效 token。

? 手动实现 JWT(无第三方库)

以下为精简、可直接集成的 PHP JWT 工具函数(基于 HS256 签名算法):

Android Remote Control
Android Remote Control

远程控制 Android 设备,支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架,通过 ADB 连接设备,用户无需 Root(1)查看手机屏幕;(2)自动化操作手机 App;(3)远程安装/卸载应用……

下载
// JWT 工具函数(建议放入 utils.php 或类中)
function base64url_encode($data) {
    return rtrim(strtr(base64_encode($data), '+/', '-_'), '=');
}

function generate_jwt($payload, $secret = 'your-strong-secret-key-here') {
    $header = json_encode(['alg' => 'HS256', 'typ' => 'JWT']);
    $headers_encoded = base64url_encode($header);
    $payload_encoded = base64url_encode(json_encode($payload));

    $signature = hash_hmac('SHA256', "$headers_encoded.$payload_encoded", $secret, true);
    $signature_encoded = base64url_encode($signature);

    return "$headers_encoded.$payload_encoded.$signature_encoded";
}

function validate_jwt($jwt, $secret = 'your-strong-secret-key-here') {
    $parts = explode('.', $jwt);
    if (count($parts) !== 3) return false;

    list($header_b64, $payload_b64, $signature_b64) = $parts;

    // 验证签名
    $expected_signature = base64url_encode(
        hash_hmac('SHA256', "$header_b64.$payload_b64", $secret, true)
    );
    if ($expected_signature !== $signature_b64) return false;

    // 解析 payload 并校验过期时间
    $payload = json_decode(base64_decode($payload_b64), true);
    if (!isset($payload['exp']) || $payload['exp'] <h3>?️ 改造 addNewBook.php —— 添加 JWT 验证</h3><pre class="brush:php;toolbar:false;"><?php header('Content-Type: application/json; charset=utf-8');

// 1. 数据库连接(请使用环境变量或配置文件管理敏感信息)
$connection = mysqli_connect("host", "user", "pass", "db_name");
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

// 2. 提取并验证 JWT
$auth_header = $_SERVER['HTTP_AUTHORIZATION'] ?? '';
if (strpos($auth_header, 'Bearer ') !== 0) {
    http_response_code(401);
    echo json_encode(['error' => 'Missing or invalid Authorization header']);
    exit;
}
$token = trim(substr($auth_header, 7));

$secret_key = 'your-strong-secret-key-here'; // 生产环境务必使用 .env 或密钥管理服务
$payload = validate_jwt($token, $secret_key);
if (!$payload) {
    http_response_code(401);
    echo json_encode(['error' => 'Invalid or expired token']);
    exit;
}

// 3. 执行业务逻辑(此时已确认是合法管理员)
$bookName = $_POST['bookName'] ?? '';
if (empty($bookName)) {
    http_response_code(400);
    echo json_encode(['error' => 'Book name is required']);
    exit;
}

// 使用预处理语句防止 SQL 注入(关键!)
$stmt = $connection->prepare("INSERT INTO BOOKS (NAME) VALUES (?)");
$stmt->bind_param("s", $bookName);
$stmt->execute();

echo json_encode(['success' => true, 'message' => 'Book added successfully']);
?>

? 关键注意事项与最佳实践

  • 密钥安全:$secret 必须足够长(推荐 32+ 字符随机字符串)、绝不硬编码在代码中,应通过环境变量(如 .env)加载。
  • HTTPS 强制:JWT 包含敏感信息,必须全程使用 HTTPS,否则令牌易被中间人窃取。
  • Token 存储:Android 端应将 JWT 存于 EncryptedSharedPreferences 或 BiometricPrompt 保护的密钥库中,切勿明文存 SharedPreferences。
  • 权限最小化:Payload 中只包含必要字段(如 user_id, role, exp),避免泄露敏感信息。
  • 刷新机制:短期 token(如 15–60 分钟)配合 refresh token 实现无缝续期,提升安全性。
  • 反向代理防护:在 Nginx/Apache 层添加 Access-Control-Allow-Origin 限制、速率限制(rate limiting)及 WAF 规则,形成纵深防御。

✅ 总结

JWT 不是“魔法开关”,而是构建可信会话的基石。它让 PHP API 能快速、无状态地验证请求合法性,将安全重心从“堵住客户端”转向“管好凭证与权限”。结合 HTTPS、预处理语句、合理密钥管理和前端安全存储,你的 addNewBook.php 就能真正抵御绝大多数未授权访问——这才是面向生产环境的务实安全方案。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php android

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

11644

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6701

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2175

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4248

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4974

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3911

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5637

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4402

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12322

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习