ouzhou
d7c29c0883
- rewards: 激励视频实发改按 calculate_ad_reward_coin(eCPM, 当日第N次) 公式;AD_REWARD_COIN/MAX_AD_REWARD_COIN 降为历史兼容口径;新增 SIGNIN_BOOST_COIN=2000 - 签到膨胀: Day1-13 看完激励视频额外发固定金币、Day14 不允许 (signin.py / signin-boost) - ad_session_id 幂等: ad_ecpm/ad_reward/ad_feed_reward 记录加 ad_session_id 列 + 唯一索引(新迁移 coin_reward_phase2 / ad_feed_reward_session) - ad.py + schemas + repositories: ecpm-report / feed-reward / reward-status / test-grant 改造;config_schema 增 signin_boost_coin;admin stats overview 补充 - 同步 docs/api + docs/database + docs/integrations/pangle 及 tests(test_ad_reward / test_welfare) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: OuYingJun1024 <1034284404@qq.com> Reviewed-on: #28 Co-authored-by: ouzhou <ouzhou@wonderable.ai> Co-committed-by: ouzhou <ouzhou@wonderable.ai>
2.2 KiB
2.2 KiB
穿山甲激励视频发奖回调 — 验签（pangle）
文件:
app/integrations/pangle.py| 关联接口:ad-pangle-callback | ← 集成索引
作用
穿山甲激励视频播完后，穿山甲服务器会 GET 回调我们的 /api/v1/ad/pangle-callback（带 user_id / trans_id / sign 等 query）。本模块负责验签，确认回调真来自穿山甲而非伪造请求；验签通过后由数据层（repositories/ad_reward）幂等发金币。客户端不参与发奖，被破解也刷不到钱。
验签方案（关键）
sign = SHA256("{m-key}:{trans_id}") 的十六进制串。
- 是普通 SHA256，不是 HMAC，也不是 RSA。
- 只对
m-key:trans_id这一个字符串签名，user_id/ecpm/extra等其余参数不参与签名。它们的可信度由"能算出正确 sign = 知道 m-key"间接保证——伪造者没有 m-key 连合法 sign 都造不出，自然无法注入假user_id。 - 这是穿山甲 GroMore「广告位 → 服务端激励回调」官方规范（supportcenter/26240）。我们客户端是
useMediation(true)融合，回调走 GroMore 广告位层级，不是联盟代码位层级。
函数
| 函数 | 说明 |
|---|---|
build_sign(trans_id, secret) -> str |
计算 SHA256("{secret}:{trans_id}") hex。自验签测试 / 模拟回调脚本共用，保证两端一致 |
verify_callback_sign(params, secret) -> bool |
校验回调签名。密钥空 / 缺 trans_id 一律失败；比较用 hmac.compare_digest 定长比较防时序侧信道 |
配置
| 配置项 | 说明 |
|---|---|
PANGLE_REWARD_SECRET |
m-key（安全密钥）。后台「GroMore 聚合管理 → 搜广告位 ID → 编辑」处获取 |
踩坑
- 别用联盟代码位那套：联盟代码位层级用的是另一套 Security Key +
isValid响应体，与 GroMore 广告位层级不通用。我们走 GroMore，别接错。 - 验签失败时 api 层返
403（留给真请求重试）；验签过但参数缺/坏或 user 不存在，则受理不发奖、不让穿山甲重试。 - 本地无公网、回调打不到时，用 ad-test-grant 模拟（仅联调，开关控制）。