/***************************************************************************

 *                                  _   _ ____  _

 *  Project                     ___| | | |  _ \| |

 *                             / __| | | | |_) | |

 *                            | (__| |_| |  _ <| |___

 *                             \___|\___/|_| \_\_____|

 *

 * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.

 *

 * This software is licensed as described in the file COPYING, which

 * you should have received as part of this distribution. The terms

 * are also available at https://curl.se/docs/copyright.html.

 *

 * You may opt to use, copy, modify, merge, publish, distribute and/or sell

 * copies of the Software, and permit persons to whom the Software is

 * furnished to do so, under the terms of the COPYING file.

 *

 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY

 * KIND, either express or implied.

 *

 * SPDX-License-Identifier: curl

 *

 * RFC2831 DIGEST-MD5 authentication

 * RFC7616 DIGEST-SHA256, DIGEST-SHA512-256 authentication

 *

 ***************************************************************************/

#include "curl_setup.h"

#ifndef CURL_DISABLE_DIGEST_AUTH

#include "vauth/vauth.h"

#include "vauth/digest.h"

#include "curlx/base64.h"

#include "curl_md5.h"

#include "curl_sha256.h"

#include "curl_sha512_256.h"

#include "curlx/strparse.h"

#include "rand.h"

#include "escape.h"

#ifndef USE_WINDOWS_SSPI

#define SESSION_ALGO 1 /* for algos with this bit set */

#define ALGO_MD5 0

#define ALGO_MD5SESS (ALGO_MD5 | SESSION_ALGO)

#define ALGO_SHA256 2

#define ALGO_SHA256SESS (ALGO_SHA256 | SESSION_ALGO)

#define ALGO_SHA512_256 4

#define ALGO_SHA512_256SESS (ALGO_SHA512_256 | SESSION_ALGO)

#define DIGEST_QOP_VALUE_AUTH             (1 << 0)

#define DIGEST_QOP_VALUE_AUTH_INT         (1 << 1)

#define DIGEST_QOP_VALUE_AUTH_CONF        (1 << 2)

#define DIGEST_QOP_VALUE_STRING_AUTH      "auth"

#define DIGEST_QOP_VALUE_STRING_AUTH_INT  "auth-int"

#define DIGEST_QOP_VALUE_STRING_AUTH_CONF "auth-conf"

#endif

bool Curl_auth_digest_get_pair(const char *str, struct Curl_str *value,

                               char *content, const char **endptr)

{

  int c;

  size_t content_length = 0;

  bool starts_with_quote = FALSE;

  bool escape = FALSE;

  if(curlx_str_until(&str, value, DIGEST_MAX_VALUE_LENGTH, '=') ||

     curlx_str_single(&str, '='))

    /* eek, no match */

    return FALSE;

  if('\"' == *str) {

    /* This starts with a quote so it must end with one as well! */

    str++;

    starts_with_quote = TRUE;

  }

  for(c = DIGEST_MAX_CONTENT_LENGTH; *str && c--; str++) {

    if(!escape) {

      switch(*str) {

      case '\\':

        if(starts_with_quote) {

          /* the start of an escaped quote */

          escape = TRUE;

          continue;

        }

        break;

      case ',':

        if(!starts_with_quote) {

          /* This signals the end of the content if we did not get a starting

             quote and then we do "sloppy" parsing */

          c = 0; /* the end */

          continue;

        }

        break;

      case '\r':

      case '\n':

        /* end of string */

        if(starts_with_quote)

          return FALSE; /* No closing quote */

        c = 0;

        continue;

      case '\"':

        if(starts_with_quote) {

          /* end of string */

          c = 0;

          continue;

        }

        else

          return FALSE;

      }

    }

    if(content_length >= DIGEST_MAX_CONTENT_LENGTH - 1) {

      /* no room for this byte plus the terminator */

      return FALSE;

    }

    escape = FALSE;

    *content++ = *str;

    content_length++;

  }

  if(escape)

    return FALSE; /* No character after backslash */

  *content = 0;

  *endptr = str;

  return TRUE;

}

