1 .\" Copyright (c) 2018 Yubico AB. All rights reserved.
2 .\" Use of this source code is governed by a BSD-style
3 .\" license that can be found in the LICENSE file.
5 .Dd $Mdocdate: May 23 2018 $
6 .Dt FIDO_DEV_MAKE_CRED 3
10 .Nd generates a new credential on a FIDO2 device
14 .Fn fido_dev_make_cred "fido_dev_t *dev" "fido_cred_t *cred" "const char *pin"
17 .Fn fido_dev_make_cred
18 function asks the FIDO2 device represented by
20 to generate a new credential according to the following parameters
28 .Nm client data hash ;
34 .Nm list of excluded credential IDs ;
36 .Nm resident/discoverable key and user verification attributes .
40 .Xr fido_cred_set_authdata 3
41 for information on how these values are set.
43 If a PIN is not needed to authenticate the request against
50 must point to a NUL-terminated UTF-8 string.
52 After a successful call to
53 .Fn fido_dev_make_cred ,
55 .Xr fido_cred_authdata_ptr 3 ,
56 .Xr fido_cred_pubkey_ptr 3 ,
57 .Xr fido_cred_x5c_ptr 3 ,
59 .Xr fido_cred_sig_ptr 3
60 functions may be invoked on
62 to retrieve the various parts of the generated credential.
65 .Fn fido_dev_make_cred
66 is synchronous and will block if necessary.
68 The error codes returned by
69 .Fn fido_dev_make_cred
77 .Xr fido_cred_set_authdata 3