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

FreeBSD Manual Pages

  
 
  

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

NAME
       fido_cred_verify,  fido_cred_verify_self	-- verify the attestation sig-
       nature 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 attrib-
       utes   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 attesta-
       tion 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 attrib-
       utes  of	cred have been attested	by the holder of the credential's pri-
       vate 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
       verification, then FIDO_OK is returned.

SEE ALSO
       fido_cred_new(3), fido_cred_set_authdata(3)

FreeBSD	Ports 14.quarterly	 May 23, 2018		   FIDO_CRED_VERIFY(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fido_cred_verify_self&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help