Laravel+Livewire对接Iclock 880-考勤设备：通信密钥缺失致无数据

问题背景 #

在Laravel+Livewire项目中对接ZK Iclock 880考勤设备时，使用MehediJaman\LaravelZkteco库可以成功建立连接，但由于该库不支持设备必需的comm-key（通信密钥），无法获取用户数据。而通过ZK官方程序使用IP、通信密钥和端口可以正常获取数据。

当前使用的代码：

public function get_user($deviceId) { 
    $this->get_user_modal = true; 
    $device = DeviceModel::find($deviceId); 
    if ($device) { 
        try { 
            $connection = new LaravelZkteco($device->ip, $device->port); 
            if ($connection->connect()) { 
                $this->user_list = $connection->getUser(); 
            } else { 
                $this->alert('error', 'Error connecting to the device!'); 
            } 
        } catch (\Exception $e) { 
            $this->alert('error', 'Error retrieving users from the device!'); 
        } 
    } 
}

解决方案 #

方案1：扩展现有库添加Comm-Key支持 #

MehediJaman\LaravelZkteco底层基于ZK设备的PHP通信库，你可以修改该库的代码，在连接后加入密钥验证逻辑：

1. 修改LaravelZkteco类的构造函数，新增comm-key参数：

public function __construct($ip, $port = 4370, $commKey = null)
{
    $this->ip = $ip;
    $this->port = $port;
    $this->commKey = $commKey;
}

2. 修改connect方法，在连接成功后发送密钥验证指令：

public function connect()
{
    $this->zk = new ZKLib($this->ip, $this->port);
    $connected = $this->zk->connect();
    
    // 连接成功且存在comm-key时，执行密钥验证
    if ($connected && !empty($this->commKey)) {
        // 发送CMD_AUTH指令（指令码需参考ZK官方协议，通常为0x0F）
        // 若密钥是十六进制格式，用pack转换；明文则直接传入
        $authResponse = $this->zk->sendCmd(0x0F, pack('H*', $this->commKey));
        if (!$authResponse) {
            $connected = false;
        }
    }
    
    return $connected;
}

3. 更新你的业务代码，传入comm-key：

$connection = new LaravelZkteco($device->ip, $device->port, $device->comm_key);

方案2：更换原生支持Comm-Key的ZK库 #

使用原生支持通信密钥的ZK设备PHP库，示例代码如下：

public function get_user($deviceId) { 
    $this->get_user_modal = true; 
    $device = DeviceModel::find($deviceId); 
    if ($device) { 
        try { 
            $zk = new ZKLib($device->ip, $device->port);
            $zk->setCommKey($device->comm_key); // 设置通信密钥
            if ($zk->connect()) { 
                $this->user_list = $zk->getUser(); 
                $zk->disconnect();
            } else { 
                $this->alert('error', 'Error connecting to the device!'); 
            } 
        } catch (\Exception $e) { 
            $this->alert('error', 'Error retrieving users from the device! ' . $e->getMessage()); 
        } 
    } 
}

方案3：参考ZK官方协议自行实现密钥验证 #

如果上述方案都不适用，可以查阅ZK官方的设备通信协议文档，在连接后手动发送密钥验证指令。核心逻辑是：

• 连接设备成功后，发送CMD_AUTH指令包，携带你的comm-key（注意格式：明文或十六进制，需与设备设置一致）
• 等待设备返回授权成功的响应后，再执行获取用户数据的指令

注意事项 #

• 确保设备端设置的comm-key与代码中传入的完全一致，注意区分明文和十六进制格式
• 调试时可以抓包对比ZK官方工具与你的代码发送的数据包，确保指令和数据格式匹配

内容的提问来源于stack exchange，提问作者Najibullah Jafari