用途:为 Knack API 提供安全鉴权,支持服务端 API Key 认证与面向具体用户的令牌认证,并管理会话创建、令牌刷新和凭证校验。
主要能力:API Key 认证使用请求头 X-Knack-Application-Id 与 X-Knack-REST-API-Key,具有全部对象的读写权限,适用于后端操作、自动报表和数据同步。用户令牌认证使用 X-Knack-Application-Id 与 Authorization 请求头,适用于带用户级权限的仪表板视图。核心函数包括 login_user(POST /v1/applications/{app_id}/session,提交 email 与 password,从响应 session.user.token 获取令牌)、refresh_token(用户令牌 24 小时过期,监控令牌有效期并在过期前自动刷新并安全存储)和 validate_credentials(在操作前校验 app_id 与 api_key)。
使用方式:通过 .env 配置 KNACK_APP_ID、KNACK_API_KEY、ADMIN_EMAIL、ADMIN_PASSWORD 等环境变量;该技能为 knack_reader 提供认证头,为 knack_realtime 维护 webhook 用户会话,为 knack_reporting_sync 提供管理员级访问,并配合 knack_devops 在 CI/CD 中轮换凭证。错误处理可区分 401(凭证无效)与 429(触发限流,延迟重试)。
适用场景:需要按角色区分权限的 Knack 集成,如管理员完整读写、志愿者只读培训材料与活动签到、公共仪表板仅用 API Key 且不返回用户专属数据。
限制与注意:切勿将凭证提交到版本控制,密钥应通过环境变量管理并按季度轮换;用户令牌有效期限制在 24 小时,需记录鉴权失败以形成审计线索。资料未提供具体安装命令、依赖要求、收费信息及更多实现细节。