1FIDO_BIO_DEV_GET_INFO(3) BSD Library Functions Manual FIDO_BIO_DEV_GET_INFO(3)
2

NAME

4     fido_bio_dev_get_info, fido_bio_dev_enroll_begin,
5     fido_bio_dev_enroll_continue, fido_bio_dev_enroll_cancel,
6     fido_bio_dev_enroll_remove, fido_bio_dev_get_template_array,
7     fido_bio_dev_set_template_name — FIDO 2 biometric authenticator API
8

SYNOPSIS

10     #include <fido.h>
11     #include <fido/bio.h>
12
13     int
14     fido_bio_dev_get_info(fido_dev_t *dev, fido_bio_info_t *info);
15
16     int
17     fido_bio_dev_enroll_begin(fido_dev_t *dev, fido_bio_template_t *template,
18         fido_bio_enroll_t *enroll, uint32_t timeout_ms, const char *pin);
19
20     int
21     fido_bio_dev_enroll_continue(fido_dev_t *dev,
22         const fido_bio_template_t *template, fido_bio_enroll_t *enroll,
23         uint32_t timeout_ms);
24
25     int
26     fido_bio_dev_enroll_cancel(fido_dev_t *dev);
27
28     int
29     fido_bio_dev_enroll_remove(fido_dev_t *dev,
30         const fido_bio_template_t *template, const char *pin);
31
32     int
33     fido_bio_dev_get_template_array(fido_dev_t *dev,
34         fido_bio_template_array_t *template_array, const char *pin);
35
36     int
37     fido_bio_dev_set_template_name(fido_dev_t *dev,
38         const fido_bio_template_t *template, const char *pin);
39

DESCRIPTION

41     The functions described in this page allow biometric templates on a FIDO2
42     authenticator to be listed, created, removed, and customised.  Please
43     note that not all FIDO2 authenticators support biometric enrollment.  For
44     a description of the types involved, please refer to
45     fido_bio_info_new(3), fido_bio_enroll_new(3), and fido_bio_template(3).
46
47     The fido_bio_dev_get_info() function populates info with sensor informa‐
48     tion from dev.
49
50     The fido_bio_dev_enroll_begin() function initiates a biometric enrollment
51     on dev, instructing the authenticator to wait timeout_ms milliseconds.
52     On success, template and enroll will be populated with the newly created
53     template's information and enrollment status, respectively.
54
55     The fido_bio_dev_enroll_continue() function continues an ongoing enroll‐
56     ment on dev, instructing the authenticator to wait timeout_ms millisec‐
57     onds.  On success, enroll will be updated to reflect the status of the
58     biometric enrollment.
59
60     The fido_bio_dev_enroll_cancel() function cancels an ongoing enrollment
61     on dev.
62
63     The fido_bio_dev_enroll_remove() function removes template from dev.
64
65     The fido_bio_dev_get_template_array() function populates template_array
66     with the templates currently enrolled on dev.
67
68     The fido_bio_dev_set_template_name() function sets the friendly name of
69     template on dev.
70
71     The error codes returned by fido_bio_dev_get_info(),
72     fido_bio_dev_enroll_begin(), fido_bio_dev_enroll_continue(),
73     fido_bio_dev_enroll_cancel(), fido_bio_dev_enroll_remove(),
74     fido_bio_dev_get_template_array(), and fido_bio_dev_set_template_name()
75     are defined in <fido/err.h>.  On success, FIDO_OK is returned.
76

SEE ALSO

78     fido_bio_enroll_new(3), fido_bio_info_new(3), fido_bio_template(3)
79

CAVEATS

81     Biometric enrollment is a tentative feature of FIDO 2.1.  Applications
82     willing to strictly abide by FIDO 2.0 should refrain from using biometric
83     enrollment.  Applications using biometric enrollment should ensure it is
84     supported by the authenticator prior to using the API.  Since FIDO 2.1
85     hasn't been finalised, there is a chance the functionality and associated
86     data structures may change.
87
88BSD                           September 13, 2019                           BSD
Impressum