1FIDO_DEV_GET_ASSERT(3) BSD Library Functions Manual FIDO_DEV_GET_ASSERT(3)
2
4 fido_dev_get_assert — obtains an assertion from a FIDO2 device
5
7 #include <fido.h>
8
9 int
10 fido_dev_get_assert(fido_dev_t *dev, fido_assert_t *assert,
11 const char *pin);
12
14 The fido_dev_get_assert() function asks the FIDO2 device represented by
15 dev for an assertion according to the following parameters defined in
16 assert:
17
18 - relying party ID;
19 - client data hash;
20 - list of allowed credential IDs;
21 - user presence and user verification attributes.
22
23 See fido_assert_set_authdata(3) for information on how these values are
24 set.
25
26 If a PIN is not needed to authenticate the request against dev, then pin
27 may be NULL. Otherwise pin must point to a NUL-terminated UTF-8 string.
28
29 After a successful call to fido_dev_get_assert(), the
30 fido_assert_count(3), fido_assert_user_display_name(3),
31 fido_assert_user_icon(3), fido_assert_user_name(3),
32 fido_assert_authdata_ptr(3), fido_assert_user_id_ptr(3),
33 fido_assert_sig_ptr(3), and fido_assert_sigcount(3) functions may be in‐
34 voked on assert to retrieve the various attributes of the generated as‐
35 sertion.
36
37 Please note that fido_dev_get_assert() is synchronous and will block if
38 necessary.
39
41 The error codes returned by fido_dev_get_assert() are defined in
42 <fido/err.h>. On success, FIDO_OK is returned.
43
45 fido_assert_new(3), fido_assert_set_authdata(3)
46
47BSD May 24, 2018 BSD