商户自有授权系统适配器示例

此 Python 3.10+ 示例实现 Launch 外部 HTTP 桥接，使用 SQLite 持久化事件和 nonce，并提供恢复工作进程。它不会生成许可证、验证受保护功能或替代你的授权系统。

实现提供以下钩子的 Python 模块：

def apply_snapshot(snapshot):
    # Call your licensing system with snapshot["event_id"] as its durable
    # idempotency key. Apply desired_state and the absolute purchased dates.
    # Return only after confirming the original operation was applied.
    # Raise ValueError for a result requiring manual review.
    ...

def delivery(snapshot):
    # Read an existing result owned by this purchase; do not issue here.
    return {"type": "instructions", "value": "Your own delivery instructions", "expires_at": None}

配置后端前，必须用真实接入实现替换 ...。如果没有配置后端模块，内置钩子会抛出 NotImplementedError；事件转入人工审核，绝不会声称已签发授权。示例工作进程可能在崩溃或结果不确定的错误后重试钩子，因此授权后端必须按同一事件 ID 去重和恢复结果。

通过环境变量配置适配器，密钥不得进入源码管理或命令历史：

• CUSTOM_LICENSING_KEY：32–128 个随机字节的标准 Base64 编码，必须与 Launch 一致。
• CUSTOM_LICENSING_KEY_ID：key-1，或你配置的密钥标识。
• CUSTOM_LICENSING_CONNECTION_REF：相匹配的连接引用。
• CUSTOM_LICENSING_ENVIRONMENT：sandbox 或 live。
• CUSTOM_LICENSING_DATABASE：源码目录之外私有且可写的 SQLite 路径；重启后仍须保留。
• CUSTOM_LICENSING_BACKEND：实现上述钩子、可导入的模块。
• CUSTOM_LICENSING_PORT：本地监听端口，默认 18883。

运行 python server.py。本地 sandbox 测试时，在 Launch 中配置 http://127.0.0.1:18883，并明确启用其回环 HTTP 例外。生产环境应使用 HTTPS 终止、进程监管、受保护的数据库备份，以及后端自身的 SDK 或运行时授权校验。只声明后端实际支持的购买和交付类型，相应调整 capabilities。

修复后端问题后，python server.py --retry-event ORIGINAL_EVENT_UUID 会在本地将原来保存的同一请求内容重新入队。还应在 Launch 的授权任务页重试原事件。不得通过更换 ID 或再次增加时长来恢复响应。

该示例只提供起点，不能作为生产验收证明。工作进程租约为 60 秒；钩子调用超时必须更短，或续租。接收正式购买前，应补齐监控、密钥轮换流程、更严格的业务与结构校验，以及部署所需的运维控制。接入指南和 OpenAPI 定义了协议。绝不能把 Launch 状态响应当作运行受保护代码的许可。