#ifndef USE_WINDOWS_SSPI

/* Convert MD5 chunk to RFC2617 (section 3.1.3) -suitable ASCII string */

static void auth_digest_md5_to_ascii(

  const unsigned char *source, /* 16 bytes */

  unsigned char *dest)         /* 33 bytes */

{

  int i;

  for(i = 0; i < 16; i++)

    curl_msnprintf((char *)&dest[i * 2], 3, "%02x", source[i]);

}

/* Convert sha256 or SHA-512/256 chunk to RFC7616 -suitable ASCII string */

static void auth_digest_sha256_to_ascii(

  const unsigned char *source, /* 32 bytes */

  unsigned char *dest)         /* 65 bytes */

{

  int i;

  for(i = 0; i < 32; i++)

    curl_msnprintf((char *)&dest[i * 2], 3, "%02x", source[i]);

}

/* Perform quoted-string escaping as described in RFC2616 and its errata */

static char *auth_digest_string_quoted(const char *s)

{

  struct dynbuf out;

  curlx_dyn_init(&out, 2048);

  if(!*s) /* for zero length input, make sure we return an empty string */

    return curlx_strdup("");

  while(*s) {

    CURLcode result;

    if(*s == '"' || *s == '\\') {

      result = curlx_dyn_addn(&out, "\\", 1);

      if(!result)

        result = curlx_dyn_addn(&out, s, 1);

    }

    else if((*s < ' ') || (*s > 0x7e)) {

      unsigned char buf[3] = { '%' };

      Curl_hexbyte(&buf[1], (unsigned char)*s);

      result = curlx_dyn_addn(&out, buf, 3);

    }

    else

      result = curlx_dyn_addn(&out, s, 1);

    if(result)

      return NULL;

    s++;

  }

  return curlx_dyn_ptr(&out);

}

/* Retrieves the value for a corresponding key from the challenge string

 * returns TRUE if the key could be found, FALSE if it does not exist

 */

static bool auth_digest_get_key_value(const char *chlg, const char *key,

                                      char *buf, size_t buflen)

{

  /* keyword=[value],keyword2=[value]

     The values may or may not be quoted.

   */

  do {

    struct Curl_str data;

    struct Curl_str name;

    curlx_str_passblanks(&chlg);

    if(!curlx_str_until(&chlg, &name, 64, '=') &&

       !curlx_str_single(&chlg, '=')) {

      /* this is the key, get the value, possibly quoted */

      int rc = curlx_str_quotedword(&chlg, &data, 256);

      if(rc == STRE_BEGQUOTE)

        /* try unquoted until comma */

        rc = curlx_str_until(&chlg, &data, 256, ',');

      if(rc)

        return FALSE; /* weird */

      if(curlx_str_cmp(&name, key)) {

        /* if this is our key, return the value */

        size_t len = curlx_strlen(&data);

        const char *src = curlx_str(&data);

        size_t i;

        size_t outlen = 0;

        if(len >= buflen)

          /* does not fit */

          return FALSE;

        for(i = 0; i < len; i++) {

          if(src[i] == '\\' && i + 1 < len) {

            i++; /* skip backslash */

          }

          buf[outlen++] = src[i];

        }

        buf[outlen] = 0;

        return TRUE;

      }

      if(curlx_str_single(&chlg, ','))

        return FALSE;

    }

    else /* odd syntax */

      break;

  } while(1);

  return FALSE;

}

static void auth_digest_get_qop_values(const char *options, int *value)

