Fingerprint scanner: Difference between revisions

TNTima (talk | contribs)
m added semicolons
Frontear (talk | contribs)
don't encourage enabling fprintd service at boot, this goes against upstream wishes and can lead to possible hardware damage, as many fingerprint scanners are not intended to remain "active" for a long time. it is more appropriate for the service to activate via dbus when it is needed, to greatly reduce this risk.
 
(5 intermediate revisions by 5 users not shown)
Line 3: Line 3:
== Install ==
== Install ==
<syntaxhighlight lang="nixos">
<syntaxhighlight lang="nixos">
# Start the driver at boot
# configuration.nix
systemd.services.fprintd = {
{ config, lib, pkgs, ... }: {
   wantedBy = [ "multi-user.target" ];
   # ...
  serviceConfig.Type = "simple";
};


# Install the driver
  # Install the driver
services.fprintd.enable = true;
  services.fprintd.enable = true;
# If simply enabling fprintd is not enough, try enabling fprintd.tod...
  # If simply enabling fprintd is not enough, try enabling fprintd.tod...
services.fprintd.tod.enable = true;
  services.fprintd.tod.enable = true;
# ...and use one of the next four drivers
  # ...and use one of the next four drivers
services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix; # Goodix driver module
  services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix; # Goodix driver module
# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-elan; # Elan(04f3:0c4b) driver
  # services.fprintd.tod.driver = pkgs.libfprint-2-tod1-elan; # Elan(04f3:0c4b) driver
# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-vfs0090; # driver for 2016 ThinkPads
  # services.fprintd.tod.driver = pkgs.libfprint-2-tod1-vfs0090; # (Marked as broken as of 2025/04/23!) driver for 2016 ThinkPads
# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)
  # services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)


  # however for focaltech 2808:a658, use fprintd with overidden package (without tod)
  # services.fprintd.package = pkgs.fprintd.override {
  #  libfprint = pkgs.libfprint-focaltech-2808-a658;
  # };
}
</syntaxhighlight>
</syntaxhighlight>


Line 25: Line 28:


=== CLI ===
=== CLI ===
<syntaxhighlight lang="bash">$ sudo fprintd-enroll</syntaxhighlight>
<syntaxhighlight lang="bash">$ fprintd-enroll</syntaxhighlight>


=== Gnome ===
=== Gnome ===
Line 40: Line 43:
security.pam.services.login.fprintAuth = false;
security.pam.services.login.fprintAuth = false;
security.pam.services.gdm-fingerprint = lib.mkIf (config.services.fprintd.enable) {
security.pam.services.gdm-fingerprint = lib.mkIf (config.services.fprintd.enable) {
      text = ''
  text = ''
        auth      required                    pam_shells.so
    auth      required                    pam_shells.so
        auth      requisite                  pam_nologin.so
    auth      requisite                  pam_nologin.so
        auth      requisite                  pam_faillock.so      preauth
    auth      requisite                  pam_faillock.so      preauth
        auth      required                    ${pkgs.fprintd}/lib/security/pam_fprintd.so
    auth      required                    ${pkgs.fprintd}/lib/security/pam_fprintd.so
        auth      optional                    pam_permit.so
    auth      optional                    pam_permit.so
        auth      required                    pam_env.so
    auth      required                    pam_env.so
        auth      [success=ok default=1]      ${pkgs.gnome.gdm}/lib/security/pam_gdm.so
    auth      [success=ok default=1]      ${pkgs.gdm}/lib/security/pam_gdm.so
        auth      optional                    ${pkgs.gnome.gnome-keyring}/lib/security/pam_gnome_keyring.so
    auth      optional                    ${pkgs.gnome-keyring}/lib/security/pam_gnome_keyring.so


        account    include                    login
    account    include                    login


        password  required                    pam_deny.so
    password  required                    pam_deny.so


        session    include                    login
    session    include                    login
        session    optional                    ${pkgs.gnome.gnome-keyring}/lib/security/pam_gnome_keyring.so auto_start
    session    optional                    ${pkgs.gnome-keyring}/lib/security/pam_gnome_keyring.so auto_start
      '';
  '';
    };
};
};


</syntaxhighlight>
</syntaxhighlight>
[[Category:Hardware]]
[[Category:Hardware]]