安全
当 Kotlin 读取端接收来自应用信任边界之外的字节时，请遵循本页说明。Fory 会重建应用值， 但不会验证发送者身份、保护传输完整性，也不会判断一个合法值是否获准用于某项业务操作。
应用边界
反序列化之前：
- 在传输层或存储层验证发送者身份并保护消息完整性。
- 在 Fory 外部限制请求或文件大小、超时时间和并发量。
- 只注册端点允许的应用类型，并在第一次根操作之前完成读取端配置。
- 使用反序列化结果之前，根据应用的授权规则和领域规则验证该值。
运行时保护
Kotlin 使用 Java 配置接口。在生产环境以及处理任何不可信载荷来源时，请保持启用类注册：
val fory = ForyKotlin.builder()
.requireClassRegistration(true)
.withMaxDepth(50)
.withMaxGraphMemoryBytes(128L * 1024 * 1024)
.withMaxUnbackedContainerItems(8192)
.withMaxTypeFields(512)
.withMaxTypeMetaBytes(4096)
.build()
与安全相关的配置：
- 保持
requireClassRegistration(true)，并注册应用类或生成的模块。 - 使用
withMaxDepth(...)拒绝深度异常的对象图。 - 使用
withMaxGraphMemoryBytes(...)为包含大量集合、map、数组、结构体和对象的载荷 设置近似限制。它不是精确的堆上限；叶子值受剩余输入字节限制。 - 除非可信的紧凑 codec 需要更大的根操作余量，否则将
withMaxUnbackedContainerItems(...)保持为8192。零会拒绝每一个无输入支撑的条目。 - 除非数据没有恶意，且可信对端会发送更大的元数据或许多 Schema 版本，否则请将
withMaxTypeFields(...)、withMaxTypeMetaBytes(...)和远端 Schema 版本限制保留为默认值。 - 白名单和未知类控制请遵循 Java 安全。
验证
除正常往返测试外，还应为边界添加负向测试。确认配置后的读取端会拒绝意外的应用类型、 过深的嵌套、超出资源限制的输入以及格式错误的输入。一次读取失败后，还应确认可复用运行时 仍能正确读取下一个合法根值。