{

  struct Curl_str out;

  /* Initialize the output */

  *value = 0;

  while(!curlx_str_until(&options, &out, 32, ',')) {

    if(curlx_str_casecompare(&out, DIGEST_QOP_VALUE_STRING_AUTH))

      *value |= DIGEST_QOP_VALUE_AUTH;

    else if(curlx_str_casecompare(&out, DIGEST_QOP_VALUE_STRING_AUTH_INT))

      *value |= DIGEST_QOP_VALUE_AUTH_INT;

    else if(curlx_str_casecompare(&out, DIGEST_QOP_VALUE_STRING_AUTH_CONF))

      *value |= DIGEST_QOP_VALUE_AUTH_CONF;

    if(curlx_str_single(&options, ','))

      break;

  }

}

/*

 * auth_decode_digest_md5_message()

 *

 * This is used internally to decode an already encoded DIGEST-MD5 challenge

 * message into the separate attributes.

 *

 * Parameters:

 *

 * chlgref [in]     - The challenge message.

 * nonce   [in/out] - The buffer where the nonce is stored.

 * nlen    [in]     - The length of the nonce buffer.

 * realm   [in/out] - The buffer where the realm is stored.

 * rlen    [in]     - The length of the realm buffer.

 * alg     [in/out] - The buffer where the algorithm is stored.

 * alen    [in]     - The length of the algorithm buffer.

 * qop     [in/out] - The buffer where the qop-options is stored.

 * qlen    [in]     - The length of the qop buffer.

 *

 * Returns CURLE_OK on success.

 */

static CURLcode auth_decode_digest_md5_message(const struct bufref *chlgref,

                                               char *nonce, size_t nlen,

                                               char *realm, size_t rlen,

                                               char *alg, size_t alen,

                                               char *qop, size_t qlen)

{

  const char *chlg = Curl_bufref_ptr(chlgref);

  /* Ensure we have a valid challenge message */

  if(!Curl_bufref_len(chlgref))

    return CURLE_BAD_CONTENT_ENCODING;

  /* Retrieve nonce string from the challenge */

  if(!auth_digest_get_key_value(chlg, "nonce", nonce, nlen))

    return CURLE_BAD_CONTENT_ENCODING;

  /* Retrieve realm string from the challenge */

  if(!auth_digest_get_key_value(chlg, "realm", realm, rlen)) {

    /* Challenge does not have a realm, set empty string [RFC2831] page 6 */

    *realm = '\0';

  }

  /* Retrieve algorithm string from the challenge */

  if(!auth_digest_get_key_value(chlg, "algorithm", alg, alen))

    return CURLE_BAD_CONTENT_ENCODING;

  /* Retrieve qop-options string from the challenge */

  if(!auth_digest_get_key_value(chlg, "qop", qop, qlen))

    return CURLE_BAD_CONTENT_ENCODING;

  return CURLE_OK;

}

/*

 * Curl_auth_is_digest_supported()

 *

 * This is used to evaluate if DIGEST is supported.

 *

 * Parameters: None

 *

 * Returns TRUE as DIGEST as handled by libcurl.

 */

bool Curl_auth_is_digest_supported(void)

{

  return TRUE;

}

/*

 * Curl_auth_create_digest_md5_message()

 *

 * This is used to generate an already encoded DIGEST-MD5 response message

 * ready for sending to the recipient.

 *

 * Parameters:

 *

 * data    [in]     - The session handle.

 * chlg    [in]     - The challenge message.

 * userp   [in]     - The username.

 * passwdp [in]     - The user's password.

 * service [in]     - The service type such as http, smtp, pop or imap.

 * out     [out]    - The result storage.

 *

 * Returns CURLE_OK on success.

 */

CURLcode Curl_auth_create_digest_md5_message(struct Curl_easy *data,

                                             const struct bufref *chlg,

                                             struct Curl_creds *creds,

                                             const char *default_service,

                                             struct bufref *out)

{

  const char *service = Curl_creds_has_sasl_service(creds) ?

    Curl_creds_sasl_service(creds) : default_service;

  size_t i;

  struct MD5_context *ctxt;

  const char *userp = Curl_creds_user(creds);

  const char *passwdp = Curl_creds_passwd(creds);

