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

FreeBSD Manual Pages

  
 
  

home | help
KHTTPDIGEST_VALIDAT... FreeBSD Library Functions Manual	KHTTPDIGEST_VALIDAT...

NAME
     khttpdigest_validate, khttpdigest_validatehash -- validate	an HTTP	digest
     request

LIBRARY
     library "libkcgi"

SYNOPSIS
     #include <sys/types.h>
     #include <stdarg.h>
     #include <stdint.h>
     #include <kcgi.h>

     int
     khttpdigest_validate(struct kreq *req, const char *password);

     int
     khttpdigest_validatehash(struct kreq *req,	const char *hash);

DESCRIPTION
     The khttpdigest_validate()	and khttpdigest_validatehash() functions vali-
     date the given password (or a pre-combined	hash) with the HTTP digest-au-
     thorised request req as returned by khttp_parse(3)	or
     khttp_fcgi_parse(3).  It fully implements all components of the digest:
     QOP, MD5 types, etc.  It does not check that the URI component of the di-
     gest matches that of the request, as these	values are known to be muta-
     ble.

     The khttpdigest_validate()	function will compute a	hash from the request
     and password; khttpdigest_validatehash() operates on a pre-computed hash
     value.

RETURN VALUES
     khttpdigest_validate() and	khttpdigest_validatehash() will	return zero if
     validation	failed,	less than zero if the request was not properly set up
     for HTTP digest validation	(no HTTP method, not a digest request, not al-
     ready authenticated by the	web server), or	greater	than zero if the vali-
     dation succeeded.

SEE ALSO
     kcgi(3), khttp_fcgi_parse(3), khttp_parse(3), khttpbasic_validate(3)

AUTHORS
     The khttpdigest_validate()	and khttpdigest_validatehash() functions were
     written by	Kristaps Dzonsons <kristaps@bsd.lv>.

FreeBSD	13.0		       December	30, 2017		  FreeBSD 13.0

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | AUTHORS

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

home | help