tree: 5137fd32670d7ff2ffcce6181013587eefa2d208 [path history] [tgz]
  1. dbus/
  2. fpc/
  3. init/
  4. tools/
  5. udev/
  6. bio_algorithm.h
  8. bio_library.h
  9. biod.gyp
  11. biod_storage.h
  14. biometrics_daemon.h
  15. biometrics_manager.h
  17. fake_biometrics_manager.h
  18. fake_biometrics_manager_common.h
  20. fpc_biometrics_manager.h
  22. OWNERS
  25. scoped_umask.h

Biod: Biometrics Daemon


Biod (Biometrics Daemon) is a daemon for enrolling, authenticating and managing biometrics data for faster unlocking. It manages all biometric sensors for all users of the device.


Record - a specific piece of biometric data that a user registers along with its metadata.

Enroll - the act of registering a record.

EnrollSession - the session during which enrolling of a record happens.

Authenticate - the act of checking a new piece of biometric data against stored records.

AuthSession - the session during which authenticating a new piece of biometric data against stored records happens.

BiometricsManager - manager for a piece of device/hardware/sensor for collecting a specific type of biometric data. Each BiometricsManager is in charge of storing the records that it enrolled.


The records are stored under the directory: /home/root/[hash_of_user_id]/biod/[name_of_biometrics_manager]/ with the file name: Record[UUID].

UUID has the form of XXXXXXXX_XXXX_XXXX_XXXX_XXXXXXXXXXXX where X represents a lowercase hex digit. UUID is a 128-bit random number generated with guid, so it will highly unlikely repeat. ‘_’ are used instead of ‘-’ because this UUID is used in biod D-bus object paths, which do not allow ‘-’.

Each record file is stored in JSON format, and contains one record and its record id and label.



FakeBiometric is the biometrics manager for a fake sensor which simulates a real biometric sensor and its interaction with biod. It is used to test biod.


FpcBiometric is the biometrics manager for a real sensor and has its own algorithms library (called for building, serializing, updating and matching records. is provided by the hardware vendor and dynamically loaded at runtime.


Biod communicates with Chrome via D-bus messages. Chrome provides the graphical interface for users to enroll new biometric data and manage their own records. Chrome is also responsible for the visual display during authentication.


When a user logs in or biod starts, biod will ask login manager for a list of currently logged-in users, and load from storage the records of the newly logged-in users.

When a user logs out, all users log out at the same time, biod receives a signal from login manager and remove all records in the memory.


Because the records are stored in per user stateful under /home/root/ [hash_of_user_id], they are naturally encrypted by cryptohome. Records are encrypted when the users log out and decrypted when the users log in. Cryptohome provides a layer of security to biod.



fake_biometric_tool provides the interface for users to send D-bus messages as FakeBiometric to fake the behavior of a biometric sensor. It can be used to test the behavior of biod.


biod_client_tool provides the interface to fake the behavior of a biometrics client, for example, a lock screen or a biometric enrollment app. It can be used to test biod and biometric sensors.