  char *response = NULL;

  unsigned char digest[MD5_DIGEST_LEN];

  char HA1_hex[(2 * MD5_DIGEST_LEN) + 1];

  char HA2_hex[(2 * MD5_DIGEST_LEN) + 1];

  char resp_hash_hex[(2 * MD5_DIGEST_LEN) + 1];

  char nonce[64];

  char realm[128];

  char algorithm[64];

  char qop_options[64];

  int qop_values;

  char cnonce[33];

  char nonceCount[] = "00000001";

  char method[]     = "AUTHENTICATE";

  char qop[]        = DIGEST_QOP_VALUE_STRING_AUTH;

  char *spn         = NULL;

  char *qrealm;

  char *qnonce;

  char *quserp;

  char *qspn;

  /* Decode the challenge message */

  CURLcode result = auth_decode_digest_md5_message(chlg,

                                                   nonce, sizeof(nonce),

                                                   realm, sizeof(realm),

                                                   algorithm,

                                                   sizeof(algorithm),

                                                   qop_options,

                                                   sizeof(qop_options));

  if(result)

    return result;

  /* We only support md5 sessions */

  if(strcmp(algorithm, "md5-sess"))

    return CURLE_BAD_CONTENT_ENCODING;

  /* Get the qop-values from the qop-options */

  auth_digest_get_qop_values(qop_options, &qop_values);

  /* We only support auth quality-of-protection */

  if(!(qop_values & DIGEST_QOP_VALUE_AUTH))

    return CURLE_BAD_CONTENT_ENCODING;

  /* Generate 32 random hex chars, 32 bytes + 1 null-termination */

  result = Curl_rand_hex(data, (unsigned char *)cnonce, sizeof(cnonce));

  if(result)

    return result;

  /* Good so far, now calculate A1 and H(A1) according to RFC 2831 */

  ctxt = Curl_MD5_init(&Curl_DIGEST_MD5);

  if(!ctxt)

    return CURLE_OUT_OF_MEMORY;

