# UKUI 生物识别认证

UKUI 桌面环境的生物识别认证框架，支持指纹、虹膜、面部识别等多种生物特征识别方式。

## 组件说明

| 组件 | 说明 |
|------|------|
| `bioauth` | 生物识别认证命令行工具 |
| `bioctl` | 生物识别认证控制工具 |
| `pam-biometric` | PAM 认证模块 |
| `polkit-agent` | PolicyKit 认证代理，支持生物识别 |
| `uniauth-backend` | 统一认证后端服务 |

## 构建依赖

```bash
sudo apt install cmake pkg-config \
    qt6-base-dev qt6-svg-dev qt6-tools-dev qt6-tools-dev-tools \
    libkf6windowsystem-dev libpolkit-qt6-1-dev \
    libglib2.0-dev libgsettings-qt6-dev \
    libopencv-dev libpam-dev libssl-dev \
    libkysdk-base-dev libkysdk-system-dev libkysdk-applications-dev \
    libukui-log4qt-dev libx11-dev
```

## 编译安装

```bash
mkdir build && cd build
cmake ..
make
sudo make install
```

## 使用方法

### bioctl — 开关控制

```bash
# 查看生物识别总开关状态
bioctl status

# 查看指定应用的开关状态
bioctl status greeter|screensaver|polkit|sudo|su|login

# 开启/关闭生物识别总开关
bioctl enable
bioctl disable

# 开启/关闭指定应用的生物识别
bioctl enable greeter|screensaver|polkit|sudo|su|login
bioctl disable greeter|screensaver|polkit|sudo|su|login
```

### bioauth — 认证工具

```bash
# 使用生物识别进行认证
bioauth --user <用户名> --device <设备>
```

## 配置文件

- `/etc/biometric-auth/ukui-biometric.conf` — 主配置文件
- `/usr/share/ukui-biometric/` — 资源文件目录

## 许可证

本项目基于 [GPL-3.0+](COPYING) 许可证发布。
