YubiSwitch安装与配置指南

YubiSwitch安装与配置指南

yubiswitch OSX status bar application to enable/disable Yubikey Nano 项目地址: https://gitcode.com/gh_mirrors/yu/yubiswitch

1. 项目基础介绍

YubiSwitch 是一个开源的OSX状态栏应用程序，用于启用或禁用Yubikey Nano或Neo设备。它可以帮助用户避免在操作电脑时不小心触碰到Yubikey设备，导致意外的OTP密码发送。Yubikey是一种硬件认证设备，由Yubico公司生产，旨在为传统的用户名和密码提供更安全、易用的补充。

主要编程语言：该项目主要使用Objective-C编程语言。

2. 项目使用的关键技术和框架

• 状态栏应用：YubiSwitch通过在系统状态栏中添加一个图标，让用户能够快速访问和控制Yubikey设备。
• 全局快捷键：使用ShortcutRecorder库来实现全局快捷键功能，允许用户自定义快捷键来启用或禁用Yubikey。
• AppleScript支持：支持基本的AppleScript命令，如KeyOn和KeyOff，以允许用户通过脚本控制Yubikey。
• USB HID接口：使用USB HID接口与Yubikey设备进行通信。

3. 项目安装和配置的准备工作

准备工作

• 确保你的Mac操作系统版本为OSX 10.8或更高版本。
• 安装Xcode开发工具。
• 准备一个有效的Mac开发者账号，用于签名应用程序。

安装步骤

1. 克隆项目

   打开终端，使用以下命令克隆项目到本地：

   git clone https://github.com/pallotron/yubiswitch.git
   

2. 打开项目

   使用Xcode打开克隆到本地的yubiswitch.xcodeproj文件。

3. 编译项目

   在Xcode中，点击“Product”菜单，然后选择“Build”编译项目。

4. 安装Helper工具

   YubiSwitch需要安装一个Helper工具来获取USB HID接口的独占访问权。编译成功后，执行以下命令：

   sudo cp -R path/to/yubiswitch.app/Contents/MacOS/yubiswitch.helper /Library/PrivilegedHelper/
   

   替换path/to/yubiswitch.app为实际的.app文件路径。

5. 设置Helper权限

   打开“系统偏好设置”，进入“安全性与隐私”，然后在“隐私”选项卡下的“输入监控”中添加yubiswitch.helper。

6. 签名应用程序

   使用以下命令为yubiswitch.app和yubiswitch.helper签名：

   sudo codesign -s "Your Developer Name" -f /Library/PrivilegedHelper/yubiswitch.helper
   sudo codesign -s "Your Developer Name" -f path/to/yubiswitch.app
   

   替换Your Developer Name为你的开发者账号名称。

7. 运行应用程序

   双击编译后的yubiswitch.app运行程序。第一次运行时，系统会提示你输入密码以安装Helper。

8. 配置快捷键

   在应用程序的偏好设置中配置你想要的快捷键。

完成以上步骤后，你就可以使用YubiSwitch应用程序来控制你的Yubikey设备了。

yubiswitch OSX status bar application to enable/disable Yubikey Nano 项目地址: https://gitcode.com/gh_mirrors/yu/yubiswitch