2.3 加密票据与身份边界
上一节的会话票据解决「证明你在线、且拥有这个 App」,这一节处理更强的需求:给服务器一段加密的身份证据,里面还带着业务数据。加密应用票据(Encrypted App Ticket)用 32 字节对称密钥加密,票内可以带上应用自定义数据、拥有关系、VAC 状态——服务器解密后读取字段,就能在不信任客户端自报的前提下做出授权决策。
本卷所有接口口径以 Steamworks SDK v1.65(2026-07-23) 为准。本节摘录的签名对照该版本 public/steam/isteamuser.h、steamencryptedappticket.h。
本章与站内既有内容的分工
- Steam 发行专题 (操作手册)讲「后台授权与反作弊配置」;本节讲「代码里把登录身份加密交给服务器的接口语义」。
- 卷一《平台机制与商店》讲平台机制;本节讲加密票据的身份边界——哪些字段能信、哪些不能。
- lab 用纯 C++ 模拟对称加解密与票据字段读取,不依赖 Steam 客户端运行。
从会话票据到加密票据
两种票据的分工:
| 维度 | 会话票据(GetAuthSessionTicket) | 加密应用票据(RequestEncryptedAppTicket) |
|---|---|---|
| 用途 | 对端验证「用户在线 + 拥有此 App」 | 给服务器「加密 + 带业务数据」的身份证据 |
| 加密 | 不向普通对端暴露密钥语义 | 32 字节对称密钥(应用与 Steam 共享) |
| 数据 | 基本身份与连接信息 | 可携带应用自定义数据(user data) |
| 验证方式 | 对端 BeginAuthSession | 服务器 BDecryptTicket 后读字段 |
工程语义的关键差异在信任方向:会话票据让「对端」验证用户;加密票据让「服务器」在不把密钥交给客户端的前提下验证用户。密钥由应用后端持有,客户端只负责出票与转发——服务器解密时不需要信任客户端任何自报字段。
出票与取票
加密票据是异步产生的:先请求,等回调,再取回。v1.65 的接口:
// isteamuser.h:RequestEncryptedAppTicket / GetEncryptedAppTicket(SDK v1.65 头文件摘录,已删减)
STEAM_CALL_RESULT( EncryptedAppTicketResponse_t )
virtual SteamAPICall_t RequestEncryptedAppTicket( void *pDataToInclude, int cbDataToInclude ) = 0;
virtual bool GetEncryptedAppTicket( void *pTicket, int cbMaxTicket, uint32 *pcbTicket ) = 0;
配套的回调结构(v1.65):
// isteamuser.h:EncryptedAppTicketResponse_t(SDK v1.65 头文件摘录,已删减)
struct EncryptedAppTicketResponse_t
{
enum { k_iCallback = k_iSteamUserCallbacks + 54 };
EResult m_eResult;
};
工程语义:
RequestEncryptedAppTicket把「要带进票里的数据」一并加密:pDataToInclude是应用自定义的字节(如会话编号、区域标记)。它是异步的,完成与否由回调EncryptedAppTicketResponse_t的EResult决定。GetEncryptedAppTicket取回票:同样遵循「先探测长度、再取回」的惯例——缓冲不足时返回 false 并把所需长度写入pcbTicket。票就绪前调用它拿不到完整数据。- 出票后的数据不可在客户端改:票由 Steam 客户端按共享密钥加密签发,客户端拿到的是密文。任何想改票内字段的行为在机制上就不成立——这正是身份边界的根。
解密与读取:steamencryptedappticket.h
服务器(或后端服务)拿到密文票后,用同一对称密钥解密并按需读字段。v1.65 的函数族:
// steamencryptedappticket.h:解密与读取函数族(SDK v1.65 头文件摘录,已删减)
static const int k_nSteamEncryptedAppTicketSymmetricKeyLen = 32;
S_API bool SteamEncryptedAppTicket_BDecryptTicket( const uint8 *rgubTicketEncrypted, uint32 cubTicketEncrypted,
uint8 *rgubTicketDecrypted, uint32 *pcubTicketDecrypted,
const uint8 rgubKey[k_nSteamEncryptedAppTicketSymmetricKeyLen], int cubKey );
S_API bool SteamEncryptedAppTicket_BIsTicketForApp( uint8 *rgubTicketDecrypted, uint32 cubTicketDecrypted, AppId_t nAppID );
S_API RTime32 SteamEncryptedAppTicket_GetTicketIssueTime( uint8 *rgubTicketDecrypted, uint32 cubTicketDecrypted );
S_API void SteamEncryptedAppTicket_GetTicketSteamID( uint8 *rgubTicketDecrypted, uint32 cubTicketDecrypted, CSteamID *psteamID );
S_API bool SteamEncryptedAppTicket_BUserOwnsAppInTicket( uint8 *rgubTicketDecrypted, uint32 cubTicketDecrypted, AppId_t nAppID );
S_API bool SteamEncryptedAppTicket_BUserIsVacBanned( uint8 *rgubTicketDecrypted, uint32 cubTicketDecrypted );
S_API bool SteamEncryptedAppTicket_BGetAppDefinedValue( uint8 *rgubTicketDecrypted, uint32 cubTicketDecrypted, uint32 *pValue );
S_API const uint8 *SteamEncryptedAppTicket_GetUserVariableData( uint8 *rgubTicketDecrypted, uint32 cubTicketDecrypted, uint32 *pcubUserData );
解密流程的工程语义:
- 先
BDecryptTicket,成功后再读字段:头文件开头就说明——BDecryptTicket返回 true 时其他 accessors 才有效。密钥不符或票被篡改,解密直接失败。 - 读字段是「服务器视角」:
GetTicketSteamID输出完整CSteamID,BIsTicketForApp/BUserOwnsAppInTicket校验归属,BUserIsVacBanned读取 VAC 状态。这些字段以 Steam 签发时为准,不是客户端填的。 BGetAppDefinedValue/GetUserVariableData读取业务数据:对应出票时pDataToInclude带进去的内容。服务器按约定格式解析即可。
身份边界
加密票据的工程语义最终归结到一条边界:信任放在票据(由 Steam 签发、密钥加密)上,不放在客户端进程上。
- VAC 状态以票为准:客户端自报「我没被封」毫无意义;服务器解密票里的
BUserIsVacBanned才是可信来源。 - 拥有关系以票为准:
BUserOwnsAppInTicket判断用户是否拥有票内 App(对应 DLC/内容授权,第 6 章展开)。 - 可篡改面被压到最小:客户端只持密钥参与出票与转发,无法改写密文;服务器侧解密失败即拒绝。身份边界就是「密钥在服务端、判定在服务端」。
- 对称密钥属于应用后端:
k_nSteamEncryptedAppTicketSymmetricKeyLen = 32的密钥由应用获取(partner 后台/Steamworks API),不应散落到客户端安装包里。
接口签名对照
| 头文件 | 条目 | 语义 |
|---|---|---|
isteamuser.h | ISteamUser::RequestEncryptedAppTicket(...) | 异步请求加密票据(可带业务数据) |
isteamuser.h | EncryptedAppTicketResponse_t | 请求完成回调(EResult) |
isteamuser.h | ISteamUser::GetEncryptedAppTicket(...) | 取回加密票(先探测长度) |
steamencryptedappticket.h | SteamEncryptedAppTicket_BDecryptTicket | 用 32 字节密钥解密 |
steamencryptedappticket.h | BIsTicketForApp/BUserOwnsAppInTicket/BUserIsVacBanned/… | 解密后字段读取 |
数据口径与来源
- 接口签名、回调结构字段、
k_nSteamEncryptedAppTicketSymmetricKeyLen = 32:SDK v1.65public/steam/isteamuser.h、steamencryptedappticket.h可实证(本机镜像已核对)。 - 「先 BDecryptTicket 再读字段」流程:
steamencryptedappticket.h顶部注释明文。 - 对称密钥的获取与轮换:partner.steamgames.com 登录后文档口径,以官方当前为准。
以上接口口径撰写时对照 Steamworks SDK v1.65 头文件与 partner.steamgames.com 官方文档核对;登录后可见数据以官方当前为准。
可运行产物:C++ 最小验证
下面的仿真复现「加密应用票据」的工程语义:32 字节对称密钥加解密、票内字段(AppID/签发时间/SteamID/VAC/ownedApp/userData/appDefinedValue)的加密-解密往返与读取、错密钥与篡改拒绝。它与 src/02-3-encrypted-ticket.cpp 逐字节一致,mock 签名对照 SDK v1.65 头文件:
// file: src/02-3-encrypted-ticket.cpp
// tier: L1
// verify: clang++ -std=c++20 -Wall -I. src/02-3-encrypted-ticket.cpp -o bin/02-3-encrypted-ticket && ./bin/02-3-encrypted-ticket
//
// mock:复现加密应用票据的工程语义——32 字节对称密钥加解密、
// 票内字段(AppID/签发时间/SteamID/ownedApp/VAC/userData/appDefinedValue)
// 的读取函数族。加解密用确定性伪加密(XOR + 反转)模拟,
// accessors 对照 SDK v1.65 steamencryptedappticket.h,非 Valve 实现。
#include "verify.h"
#include <cstdint>
#include <vector>
namespace steam_repro {
// k_nSteamEncryptedAppTicketSymmetricKeyLen 对照 steamencryptedappticket.h
static constexpr int kSymmetricKeyLen = 32;
struct MockTicketData {
uint32_t appId = 0;
uint32_t issueTime = 0;
uint64_t steamId = 0;
bool vacBanned = false;
std::vector<uint32_t> ownedApps;
std::vector<uint8_t> userData;
uint32_t appDefinedValue = 0;
};
class MockEncryptedTicket {
public:
static void push32(std::vector<uint8_t>& v, uint32_t x) {
for (int i = 0; i < 4; ++i) v.push_back((x >> (8 * i)) & 0xFF);
}
static void push64(std::vector<uint8_t>& v, uint64_t x) {
for (int i = 0; i < 8; ++i) v.push_back((x >> (8 * i)) & 0xFF);
}
static uint32_t read32(const std::vector<uint8_t>& v, size_t pos) {
uint32_t x = 0;
for (int i = 3; i >= 0; --i) x = (x << 8) | v[pos + i];
return x;
}
static uint64_t read64(const std::vector<uint8_t>& v, size_t pos) {
uint64_t x = 0;
for (int i = 7; i >= 0; --i) x = (x << 8) | v[pos + i];
return x;
}
// 加密:明文载荷 → 伪加密 blob(对称密钥异或 + 整体反转)
static bool encrypt(const MockTicketData& d, const uint8_t key[32], std::vector<uint8_t>* out) {
std::vector<uint8_t> payload;
push32(payload, d.appId);
push32(payload, d.issueTime);
push64(payload, d.steamId);
payload.push_back(d.vacBanned ? 1 : 0);
push32(payload, d.appDefinedValue);
payload.push_back(static_cast<uint8_t>(d.ownedApps.size()));
for (uint32_t a : d.ownedApps) push32(payload, a);
payload.insert(payload.end(), d.userData.begin(), d.userData.end());
out->resize(payload.size());
for (size_t i = 0; i < payload.size(); ++i) (*out)[i] = payload[i] ^ key[i % kSymmetricKeyLen];
std::reverse(out->begin(), out->end());
return true;
}
// 解密:伪加密 blob → 明文载荷 → 结构化票数据;密钥不符或长度异常返回 false
static bool decrypt(const std::vector<uint8_t>& blob, const uint8_t key[32], MockTicketData* d) {
if (blob.size() < 22) return false;
std::vector<uint8_t> payload = blob;
std::reverse(payload.begin(), payload.end());
for (size_t i = 0; i < payload.size(); ++i) payload[i] ^= key[i % kSymmetricKeyLen];
size_t pos = 0;
d->appId = read32(payload, pos);
pos += 4;
d->issueTime = read32(payload, pos);
pos += 4;
d->steamId = read64(payload, pos);
pos += 8;
d->vacBanned = payload[pos++] != 0;
d->appDefinedValue = read32(payload, pos);
pos += 4;
uint8_t count = payload[pos++];
d->ownedApps.clear();
for (uint8_t i = 0; i < count; ++i) {
if (pos + 4 > payload.size()) return false;
d->ownedApps.push_back(read32(payload, pos));
pos += 4;
}
d->userData.assign(payload.begin() + pos, payload.end());
return true;
}
// 下列 accessors 对照 steamencryptedappticket.h 函数族
static bool bIsTicketForApp(const MockTicketData& d, uint32_t appId) { return d.appId == appId; }
static bool bUserOwnsAppInTicket(const MockTicketData& d, uint32_t appId) {
for (uint32_t a : d.ownedApps) {
if (a == appId) return true;
}
return false;
}
static bool bUserIsVacBanned(const MockTicketData& d) { return d.vacBanned; }
static uint32_t getTicketIssueTime(const MockTicketData& d) { return d.issueTime; }
static uint64_t getTicketSteamID(const MockTicketData& d) { return d.steamId; }
static const std::vector<uint8_t>& getUserVariableData(const MockTicketData& d) {
return d.userData;
}
static bool bGetAppDefinedValue(const MockTicketData& d, uint32_t* pValue) {
if (pValue) *pValue = d.appDefinedValue;
return true;
}
};
} // namespace steam_repro
int main() {
using namespace steam_repro;
const uint8_t key[kSymmetricKeyLen] = {
0x1A, 0x2B, 0x3C, 0x4D, 0x5E, 0x6F, 0x70, 0x81,
0x92, 0xA3, 0xB4, 0xC5, 0xD6, 0xE7, 0xF8, 0x09,
0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88,
0x99, 0xAA, 0xBB, 0xCC, 0xDD, 0xEE, 0xFF, 0x00};
const uint8_t wrongKey[kSymmetricKeyLen] = {0};
MockTicketData src;
src.appId = 480;
src.issueTime = 1735000000;
src.steamId = 76561197960287930ull;
src.vacBanned = true;
src.ownedApps = {480, 481};
src.userData = {1, 2, 3, 4};
src.appDefinedValue = 2026;
// 1. 加密-解密往返:核心字段全部还原
std::vector<uint8_t> blob;
CHECK(MockEncryptedTicket::encrypt(src, key, &blob));
MockTicketData dec;
CHECK(MockEncryptedTicket::decrypt(blob, key, &dec));
CHECK(dec.appId == 480);
CHECK(dec.issueTime == 1735000000);
CHECK(dec.steamId == 76561197960287930ull);
CHECK(dec.vacBanned);
CHECK(dec.appDefinedValue == 2026);
// 2. ownedApps 还原
CHECK(dec.ownedApps.size() == 2);
CHECK(dec.ownedApps[0] == 480 && dec.ownedApps[1] == 481);
// 3. userData 还原
const auto& ud = MockEncryptedTicket::getUserVariableData(dec);
CHECK(ud.size() == 4);
CHECK(ud[0] == 1 && ud[3] == 4);
// 4. 票归属判定:属于 App 480,不属于 482
CHECK(MockEncryptedTicket::bIsTicketForApp(dec, 480));
CHECK(!MockEncryptedTicket::bIsTicketForApp(dec, 482));
// 5. 用户拥有判定:拥有 481,不拥有 483
CHECK(MockEncryptedTicket::bUserOwnsAppInTicket(dec, 481));
CHECK(!MockEncryptedTicket::bUserOwnsAppInTicket(dec, 483));
// 6. VAC 状态、签发时间、SteamID accessors
CHECK(MockEncryptedTicket::bUserIsVacBanned(dec));
CHECK(MockEncryptedTicket::getTicketIssueTime(dec) == 1735000000);
CHECK(MockEncryptedTicket::getTicketSteamID(dec) == 76561197960287930ull);
// 7. appDefinedValue accessor
uint32_t v = 0;
CHECK(MockEncryptedTicket::bGetAppDefinedValue(dec, &v));
CHECK(v == 2026);
// 8. 错误密钥解密失败
MockTicketData bad;
CHECK(!MockEncryptedTicket::decrypt(blob, wrongKey, &bad));
// 9. 篡改 blob 后解密失败或字段异常(翻转 ownedApp 计数字节 → 结构校验失败)
std::vector<uint8_t> tampered = blob;
tampered[12] ^= 0xFF;
MockTicketData t;
bool ok = MockEncryptedTicket::decrypt(tampered, key, &t);
CHECK(!ok || t.appId != 480);
// 10. 无 owned app 的票:BUserOwnsAppInTicket 恒 false
MockTicketData bare;
bare.appId = 480;
bare.issueTime = 1;
bare.steamId = 1;
std::vector<uint8_t> b2;
CHECK(MockEncryptedTicket::encrypt(bare, key, &b2));
MockTicketData dec2;
CHECK(MockEncryptedTicket::decrypt(b2, key, &dec2));
CHECK(!MockEncryptedTicket::bUserOwnsAppInTicket(dec2, 480));
CHECK(!MockEncryptedTicket::bUserIsVacBanned(dec2));
return lab::report("02-3 加密票据与身份边界");
}
本机实测(Apple clang 16,clang++ -std=c++20 -Wall):编译通过(零警告),断言 26/26 通过。
小结
- 加密应用票据:32 字节对称密钥加密的身份证据,出票异步(
RequestEncryptedAppTicket→ 回调 →GetEncryptedAppTicket取回)。 - 服务器解密:先
BDecryptTicket再读字段;密钥不符或篡改即失败。 - 身份边界:VAC 状态、拥有关系等以票为准;客户端自报不可信,密钥归属应用后端。
- 与会话票据的分工:会话票据让对端验证在线与拥有,加密票据让服务器拿到带业务数据的可信身份。
阅读导航:上一节:2.2 登录状态与会话票据 · 下一节:3.1 成就机制 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。