HID Linq Key Manager 使用指南
简介
本文档介绍了如何安装和使用 HID® Linq™ Key Manager 来管理存储在本地密钥库中的自定义密钥，这些密钥用于 HID M1 Key Module。目标受众为系统管理员和设备管理员，他们需要使用 Windows 11 的 HID Linq Key Manager 命令行工具来安装、配置和管理自定义凭证密钥集。
概述
HID Linq Key Manager 允许用户设置和管理数据库和密钥库，并准备 Key Module 以便与 HID M1 系统一起使用。Key Module 配对密钥可以加载到 Key Module 和主节点之间进行密码学绑定，确保 Key Module 不能与其他主节点重复使用。
系统要求
- Windows 11 64 位企业版 21H22 或更高版本
- 8 GB RAM
- 20 GB 可用磁盘空间
- USB 端口（类型 A 或类型 C）
- 带有公制 USB-C 连接器的 USB 线缆，用于连接 Key Module
命令语法
HID Linq Key Manager 命令的结构如下：
LinqKeyManager.exe <命令> [子命令] [选项]
<命令>：要执行的主要操作类别（例如，keystore）。[子命令]：与主要命令相关的特定操作（例如，create-local）。[选项]：修改命令行为。
选项通常以 --（全名）或 -（短名）为前缀，值紧跟在选项名称之后。
下载和安装 HID Linq Key Manager
- 从 HID 开发者门户下载 LinqKeyManager.exe。
- 在计算机上创建一个新文件夹，专门用于此工具。
- 将下载的 LinqKeyManager.exe 文件移动到新文件夹。
创建主节点配对密钥文件
主节点配对密钥是一个对称加密密钥，它在硬件级别上安全地绑定 Key Module 和指定的主节点。要建立 Key Module 和主节点之间的安全配对：
- 将配对密钥以十六进制格式保存在一个 .bin 文件中。
- 使用 HID Linq Key Manager 将配对密钥注入 Key Module。
- 在系统配置期间，通过主节点的管理员用户界面加载相同的密钥文件。
命令行操作
管理MIFARE DESFire密钥和密钥模块
本节涵盖了创建自定义 MIFARE DESFire 密钥集并将其注入 Key Module 的典型端到端流程。
启动命令行界面
- 打开命令提示符。
- 使用
cd 命令导航到 LinqKeyManager.exe 文件所在的目录。
- 输入
LinqKeyManager.exe 并按 Enter 键启动 HID Linq Key Manager。
创建应用程序数据库
- 打开命令提示符。
- 输入
LinqKeyManager.exe create-database 并按 Enter 键。
创建本地密钥库
- 打开命令提示符。
- 输入
LinqKeyManager.exe keystore create-local -i 并按 Enter 键。
- 按照工具提示提供所需信息，包括密钥库名称和密码。
添加密钥到本地密钥库
- 打开命令提示符。
- 输入
LinqKeyManager.exe keystore add-local-key -i 并按 Enter 键。
- 按照工具提示提供所需信息，包括密钥库、密钥名称、密钥值和密码。
创建 MIFARE DESFire 密钥集
- 打开命令提示符。
- 输入
LinqKeyManager.exe keyset create-desfire -i 并按 Enter 键。
- 按照工具提示提供所需信息，包括密钥集名称、密钥库和 MIFARE DESFire 密钥。
创建 SNMP 密钥集
- 打开命令提示符。
- 输入
LinqKeyManager.exe keyset create-snmp -i 并按 Enter 键。
- 按照工具提示提供所需信息，包括密钥集名称、SNMP 认证密钥和 SNMP 隐私密钥。
创建 Key Module 配置
- 打开命令提示符。
- 输入
LinqKeyManager.exe configuration create --name <your_config_name> 并按 Enter 键。
- 按照工具提示提供所需信息，包括配置名称、配置选项等。
从 Key Module 移除配置
- 打开命令提示符。
- 输入
LinqKeyManager.exe key-module remove-configuration -i 并按 Enter 键。
- 按照工具提示提供所需信息，包括密钥模块名称和要移除的配置名称。
Onboard the HID M1 Key Module
- 将 HID M1 Key Module 连接到计算机的 USB 端口。
- 打开命令提示符。
- 输入
LinqKeyManager.exe key-module onboard -i 并按 Enter 键。
- 按照工具提示提供所需信息，包括串行端口、Key Module 名称、SNMP 密钥集和密钥库密码。
- 输入
LinqKeyManager.exe advanced configure-pairing-key 并按 Enter 键。
命令参考
本节提供了 HID Linq Key Manager 的可用命令参考，包括 create-database、keystore、keyset、configuration 和 key-module 等命令。
故障排除
本节介绍了如何解决 HID Linq Key Manager 使用过程中可能遇到的问题，并建议检查日志文件以获取更多信息。
安全最佳实践
- 使用强密码并妥善保管。
- 在导入到 HID Linq Key Manager 之前，安全地管理原始 MIFARE DESFire 密钥值。
- 定期备份应用程序数据库文件。
- 保障运行 HID Linq Key Manager 的计算机和 Key Module 的物理安全。
- 考虑使用隔离系统来进一步增强安全性。
PLT-08195, Rev. A.0December 2025
Copyright
© 2025 HID Global Corporation/ASSA ABLOY AB. All rights reserved.
This document may not be reproduced, disseminated, or republished in any form without the prior written permission of
Trademarks
HID GLOBAL, HID, the HID Brick logo, Seos, and HID Linq are trademarks or registered trademarks of HID Global, ASSAABLOY AB, or its affiliate(s) in the US and other countries and may not be used without permission. All other trademarks,
MIFARE, MIFARE Classic, MIFARE DESFire, MIFARE DESFire EV1, MIFARE Plus, and MIFARE Ultralight are registeredtrademarks of NXP B.V. and are used under license.
Contacts
For technical support, please visit:https://support.hidglobal.com.
What's new
Introduction
1.1 Document purpose61.2 Intended audience61.3 Overview61.4 System requirements71.5 Understanding Command Syntax7
1.6.1 Quoting paths81.6.2 Execute a command81.6.3 Command history8
Download and install HID Linq Key Manager
2.1 Download and install HID Linq Key Manager2.2 Update HID Linq Key Manager
1010
Create Main Node Pairing Key file11
3.1 Main Node Pairing Key123.2 Create Main Node Pairing Key file12
Command line actions
4.1 Managing MIFARE DESFire keys and Key Modules4.1.1 Launch the command line interface4.1.2 Create the application database4.1.3 Create a local keystore4.1.4 Add keys to the local keystore4.1.5 Create a MIFARE DESFire keyset4.1.6 Create an SNMP keyset
Command reference
5.1 General help215.2 keystore list225.3 Keyset255.4 Configuration27
Troubleshooting
6.1 Troubleshooting326.2 Check log files32
Security best practices
A.1 Keystore passwordsA.2 Key managementA.3 Database backupA.4 Physical security
Section01Introduction
1.1 Document purpose
This document provides information on how to install and use HID® Linq™ Key Manager to manage custom keys storedin a local keystore, for use with the HID M1 Key Module.
1.2 Intended audience
This document is intended for System Administrators and Device Administrators to install, configure and managecustom credential keysets with the HID Linq Key Manager command-line tool for Windows 11.
1.3 Overview
HID Linq Key Manager allows you to setup and manage databases and keystores and prepare your Key Module for usewith the HID M1 system. A Key Module Pairing Key can be loaded to cryptographically bind the Key Module and Main
1.4 System requirements
lWindows 11 64-bit Enterprise Edition 21H22 or newerl8 GB RAMl20 GB available disk spacelUSB port (type A or type C)lUSB cable with a male USB-C connector for Key Module connection.
1.5 Understanding Command Syntax
HID Linq Key Manager commands are structured to specify the main program, the primary action (command), a
General Command Structure
LinqKeyManager.exe [sub-command] [options]
lLinqKeyManager.exe- the executable filename.l- the main category of action to be performed (for example,keystore). Replace with acommand from theCommand reference.
[sub-command]- a specific action related to the main command (for example,create-localfor the keystore
[options]- this modifies the command behavior.
oOptions are typically prefixed with--for full names or-for short names (for example,-- nameor-n).oOptions values follow the option name (for example,--name MyKeystore).
1.5.1 Syntax placeholders
The syntax placeholders in angled brackets (for example,,,) throughoutthe document represent the data that you must provide. Replace the brackets and placeholder in the syntax string. For
LinqKeyManager.exe keystore create-local --name--passwordBecomes:
LinqKeyManager.exe keystore create-local --nameMyDeviceKeys--password Secure123!
1.6 Syntax conventions
1.6.1 Quoting paths
Enclose file paths or names with spaces in quotation marks. For example:
l"C:\My Tools\LinqKeyManager"lLinqKeyManager.exe configuration create --name "My DESFire Config"
Note:It is recommended to use an underscore (_) instead of a space. This avoids the need to enclose file paths inquotation marks.
1.6.2 Execute a command
1.Open the Command Prompt window.
2.TypeLinqKeyManager.exefollowed by the required command, sub command, and options if applicable.
3.PressEnter.
1.6.3 Command history
Press theUpandDownarrows on your keyboard to cycle through previously entered commands and pressEnterto
1.6.4 Interactive mode (-i)
HID Linq Key Manager gives guidance and provides input for the required prompts when the-icommand is used at the
Section02Download and install HID Linq Key Manager
2.1 Download and install HID Linq Key Manager
1.DownloadLinqKeyManager.exefrom theHID Developer Portal.
2.Create a new folder on your computer specifically for this tool.
Note:Avoid using spaces in the folder path to simplify command-line navigation. For example,C:\Users\YourUserName\Desktop\LinqKeyManager
3.Move the downloadedLinqKeyManager.exefile to the new folder.
2.2 Update HID Linq Key Mana
