Scroll to navigation

FIDO_CRED_VERIFY(3) Library Functions Manual FIDO_CRED_VERIFY(3)

NAME

fido_cred_verify, fido_cred_verify_selfverify the attestation signature of a FIDO2 credential

SYNOPSIS

#include <fido.h>

int
fido_cred_verify(const fido_cred_t *cred);

int
fido_cred_verify_self(const fido_cred_t *cred);

DESCRIPTION

The () and fido_cred_verify_self() functions verify whether the attestation signature contained in cred matches the attributes of the credential. Before using fido_cred_verify() or fido_cred_verify_self() in a sensitive context, the reader is strongly encouraged to make herself familiar with the FIDO2 credential attestation process as defined in the Web Authentication (webauthn) standard.

The () function verifies whether the client data hash, relying party ID, credential ID, type, protection policy, minimum PIN length, and resident/discoverable key and user verification attributes of cred have been attested by the holder of the private counterpart of the public key contained in the credential's x509 certificate.

Please note that the x509 certificate itself is not verified.

The attestation statement formats supported by () are packed, fido-u2f, and . The attestation type implemented by fido_cred_verify() is .

The () function verifies whether the client data hash, relying party ID, credential ID, type, protection policy, minimum PIN length, and resident/discoverable key and user verification attributes of cred have been attested by the holder of the credential's private key.

The attestation statement formats supported by () are packed and fido-u2f. The attestation type implemented by fido_cred_verify_self() is .

Other attestation formats and types are not supported.

RETURN VALUES

The error codes returned by fido_cred_verify() and fido_cred_verify_self() are defined in <fido/err.h>. If cred passes verification, then FIDO_OK is returned.

SEE ALSO

fido_cred_new(3), fido_cred_set_authdata(3)

May 23, 2018 Linux 6.4.0-150600.23.7-default