门禁硬件
按品牌分级
「已支持」指能做的事都写在下面，限制同样写在下面；「规划中」指代码尚未实现，不承诺时间。没有列出的品牌需要技术评估。
微耕门禁控制器已支持
微耕 v6.56 及以上的控制器，经现场 Edge Agent 接入。新建设备时目前只能选择这一类。
能做的
- 远程开门
- 常开，以及恢复在线控制
- 设置开门延时
- 在线检测与离线告警
- 刷卡、扫码上报后由系统判权并下发开门指令，每次都写入通行日志
- 门磁状态上报与门长时间未关告警
限制
- 授权与可通行时段不写入控制器，判权在系统侧完成。Edge Agent 或网络中断期间，经系统判权的刷卡、扫码开门无法完成。
- 不支持向控制器校时。
- 控制器协议本身没有认证，接收上报的端口只能对控制器所在网段开放，不能暴露到公网。
海康终端部分支持
海康终端扫到二维码后，通过 HTTP 把它发给系统做远程校验；系统判权后在应答里告诉终端是否放行，开闸由海康终端自己完成。每次校验都写入通行日志。
能做的
- 二维码远程校验与放行答复
- 校验结果写入通行日志
限制
- 目前只识别已对接的高校统一身份认证二维码，只在启用了这项识别的特定部署中可用，自助注册开通的租户暂不可用。
- 系统只处理二维码；终端发来的刷卡、刷脸等校验一律答复不放行，也不留下记录。
- 不能从系统远程开门、不能查询门状态，也没有离线告警。
- 新版工作台不能新建海康设备。
大华规划中
代码尚未实现。
通通锁规划中
代码尚未实现。
身份数据
人员从哪里来
同步来的人在系统里只读：不改名、不删除、不重置密码，避免和源系统打架。下面是目前已经实现的来源，以及还没有的。
- 高校人员库导入
- 只读连接机构人员库的一个视图，导入姓名、学工号、统一身份账号、邮箱、身份类型与手机号；每天定时执行，也可以由管理员手动触发。可以选择停用已离开的人员，并有多道护栏，一轮里停用人数异常时整轮不停用。只导入人员，不导入组织结构与角色组。属于针对已对接高校的集成，需要先为该机构开通。
- 高校统一身份认证登录
- 同属该高校集成，开通后由各租户在登录设置里自行启用：用户在机构的统一身份认证页完成登录后进入工作台，可选首次登录自动建号（默认关闭）。用户名密码登录始终保留。
- 上游平台同步
- 系统作为现场节点绑定到上游云平台时，由上游推送区域、房间、角色组与成员关系。只在绑定了上游平台的特定部署中可用。
- Excel 名单导入
- 课题组年度名单可导入为角色组，办公室坐席成员可从 Excel 导入；都是先预览、再确认。
- 系统内录入
- 没有对接身份数据源时，管理员可以在系统内录入人员；外部人员单独登记，带负责人与有效期。
- 尚未实现
- LDAP、企业通讯录与通用的身份平台 / 人事系统同步目前没有现成实现，单点登录也只对接了一种高校统一身份认证。需要对接其他身份来源时，请在技术评估中提出。
开放接口
给业务系统用的开放接口
开放接口走独立的认证域，凭证不绑定任何人，权限与数据范围在每次请求时实时校验。
凭证与权限
管理员在系统设置里为每个对接方签发独立凭证。每把凭证按细分权限授权（例如只读空间、读写授权、远程开门分别勾选），数据范围可以是整个机构，也可以只限指定区域和房间；可选有效期与 IP 白名单，并按凭证限流。
能读什么
区域、房间、门、人员、通行记录、授权与角色组。
能写什么
授予与撤销授权、维护角色组及其房间与成员，以及远程开门。远程开门需要单独授予。
事件回调
通行记录产生、设备离线与上线、门长时间未关四类事件可以回调到对接方地址，回调带 HMAC-SHA256 签名，失败会重试。
MCP
让 AI 助手按某个人的权限办事
它是什么
一个 MCP（Model Context Protocol）服务端，让机构自己使用的 AI 助手通过标准协议访问门禁授权数据。
以谁的身份
每把 MCP 密钥绑定系统里的一个人，调用时完全按这个人的权限与管理范围执行，并且每次实时校验。密钥由管理员在系统设置里签发、轮换与停用。
能做什么
查人员、房间、某人或某个房间的授权、检查某人能否进某扇门、查通行记录；也能发放与撤销授权，范围同样受这个人的管理范围限制。
- 现有控制器的品牌、型号与固件版本，目前是否在用、由谁维护。
- 控制器和服务器在不在同一个网络；跨网时，现场能否放一台机器运行 Edge Agent。
- 人员身份从哪里来：已有的人员库、统一身份认证，还是需要在系统内录入。
- 现在用什么凭证开门：卡、二维码，还是两者都有。
- 现有的授权规则与审批流程：哪些门由谁负责，哪些门需要额外复核。
- 倾向 SaaS 还是私有化部署，数据存放有什么要求。
- 门的大致规模，是否打算分楼宇或分院系分期接入。
常见问题
关于接入与兼容
- 今约锁支持哪些门禁控制器？
- 目前已支持微耕 v6.56 及以上的门禁控制器，经现场 Edge Agent 接入，可远程开门、常开、设置开门延时、在线检测与离线告警，刷卡与扫码由系统判权后开门。海康终端部分支持二维码远程校验。大华、通通锁在规划中，代码尚未实现。
- 海康门禁能对接今约锁吗？
- 部分支持。海康终端可以把扫到的二维码通过 HTTP 发给系统做远程校验，系统判权后答复是否放行，开闸由海康终端完成。目前只识别已对接的高校统一身份认证二维码、只在特定部署中可用；刷卡和刷脸不由系统校验，系统也不能远程开门或查询门状态。
- 现有门禁能不换设备直接接入吗？
- 不能一概而论。能否复用现有设备取决于控制器的品牌、型号与网络条件，需要技术评估后才能确定。建议预约场景演示，带上控制器型号与现场网络情况一起确认。
- 今约锁能对接哪些身份平台？
- 目前已实现的是已对接高校的人员库只读导入、按租户启用的高校统一身份认证登录，以及绑定上游平台时的区域、房间与角色组同步；另有 Excel 名单导入与系统内录入。LDAP、企业通讯录与通用身份平台同步尚未实现。
- 今约锁有开放接口吗？
- 有。业务系统可以用管理员签发的独立凭证访问开放接口，按细分权限与数据范围读写空间、门、人员、通行记录、授权与角色组，也可以订阅通行与设备事件回调。对接前请预约技术评估确认接口范围。
相关页面