dwww Home | Manual pages | Find package

FIDO_CRED_VERIFY(3)         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 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)

Debian                            May 23, 2018              FIDO_CRED_VERIFY(3)

Generated by dwww version 1.16 on Sat Oct 3 07:42:34 CEST 2026.