1FIDO_DEV_MAKE_CRED(3) BSD Library Functions Manual FIDO_DEV_MAKE_CRED(3)
2
4 fido_dev_make_cred — generates a new credential on a FIDO2 device
5
7 #include <fido.h>
8
9 int
10 fido_dev_make_cred(fido_dev_t *dev, fido_cred_t *cred, const char *pin);
11
13 The fido_dev_make_cred() function asks the FIDO2 device represented by
14 dev to generate a new credential according to the following parameters
15 defined in cred:
16
17 - type;
18 - client data hash;
19 - relying party;
20 - user attributes;
21 - list of excluded credential IDs;
22 - resident/discoverable key and user verification attributes.
23
24 See fido_cred_set_authdata(3) for information on how these values are
25 set.
26
27 If a PIN is not needed to authenticate the request against dev, then pin
28 may be NULL. Otherwise pin must point to a NUL-terminated UTF-8 string.
29
30 After a successful call to fido_dev_make_cred(), the
31 fido_cred_authdata_ptr(3), fido_cred_pubkey_ptr(3), fido_cred_x5c_ptr(3),
32 and fido_cred_sig_ptr(3) functions may be invoked on cred to retrieve the
33 various parts of the generated credential.
34
35 Please note that fido_dev_make_cred() is synchronous and will block if
36 necessary.
37
39 The error codes returned by fido_dev_make_cred() are defined in
40 <fido/err.h>. On success, FIDO_OK is returned.
41
43 fido_cred_new(3), fido_cred_set_authdata(3)
44
45BSD May 23, 2018 BSD