  Curl_MD5_update(ctxt, (const unsigned char *)userp,

                  curlx_uztoui(strlen(userp)));

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)realm,

                  curlx_uztoui(strlen(realm)));

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)passwdp,

                  curlx_uztoui(strlen(passwdp)));

  Curl_MD5_final(ctxt, digest);

  ctxt = Curl_MD5_init(&Curl_DIGEST_MD5);

  if(!ctxt)

    return CURLE_OUT_OF_MEMORY;

  Curl_MD5_update(ctxt, (const unsigned char *)digest, MD5_DIGEST_LEN);

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)nonce,

                  curlx_uztoui(strlen(nonce)));

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)cnonce,

                  curlx_uztoui(strlen(cnonce)));

  Curl_MD5_final(ctxt, digest);

  /* Convert calculated 16 octet hex into 32 bytes string */

  for(i = 0; i < MD5_DIGEST_LEN; i++)

    curl_msnprintf(&HA1_hex[2 * i], 3, "%02x", digest[i]);

  /* Generate our SPN */

  spn = Curl_auth_build_spn(service, data->state.origin->hostname, NULL);

  if(!spn)

    return CURLE_OUT_OF_MEMORY;

  /* Calculate H(A2) */

  ctxt = Curl_MD5_init(&Curl_DIGEST_MD5);

  if(!ctxt) {

    curlx_free(spn);

    return CURLE_OUT_OF_MEMORY;

  }

  Curl_MD5_update(ctxt, (const unsigned char *)method,

                  curlx_uztoui(strlen(method)));

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)spn,

                  curlx_uztoui(strlen(spn)));

  Curl_MD5_final(ctxt, digest);

  for(i = 0; i < MD5_DIGEST_LEN; i++)

    curl_msnprintf(&HA2_hex[2 * i], 3, "%02x", digest[i]);

  /* Now calculate the response hash */

  ctxt = Curl_MD5_init(&Curl_DIGEST_MD5);

  if(!ctxt) {

    curlx_free(spn);

    return CURLE_OUT_OF_MEMORY;

  }

  Curl_MD5_update(ctxt, (const unsigned char *)HA1_hex, 2 * MD5_DIGEST_LEN);

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)nonce,

                  curlx_uztoui(strlen(nonce)));

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)nonceCount,

                  curlx_uztoui(strlen(nonceCount)));

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)cnonce,

                  curlx_uztoui(strlen(cnonce)));

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)qop,

                  curlx_uztoui(strlen(qop)));

  Curl_MD5_update(ctxt, (const unsigned char *)":", 1);

  Curl_MD5_update(ctxt, (const unsigned char *)HA2_hex, 2 * MD5_DIGEST_LEN);

  Curl_MD5_final(ctxt, digest);

  for(i = 0; i < MD5_DIGEST_LEN; i++)

    curl_msnprintf(&resp_hash_hex[2 * i], 3, "%02x", digest[i]);

  /* escape double quotes and backslashes in the username, realm, nonce and

     spn as necessary */

  qrealm = auth_digest_string_quoted(realm);

  qnonce = auth_digest_string_quoted(nonce);

  quserp = auth_digest_string_quoted(userp);

  qspn = auth_digest_string_quoted(spn);

  if(qrealm && qnonce && quserp && qspn)

    /* Generate the response */

    response = curl_maprintf("username=\"%s\",realm=\"%s\",nonce=\"%s\","

                             "cnonce=\"%s\",nc=\"%s\",digest-uri=\"%s\","

                             "response=%s,qop=%s",

                             quserp, qrealm, qnonce,

                             cnonce, nonceCount, qspn, resp_hash_hex, qop);

  curlx_free(qrealm);

  curlx_free(qnonce);

  curlx_free(quserp);

  curlx_free(spn);

  curlx_free(qspn);

  if(!response)

    return CURLE_OUT_OF_MEMORY;

  /* Return the response. */

  Curl_bufref_set(out, response, strlen(response), curl_free);

  return result;

}

/*

 * Curl_auth_decode_digest_http_message()

 *

 * This is used to decode an HTTP DIGEST challenge message into the separate

 * attributes.

 *

 * Parameters:

 *

 * chlg    [in]     - The challenge message.

 * digest  [in/out] - The digest data struct being used and modified.

 *

 * Returns CURLE_OK on success.

 */

CURLcode Curl_auth_decode_digest_http_message(const char *chlg,

                                              struct digestdata *digest)

{

  bool before = FALSE; /* got a nonce before */

  /* If we already have received a nonce, keep that in mind */

  if(digest->nonce)

    before = TRUE;

  /* Clean up any former leftovers and initialize to defaults */

  Curl_auth_digest_cleanup(digest);

