Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FIDO_CRED_VERIFY(3)    FreeBSD Library Functions Manual	   FIDO_CRED_VERIFY(3)

NAME
     fido_cred_verify, fido_cred_verify_self --	verify the attestation signa-
     ture 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 fido_cred_verify() and	fido_cred_verify_self()	functions verify
     whether the attestation signature contained in cred matches the at-
     tributes 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 fido_cred_verify() 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 fido_cred_verify() are
     packed, fido-u2f, and tpm.	 The attestation type implemented by
     fido_cred_verify()	is Basic Attestation.

     The fido_cred_verify_self() 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 at-
     tributes of cred have been	attested by the	holder of the credential's
     private key.

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

     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 ver-
     ification,	then FIDO_OK is	returned.

SEE ALSO
     fido_cred_new(3), fido_cred_set_authdata(3)

FreeBSD	13.0			 May 23, 2018			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fido_cred_verify&sektion=3&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help