fido_dev_get_assert - Man Page

obtains an assertion from a FIDO device

Synopsis

#include <fido.h>

int
fido_dev_get_assert(fido_dev_t *dev, fido_assert_t *assert, const char *pin);

Description

The fido_dev_get_assert() function asks the FIDO device represented by dev for an assertion according to the following parameters defined in assert:

See fido_assert_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_get_assert(), the fido_assert_count(3), fido_assert_user_display_name(3), fido_assert_user_icon(3), fido_assert_user_name(3), fido_assert_authdata_ptr(3), fido_assert_user_id_ptr(3), fido_assert_sig_ptr(3), and fido_assert_sigcount(3) functions may be invoked on assert to retrieve the various attributes of the generated assertion.

Please note that fido_dev_get_assert() is synchronous and will block if necessary.

Return Values

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

See Also

fido_assert_new(3), fido_assert_set_authdata(3)

Referenced By

fido_assert_allow_cred(3), fido_assert_new(3), fido_assert_set_authdata(3), fido_dev_largeblob_get(3).

May 24, 2018