rfc2617.h
Go to the documentation of this file.
1/*
2 * Copyright (C) 1996-2023 The Squid Software Foundation and contributors
3 *
4 * Squid software is distributed under GPLv2+ license and includes
5 * contributions from numerous individuals and organizations.
6 * Please see the COPYING and CONTRIBUTORS files for details.
7 */
8
9/* The source in this file is derived from the reference implementation
10 * in RFC 2617.
11 * RFC 2617 is Copyright (C) The Internet Society (1999). All Rights Reserved.
12 *
13 * The following copyright and licence statement covers all changes made to the
14 * reference implementation.
15 *
16 * Key changes to the reference implementation were:
17 * alteration to a plain C layout.
18 * Create CvtBin function
19 * Allow CalcHA1 to make use of precaculated username:password:realm hash's
20 * to prevent squid knowing the users password (idea suggested in RFC 2617).
21 */
22
23#ifndef SQUID_RFC2617_H
24#define SQUID_RFC2617_H
25
26#ifdef __cplusplus
27extern "C" {
28#endif
29
30#define HASHLEN 16
31typedef char HASH[HASHLEN];
32#define HASHHEXLEN 32
33typedef char HASHHEX[HASHHEXLEN + 1];
34
35/* calculate H(A1) as per HTTP Digest spec */
36extern void DigestCalcHA1(
37 const char *pszAlg,
38 const char *pszUserName,
39 const char *pszRealm,
40 const char *pszPassword,
41 const char *pszNonce,
42 const char *pszCNonce,
43 HASH HA1,
44 HASHHEX SessionKey
45);
46
47/* calculate request-digest/response-digest as per HTTP Digest spec */
48extern void DigestCalcResponse(
49 const HASHHEX HA1, /* H(A1) */
50 const char *pszNonce, /* nonce from server */
51 const char *pszNonceCount, /* 8 hex digits */
52 const char *pszCNonce, /* client nonce */
53 const char *pszQop, /* qop-value: "", "auth", "auth-int" */
54 const char *pszMethod, /* method from the request */
55 const char *pszDigestUri, /* requested URL */
56 const HASHHEX HEntity, /* H(entity body) if qop="auth-int" */
57 HASHHEX Response /* request-digest or response-digest */
58);
59
60extern void CvtHex(const HASH Bin, HASHHEX Hex);
61
62extern void CvtBin(const HASHHEX Hex, HASH Bin);
63
64#ifdef __cplusplus
65}
66#endif
67#endif /* SQUID_RFC2617_H */
68
#define HASHLEN
Definition: rfc2617.h:30
void DigestCalcHA1(const char *pszAlg, const char *pszUserName, const char *pszRealm, const char *pszPassword, const char *pszNonce, const char *pszCNonce, HASH HA1, HASHHEX SessionKey)
Definition: rfc2617.c:88
void CvtBin(const HASHHEX Hex, HASH Bin)
Definition: rfc2617.c:49
#define HASHHEXLEN
Definition: rfc2617.h:32
char HASH[HASHLEN]
Definition: rfc2617.h:31
void CvtHex(const HASH Bin, HASHHEX Hex)
Definition: rfc2617.c:28
char HASHHEX[HASHHEXLEN+1]
Definition: rfc2617.h:33
void DigestCalcResponse(const HASHHEX HA1, const char *pszNonce, const char *pszNonceCount, const char *pszCNonce, const char *pszQop, const char *pszMethod, const char *pszDigestUri, const HASHHEX HEntity, HASHHEX Response)
Definition: rfc2617.c:126

 

Introduction

Documentation

Support

Miscellaneous

Web Site Translations

Mirrors