Python接口签名验证_请求合法性解析【教程】

发布时间 - 2026-01-08 00:00:00    点击率:
接口签名验证的核心是确保请求可信且未被篡改,服务端需按相同规则(字典序拼接参数+追加secret+HMAC-SHA256)生成签名并与请求sign比对,同时校验timestamp、nonce防重放及参数一致性。

接口签名验证的核心是确保请求来自可信客户端,且未被篡改。关键在于服务端能用相同规则重新生成签名,并与请求中携带的签名比对一致。

签名生成的基本逻辑

签名不是加密,而是对请求参数做确定性摘要。通常步骤包括:

  • 将所有参与签名的参数(如timestampnonceapp_id、业务字段等)按字典序排序
  • 拼接成key1=value1&key2=value2格式的字符串(注意URL编码需统一,一般不编码或全编码)
  • 在字符串末尾追加预共享密钥(secret),再用HMAC-SHA256等算法计算摘要
  • 将摘要结果转为十六进制小写字符串(或Base64),作为sign字段随请求发出

服务端验证的关键检查点

收到请求后,不能只比对sign,还要防控常见攻击:

  • 时间戳校验:拒绝timestamp超过当前时间±5分钟的请求,防止重放
  • Nonce去重:缓存近期用过的nonce(如Redis中设10分钟过期),重复即拒
  • 参数一致性:提取请求中所有待签名字段,严格按约定规则拼接,不得遗漏或错序
  • 签名算法匹配:确认客户端和服务端使用完全相同的哈希算法、密钥、编码方式(如是否对value做urllib.parse.quote)

Python服务端验证示例(Flask)

以下是一个轻量但完整的验证片段:

立即学习“Python免费学习笔记(深入)”;

import hmac
import hashlib
import time
from urllib.parse import urlencode

def verify_signature(data: dict, secret: str) -> bool:

提取必要字段

timestamp = int(data.pop('timestamp', 0))
nonce = data.pop('nonce', '')
sign = data.pop('sign', '')

# 时间有效性检查
if abs(time.time() - timestamp) > 300:
    return False

# Nonce防重放(需配合Redis或内存缓存)
if is_nonce_used(nonce):
    return False
mark_nonce_used(nonce)

# 拼接待签名字符串(按key字典序,不带sign)
sorted_items = sorted((k, v) for k, v in data.items() if k != 'sign')
query_string = '&'.join(f'{k}={v}' for k, v in sorted_items)

# 计算签名
message = (query_string + secret).encode()
expected_sign = hmac.new(
    secret.encode(), message, hashlib.sha256
).hexdigest()

return sign == expected_sign

容易踩坑的细节

很多签名失败并非逻辑错误,而是细节不一致:

  • 客户端用json.dumps传参,服务端却从request.args取——应统一用request.get_json()request.form
  • 空值处理不同:Python的None、空字符串''、数字0在拼接时是否参与?双方必须约定
  • 大小写敏感:字段名AppIdapp_id视为不同键,排序结果不同
  • 中文/特殊字符:若未统一URL编码,会导致拼接字符串不一致;建议全部urllib.parse.quote后再拼


# python  # redis  # js  # json  # 编码  # app  # mac  # python接口  # red 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Laravel如何清理系统缓存命令_Laravel清除路由配置及视图缓存的方法【总结】  Android中Textview和图片同行显示(文字超出用省略号,图片自动靠右边)  小米17系列还有一款新机?主打6.9英寸大直屏和旗舰级影像  Laravel Debugbar怎么安装_Laravel调试工具栏配置指南  微博html5版本怎么弄发超话_超话进入入口及发帖格式要求【教程】  Laravel如何设置自定义的日志文件名_Laravel根据日期或用户ID生成动态日志【技巧】  Laravel如何自定义分页视图?(Pagination示例)  制作网站软件推荐手机版,如何制作属于自己的手机网站app应用?  Laravel控制器是什么_Laravel MVC架构中Controller的作用与实践  Win11怎么恢复误删照片_Win11数据恢复工具使用【推荐】  Laravel请求验证怎么写_Laravel Validator自定义表单验证规则教程  如何撰写建站申请书?关键要点有哪些?  北京网站制作公司哪家好一点,北京租房网站有哪些?  再谈Python中的字符串与字符编码(推荐)  微信小程序 HTTPS报错整理常见问题及解决方案  html5如何实现懒加载图片_ intersectionobserver api用法【教程】  Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试  进行网站优化必须要坚持的四大原则  如何快速完成中国万网建站详细流程?  html文件怎么打开证书错误_https协议的html打开提示不安全【指南】  如何正确选择百度移动适配建站域名?  Laravel如何使用Service Container和依赖注入?(代码示例)  Laravel怎么使用Collection集合方法_Laravel数组操作高级函数pluck与map【手册】  C++用Dijkstra(迪杰斯特拉)算法求最短路径  如何在服务器上三步完成建站并提升流量?  Windows家庭版如何开启组策略(gpedit.msc)?(安装方法)  Laravel怎么实现验证码功能_Laravel集成验证码库防止机器人注册  Laravel如何使用Service Provider服务提供者_Laravel依赖注入与容器绑定【深度】  Laravel如何生成PDF或Excel文件_Laravel文档导出工具与使用教程  极客网站有哪些,DoNews、36氪、爱范儿、虎嗅、雷锋网、极客公园这些互联网媒体网站有什么差异?  打造顶配客厅影院,这份100寸电视推荐名单请查收  大同网页,大同瑞慈医院官网?  如何在宝塔面板创建新站点?  PHP 实现电台节目表的智能时间匹配与今日/明日轮播逻辑  Laravel怎么配置S3云存储驱动_Laravel集成阿里云OSS或AWS S3存储桶【教程】  敲碗10年!Mac系列传将迎来「触控与联网」双革新  如何用手机制作网站和网页,手机移动端的网站能制作成中英双语的吗?  如何解决hover在ie6中的兼容性问题  微信小程序 input输入框控件详解及实例(多种示例)  Swift中swift中的switch 语句  微信公众帐号开发教程之图文消息全攻略  Laravel如何使用Seeder填充数据_Laravel模型工厂Factory批量生成测试数据【方法】  香港服务器租用费用高吗?如何避免常见误区?  用yum安装MySQLdb模块的步骤方法  Laravel如何使用Gate和Policy进行权限控制_Laravel权限判定与策略规则配置  如何续费美橙建站之星域名及服务?  Internet Explorer官网直接进入 IE浏览器在线体验版网址  香港网站服务器数量如何影响SEO优化效果?  Win11怎么开启自动HDR画质_Windows11显示设置HDR选项  实例解析angularjs的filter过滤器