User Identification Manager

D-Bus service for identifying users from external sources in an automotive setting.

A D-Bus signal, UserIdentified, is emitted when a user is identified. See the D-Bus interface for details.

Dependencies

• gdbus-codegen-glibmm
• glibmm (2.56)
• googletest (1.8.1, for tests, optional)
• pcsc-lite (1.8.22, if built with smart card, SCARD, id source)

Building

Meson is used for building. To build simply run:

meson build
ninja -C build

Installing and Running

After building, installation can be performed by running:

sudo ninja -C build install

By default this will install under /usr/local. To change this pass --prefix when invoking meson or meson configure, e.g. meson build --prefix=/usr.

systemctl daemon-reload must be run for systemd to notice the newly installed service file. The service will now start when a D-Bus call is made to it on the system bus. It can also be started manually by running systemctl start user-identification-manager.

It is possible to run the daemon directly from the build directory and on the session bus, which might facilitate testing and debugging during development. To do this run:

export DBUS_SYSTEM_BUS_ADDRESS=$DBUS_SESSION_BUS_ADDRESS

And then run the built daemon executable directly from the build directory.

Running Tests

Tests can be run with:

meson test -C build

"No tests defined." is printed if the required version of googletest could not be found.

Code Checking

Clang-Format and Clang-Tidy are used for code style checking and "linting". Clang's static analyzer checks are run as part of Clang-Tidy as well. A script exists to simplify running these tools. After building, simply run:

tools/check . build

Note that different versions of clang-format and clang-tidy may give different results. See tools/ci/Dockerfile for what versions are run in the CI system.

The CI system also makes sure that the code compiles without any warnings. To turn warnings into errors when building locally, pass -Dwerror=true when invoking meson or meson configure.

Identification Sources

What sources to include in the daemon can be changed with build options. For example, to disable the mass storage device source run meson build -Dmsd_id_source=false when building. When the daemon starts it reads what sources to enable/disable from a configuration file. All sources included when building are enabled by default.

Mass Storage Device Source (MSD)

Reads identification data from a file called pelux-user-id in the root of a mass storage device, e.g. a USB stick. Meant to be used for demonstration and testing purposes. The file must be formated as follows (replace <X> with actual values):

ID <numeric string>
SEAT <hex value between 0x0 and 0xffff, must start with 0x>

Smart Card Source (SCARD)

Extract identification from smart cards. Currently only extracts the UID (unique identifier) from contactless smart cards that is then used as a means to identify a user.

Configuration

The daemon reads configuration from /etc/user-identification-manager.conf. A default configuration will be used if the file does not exist. Another path can be used by passing the -c/--config argument to the daemon.

Content that corresponds to default configuration with comments explaining the variables:

[sources]
# Comma separated list of sources to enable. Empty means all.
enable=

Command Line Interface

uimcli is a command line tool that can be used to debug and monitor the User Identification Manager daemon. Help summary:

$ uimcli -h
Usage:
  uimcli [OPTION…]

Help Options:
  -h, --help                 Show help options

Application Options:
  --version                  Print version and exit
  -i, --identified-users     Print users identified since start of daemon (max 20)
  -s, --sources              Print enabled and disabled identification sources
  -m, --monitor              Monitor user identification events

License and Copyright

Copyright © 2019 Luxoft Sweden AB

The source code in this repository is subject to the terms of the MPL-2.0 license, please see included "LICENSE" file for details. License information for any other files is either explicitly stated or defaults to the MPL-2.0 license.