mirror of
https://github.com/hpd840321/craftlabs-authorization-sdk.git
synced 2026-06-09 10:00:30 +08:00
huangping
f94f03bcc2
Add craftlabs-auth-config.schema.json, Java AuthConfigs model with tests, example configs aligned to BP-10, C/Java/auth-config documentation, native header notes, RELEASING guide, and workflow to verify SDK artifact checksums on release tags. Made-with: Cursor
1.6 KiB
1.6 KiB
initialize(config_json) 配置说明
AuthProvider.initialize(String) 与 C API auth_initialize(const char* config_json) 共用同一 JSON 语义，版本由 schemaVersion: 1 锁定。
规范与示例
| 资源 | 路径 |
|---|---|
| JSON Schema | schemas/craftlabs-auth-config.schema.json |
| 码头 / 集团拓扑示例 | examples/config/wharf.bitanswer.json |
| 学校 / 边设备示例 | examples/config/school.bitanswer.json |
| 流动人口 / 项目示例 | examples/config/floating.bitanswer.json |
| 学校 / 自研 HTTP 示例 | examples/config/school.selfhosted.json |
Java 解析与校验
import cn.craftlabs.auth.config.AuthConfig;
import cn.craftlabs.auth.config.AuthConfigException;
import cn.craftlabs.auth.config.AuthConfigs;
AuthConfig cfg = AuthConfigs.parse(jsonString);
// 再交给实现（与校验使用同一字符串即可）
provider.initialize(jsonString);
AuthConfig 提供 bitanswerFeatureId(String logicalKey) 等辅助方法，供后续在 hasFeature 与比特 QueryFeature 之间做映射。
场景字段摘要
- wharf：
wharf.topology（cloud/group/local_float）等与集中授权拓扑相关的提示；实际连网方式仍以bitanswer.url为准。 - school：
school.edgeDeviceId等用于运营对账；是否写入比特自定义字段由实现阶段决定。 - floating：必填
floating.projectId；表达「按项目」授权锚点，与商务合同、控制台业务模板需一致。
后续优化（错误码、OIDC、集团占点策略等）在保持 schemaVersion 或递增版本的前提下扩展字段即可。