1. 课程导入与全景认知

在物联网与智能设备大规模部署的今天，设备不再只是被动采集数据的终端，而是会主动调用云端API、上报遥测、拉取配置、执行远程指令的“第一类公民”。当一台摄像头、一个边缘网关或一批传感器通过HTTPS向平台发起请求时，平台首先要回答三个问题：你是谁、你能做什么、你还能做多久。这三个问题分别对应身份认证、授权与令牌生命周期管理，也正是本课程要系统解决的“设备API身份认证与令牌治理”。

需要先划清边界。设备API身份认证与令牌治理，不等于设备接入网络时的Wi-Fi或蜂窝鉴权，也不等于用户账号登录。它关注的是设备在应用层调用API时的身份凭证如何签发、携带、校验、续期、吊销与审计。典型对象包括设备唯一标识（如device_id、SN、UUID）、密钥或证书、访问令牌（access token）、刷新令牌（refresh token）、令牌作用域（scope）以及平台侧的令牌状态存储。核心挑战可以归纳为四类：一是凭证安全，设备端容易被物理接触或固件提取，密钥不能硬编码明文；二是规模与性能，十万级设备同时刷新令牌会造成认证服务瞬时压力；三是生命周期一致性，设备离线、换绑、注销后令牌必须及时失效，否则形成“幽灵授权”；四是可观测与合规，每一次令牌签发和API调用都要能追溯到设备与策略。

为了把这条链路讲清楚，课程采用“概念—机制—实现—治理—实战”的递进结构。前段建立术语与模型，中段深入令牌签发与校验的具体实现，后段进入治理与排障。学习地图可以用下面的关系图来理解：左侧是设备侧，右侧是平台侧，中间是令牌与策略的流转。

上图把课程的全景压缩成一张关系图：设备侧负责“证明自己并持有令牌”，平台侧负责“签发、校验、授权与审计”，中间是令牌治理的四步核心链路。后续章节会逐层展开，但你现在就应该记住一个判断标准：任何一次设备API调用，如果无法回答“令牌从哪来、谁签的、能干什么、何时失效”，这条链路就是不可信的。

为了让学习不悬空，课程配套一个贯穿式实战项目：“智能园区设备API可信接入平台”。假设园区有3000台设备，包括门禁读头、摄像头、环境传感器和边缘网关，它们需要调用平台的四类API：设备注册、遥测上报、配置拉取、远程指令。项目要求实现设备身份注册、令牌签发与刷新、网关校验、按设备组授权、令牌吊销与调用审计。示例参数如下：access token有效期设为30分钟，refresh token有效期7天，采用JWT格式并以RS256签名，网关侧缓存公钥并校验exp、nbf、scope和device_id绑定关系。这些参数是教学示例，实际项目应根据安全等级和性能预算调整。