  for(;;) {

    struct Curl_str value;

    char content[DIGEST_MAX_CONTENT_LENGTH];

    /* Pass all additional spaces here */

    curlx_str_passblanks(&chlg);

    /* Extract a value=content pair */

    if(Curl_auth_digest_get_pair(chlg, &value, content, &chlg)) {

      if(curlx_str_casecompare(&value, "nonce")) {

        curlx_free(digest->nonce);

        digest->nonce = curlx_strdup(content);

        if(!digest->nonce)

          return CURLE_OUT_OF_MEMORY;

      }

      else if(curlx_str_casecompare(&value, "stale")) {

        if(curl_strequal(content, "true")) {

          digest->stale = TRUE;

          digest->nc = 1; /* we make a new nonce now */

        }

      }

      else if(curlx_str_casecompare(&value, "realm")) {

        curlx_free(digest->realm);

        digest->realm = curlx_strdup(content);

        if(!digest->realm)

          return CURLE_OUT_OF_MEMORY;

      }

      else if(curlx_str_casecompare(&value, "opaque")) {

        curlx_free(digest->opaque);

        digest->opaque = curlx_strdup(content);

        if(!digest->opaque)

          return CURLE_OUT_OF_MEMORY;

      }

      else if(curlx_str_casecompare(&value, "qop")) {

        const char *token = content;

        struct Curl_str out;

        bool foundAuth = FALSE;

        bool foundAuthInt = FALSE;

        /* Pass leading spaces */

        curlx_str_passblanks(&token);

        while(!curlx_str_until(&token, &out, 32, ',')) {

          if(curlx_str_casecompare(&out, DIGEST_QOP_VALUE_STRING_AUTH))

            foundAuth = TRUE;

          else if(curlx_str_casecompare(&out,

                                        DIGEST_QOP_VALUE_STRING_AUTH_INT))

            foundAuthInt = TRUE;

          if(curlx_str_single(&token, ','))

            break;

          curlx_str_passblanks(&token);

        }

        /* Select only auth or auth-int. Otherwise, ignore */

        if(foundAuth) {

          curlx_free(digest->qop);

          digest->qop = curlx_strdup(DIGEST_QOP_VALUE_STRING_AUTH);

          if(!digest->qop)

            return CURLE_OUT_OF_MEMORY;

        }

        else if(foundAuthInt) {

          curlx_free(digest->qop);

          digest->qop = curlx_strdup(DIGEST_QOP_VALUE_STRING_AUTH_INT);

          if(!digest->qop)

            return CURLE_OUT_OF_MEMORY;

        }

      }

      else if(curlx_str_casecompare(&value, "algorithm")) {

        curlx_free(digest->algorithm);

        digest->algorithm = curlx_strdup(content);

        if(!digest->algorithm)

          return CURLE_OUT_OF_MEMORY;

        if(curl_strequal(content, "MD5-sess"))

          digest->algo = ALGO_MD5SESS;

        else if(curl_strequal(content, "MD5"))

          digest->algo = ALGO_MD5;

        else if(curl_strequal(content, "SHA-256"))

          digest->algo = ALGO_SHA256;

        else if(curl_strequal(content, "SHA-256-SESS"))

          digest->algo = ALGO_SHA256SESS;

        else if(curl_strequal(content, "SHA-512-256")) {

#ifdef CURL_HAVE_SHA512_256

          digest->algo = ALGO_SHA512_256;

#else /* !CURL_HAVE_SHA512_256 */

          return CURLE_NOT_BUILT_IN;

#endif /* CURL_HAVE_SHA512_256 */

        }

        else if(curl_strequal(content, "SHA-512-256-SESS")) {

#ifdef CURL_HAVE_SHA512_256

          digest->algo = ALGO_SHA512_256SESS;

#else /* !CURL_HAVE_SHA512_256 */

          return CURLE_NOT_BUILT_IN;

#endif /* CURL_HAVE_SHA512_256 */

        }

        else

          return CURLE_BAD_CONTENT_ENCODING;

      }

      else if(curlx_str_casecompare(&value, "userhash")) {

        if(curl_strequal(content, "true")) {

          digest->userhash = TRUE;

        }

      }

      else {

        /* Unknown specifier, ignore it! */

      }

    }

    else

      break; /* We are done here */

    /* Pass all additional spaces here */

    curlx_str_passblanks(&chlg);

    /* Allow the list to be comma-separated */

    (void)curlx_str_single(&chlg, ',');

  }

  /* We had a nonce since before, and we got another one now without

     'stale=true'. This means we provided bad credentials in the previous

     request */

  if(before && !digest->stale)

    return CURLE_BAD_CONTENT_ENCODING;

  /* We got this header without a nonce, that is a bad Digest line! */

  if(!digest->nonce)

    return CURLE_BAD_CONTENT_ENCODING;

  /* "<algo>-sess" protocol versions require "auth" or "auth-int" qop */

  if(!digest->qop && (digest->algo & SESSION_ALGO))

    return CURLE_BAD_CONTENT_ENCODING;

  return CURLE_OK;

}

