home | help
FIDO_DEV_MAKE_CRED(3)	     Library Functions Manual	   FIDO_DEV_MAKE_CRED(3)

NAME
     fido_dev_make_cred -- generates a new credential on a FIDO2 device

SYNOPSIS
     #include <fido.h>

     int
     fido_dev_make_cred(fido_dev_t *dev, fido_cred_t *cred, const char *pin);

DESCRIPTION
     The  fido_dev_make_cred() function asks the FIDO2 device represented by dev
     to generate a new credential according to the following parameters  defined
     in cred:

     -	 type;
     -	 client data hash;
     -	 relying party;
     -	 user attributes;
     -	 list of excluded credential IDs;
     -	 resident/discoverable key and user verification attributes.

     See fido_cred_set_authdata(3) for information on how these values are set.

     If  a  PIN  is not needed to authenticate the request against dev, then pin
     may be NULL.  Otherwise pin must point to a NUL-terminated UTF-8 string.

     After  a  successful  call  to  fido_dev_make_cred(),  the  fido_cred_auth-
     data_ptr(3),     fido_cred_pubkey_ptr(3),	   fido_cred_x5c_ptr(3),     and
     fido_cred_sig_ptr(3) functions may be invoked on cred to retrieve the vari-
     ous parts of the generated credential.

     Please note that fido_dev_make_cred() is synchronous and will block if nec-
     essary.

RETURN VALUES
     The  error  codes	returned  by   fido_dev_make_cred()   are   defined   in
     <fido/err.h>.  On success, FIDO_OK is returned.

SEE ALSO
     fido_cred_new(3), fido_cred_set_authdata(3)

FreeBSD ports 15.quarterly	  May 23, 2018		   FIDO_DEV_MAKE_CRED(3)

home | help