1FIDO_CRED_VERIFY(3)      BSD Library Functions Manual      FIDO_CRED_VERIFY(3)
2

NAME

4     fido_cred_verify, fido_cred_verify_self — verify the attestation signa‐
5     ture of a FIDO2 credential
6

SYNOPSIS

8     #include <fido.h>
9
10     int
11     fido_cred_verify(const fido_cred_t *cred);
12
13     int
14     fido_cred_verify_self(const fido_cred_t *cred);
15

DESCRIPTION

17     The fido_cred_verify() and fido_cred_verify_self() functions verify
18     whether the attestation signature contained in cred matches the at‐
19     tributes of the credential.  Before using fido_cred_verify() or
20     fido_cred_verify_self() in a sensitive context, the reader is strongly
21     encouraged to make herself familiar with the FIDO2 credential attestation
22     process as defined in the Web Authentication (webauthn) standard.
23
24     The fido_cred_verify() function verifies whether the client data hash,
25     relying party ID, credential ID, type, protection policy, minimum PIN
26     length, and resident/discoverable key and user verification attributes of
27     cred have been attested by the holder of the private counterpart of the
28     public key contained in the credential's x509 certificate.
29
30     Please note that the x509 certificate itself is not verified.
31
32     The attestation statement formats supported by fido_cred_verify() are
33     packed, fido-u2f, and tpm.  The attestation type implemented by
34     fido_cred_verify() is Basic Attestation.
35
36     The fido_cred_verify_self() function verifies whether the client data
37     hash, relying party ID, credential ID, type, protection policy, minimum
38     PIN length, and resident/discoverable key and user verification at‐
39     tributes of cred have been attested by the holder of the credential's
40     private key.
41
42     The attestation statement formats supported by fido_cred_verify_self()
43     are packed and fido-u2f.  The attestation type implemented by
44     fido_cred_verify_self() is Self Attestation.
45
46     Other attestation formats and types are not supported.
47

RETURN VALUES

49     The error codes returned by fido_cred_verify() and
50     fido_cred_verify_self() are defined in <fido/err.h>.  If cred passes ver‐
51     ification, then FIDO_OK is returned.
52

SEE ALSO

54     fido_cred_new(3), fido_cred_set_authdata(3)
55
56BSD                              May 23, 2018                              BSD
Impressum