/*

 * auth_create_digest_http_message()

 *

 * This is used to generate an HTTP DIGEST response message ready for sending

 * to the recipient.

 *

 * Parameters:

 *

 * data    [in]     - The session handle.

 * creds   [in]     - The credentials

 * request [in]     - The HTTP request.

 * uripath [in]     - The path of the HTTP uri.

 * digest  [in/out] - The digest data struct being used and modified.

 * outptr  [in/out] - The address where a pointer to newly allocated memory

 *                    holding the result is stored upon completion.

 * outlen  [out]    - The length of the output message.

 *

 * Returns CURLE_OK on success.

 */

static CURLcode auth_create_digest_http_message(

  struct Curl_easy *data,

  struct Curl_creds *creds,

  const unsigned char *request,

  const unsigned char *uripath,

  struct digestdata *digest,

  char **outptr, size_t *outlen,

  void (*convert_to_ascii)(const unsigned char *, unsigned char *),

  CURLcode (*hash)(unsigned char *, const unsigned char *, const size_t))

{

  CURLcode result;

  const char *userp = Curl_creds_user(creds);

  const char *passwdp = Curl_creds_passwd(creds);

  unsigned char hashbuf[32]; /* 32 bytes/256 bits */

  unsigned char request_digest[65];

  unsigned char ha1[65];    /* 64 digits and 1 zero byte */

  unsigned char ha2[65];    /* 64 digits and 1 zero byte */

  char userh[65];

  char *cnonce = NULL;

  size_t cnonce_sz = 0;

  char *userp_quoted = NULL;

  char *realm_quoted = NULL;

  char *nonce_quoted = NULL;

  char *hashthis = NULL;

  char *uri_quoted = NULL;

  struct dynbuf response;

  *outptr = NULL;

  curlx_dyn_init(&response, 4096); /* arbitrary max */

  memset(hashbuf, 0, sizeof(hashbuf));

  if(!digest->nc)

    digest->nc = 1;

  if(!digest->cnonce) {

    char cnoncebuf[12];

    result = Curl_rand_bytes(data,

#ifdef DEBUGBUILD

                             TRUE,

#endif

                             (unsigned char *)cnoncebuf,

                             sizeof(cnoncebuf));

    if(!result)

      result = curlx_base64_encode((uint8_t *)cnoncebuf, sizeof(cnoncebuf),

                                   &cnonce, &cnonce_sz);

    if(result)

      goto oom;

    digest->cnonce = cnonce;

  }

  if(digest->userhash) {

    char *hasht = curl_maprintf("%s:%s", userp,

                                digest->realm ? digest->realm : "");

    if(!hasht) {

      result = CURLE_OUT_OF_MEMORY;

      goto oom;

    }

    result = hash(hashbuf, (unsigned char *)hasht, strlen(hasht));

    curlx_free(hasht);

    if(result)

      goto oom;

    convert_to_ascii(hashbuf, (unsigned char *)userh);

  }

  /* If the algorithm is "MD5" or unspecified (which then defaults to MD5):

       A1 = unq(username-value) ":" unq(realm-value) ":" passwd

     If the algorithm is "MD5-sess" then:

       A1 = H(unq(username-value) ":" unq(realm-value) ":" passwd) ":"

            unq(nonce-value) ":" unq(cnonce-value)

   */

  hashthis = curl_maprintf("%s:%s:%s", userp, digest->realm ?

                           digest->realm : "", passwdp);

  if(!hashthis) {

    result = CURLE_OUT_OF_MEMORY;

    goto oom;

  }

  result = hash(hashbuf, (unsigned char *)hashthis, strlen(hashthis));

  curlx_free(hashthis);

  if(result)

    goto oom;

  convert_to_ascii(hashbuf, ha1);

  if(digest->algo & SESSION_ALGO) {

    /* nonce and cnonce are OUTSIDE the hash */

    char *tmp = curl_maprintf("%s:%s:%s", ha1, digest->nonce, digest->cnonce);

    if(!tmp) {

      result = CURLE_OUT_OF_MEMORY;

      goto oom;

    }

    result = hash(hashbuf, (unsigned char *)tmp, strlen(tmp));

    curlx_free(tmp);

    if(result)

      goto oom;

    convert_to_ascii(hashbuf, ha1);

  }

  /* If the "qop" directive's value is "auth" or is unspecified, then A2 is:

       A2 = Method ":" digest-uri-value

     If the "qop" value is "auth-int", then A2 is:

       A2 = Method ":" digest-uri-value ":" H(entity-body)

     (The "Method" value is the HTTP request method as specified in section

     5.1.1 of RFC 2616)

   */

  uri_quoted = auth_digest_string_quoted((const char *)uripath);

  if(!uri_quoted) {

    result = CURLE_OUT_OF_MEMORY;

    goto oom;

  }

  hashthis = curl_maprintf("%s:%s", request, uripath);

  if(!hashthis) {

    result = CURLE_OUT_OF_MEMORY;

    goto oom;

  }

  if(digest->qop && curl_strequal(digest->qop, "auth-int")) {

    /* We do not support auth-int for PUT or POST */

    char hashed[65];

    char *hashthis2;

    result = hash(hashbuf, (const unsigned char *)"", 0);

    if(result) {

      curlx_free(hashthis);

      goto oom;

    }

    convert_to_ascii(hashbuf, (unsigned char *)hashed);

    hashthis2 = curl_maprintf("%s:%s", hashthis, hashed);

    curlx_free(hashthis);

    hashthis = hashthis2;

    if(!hashthis) {

      result = CURLE_OUT_OF_MEMORY;

      goto oom;

    }

  }

  result = hash(hashbuf, (unsigned char *)hashthis, strlen(hashthis));

  curlx_free(hashthis);

  if(result)

    goto oom;

  convert_to_ascii(hashbuf, ha2);

  if(digest->qop)

    hashthis = curl_maprintf("%s:%s:%08x:%s:%s:%s", ha1, digest->nonce,

                             (unsigned int)digest->nc, digest->cnonce,

                             digest->qop, ha2);

  else

    hashthis = curl_maprintf("%s:%s:%s", ha1, digest->nonce, ha2);

  if(!hashthis) {

    result = CURLE_OUT_OF_MEMORY;

    goto oom;

  }

  result = hash(hashbuf, (unsigned char *)hashthis, strlen(hashthis));

  curlx_free(hashthis);

  if(result)

    goto oom;

  convert_to_ascii(hashbuf, request_digest);

  /* For test case 64 (snooped from a Mozilla 1.3a request)

     Authorization: Digest username="testuser", realm="testrealm", \

     nonce="1053604145", uri="/64", response="c55f7f30d83d774a3d2dcacf725abaca"

     Digest parameters are all quoted strings. Username which is provided by

     the user needs double quotes and backslashes within it escaped.

     realm, nonce, and opaque needs backslashes as well as they were

     de-escaped when copied from request header. cnonce is generated with

     web-safe characters. uri is already percent encoded. nc is 8 hex

     characters. algorithm and qop with standard values only contain web-safe

     characters.

   */

  userp_quoted = auth_digest_string_quoted(digest->userhash ? userh : userp);

  if(!userp_quoted) {

    result = CURLE_OUT_OF_MEMORY;

    goto oom;

  }

  if(digest->realm)

    realm_quoted = auth_digest_string_quoted(digest->realm);

  else {

    realm_quoted = curlx_malloc(1);

    if(realm_quoted)

      realm_quoted[0] = 0;

  }

  if(!realm_quoted) {

    result = CURLE_OUT_OF_MEMORY;

    goto oom;

  }

  nonce_quoted = auth_digest_string_quoted(digest->nonce);

  if(!nonce_quoted) {

    result = CURLE_OUT_OF_MEMORY;