Hiya

Linux를 위한 지문 인증. 단일 등록으로 sudo, su, polkit, 화면 잠금 해제, SSH 키, 브라우저 패스키를 처리합니다.

fprintd를 대체합니다. 별도 패치 없이 기존 DE와 함께 작동합니다.

요구 사항

• libfprint가 지원하는 지문 센서
• PAM, systemd, D-Bus가 있는 Linux
• TPM 2.0 선택 사항(등록 데이터 봉인에 사용)

설치

sudo ./install.sh install

빌드 의존성을 설치하고, 컴파일하고, PAM을 연결하고, 데몬을 시작합니다.

그런 다음 (root가 아닌 자신으로) 등록하세요:

hiya-enroll --finger 2 --label "right index"
hiya-verify
sudo -k && sudo whoami

손가락 번호: 1–5 = 왼손 엄지부터 새끼손가락, 6–10 = 오른손 엄지부터 새끼손가락.

제거

sudo ./install.sh uninstall

온칩 템플릿을 지우고 등록 데이터를 제거합니다. /var/lib/hiya/fido2/의 FIDO2 자격 증명과 SSH 키는 유지됩니다. 그것들까지 완전히 지우려면:

sudo rm -rf /var/lib/hiya

명령어

hiya-enroll --finger N --label "name"   손가락 하나 등록
hiya-enroll --list                       등록 목록 표시
hiya-enroll --delete --finger N          손가락 하나 삭제
hiya-enroll --delete-all                 모두 삭제
hiya-verify                              인증 테스트
hiya-cli                                 대화형 셸
sudo ./install.sh status                    데몬 상태

패치되는 항목

설치는 auth 줄이 있는 시스템의 모든 PAM 파일에 pam_hiya.so를 연결합니다. 제거 시 모든 백업을 복원합니다. PAM 줄은 default=ignore를 사용하므로 지문 인증 실패나 시간 초과는 항상 비밀번호로 넘어갑니다 — 로그인을 차단하지 않습니다.

지원 배포판

Fedora, RHEL, Ubuntu, Debian, Arch, openSUSE. 알 수 없는 배포판: 의존성을 수동으로 설치한 후 sudo ./install.sh를 실행하세요.

수동 빌드

meson setup build --prefix=/usr
ninja -C build
sudo ninja -C build install

의존성: meson ninja gcc libfprint-2 glib2 dbus pam mbedtls libcurl systemd

보안

SECURITY.md를 참조하세요.