### Function

# Soup AuthDomainDigest encode_password

#### Declaration [src]

    char*
    soup_auth_domain_digest_encode_password (
      const char* username,
      const char* realm,
      const char* password
    )

#### Description [src]

Encodes the username/realm/password triplet for Digest authentication.

That is, it returns a stringified MD5 hash of `username`, `realm`, and `password` concatenated together. This is the form that is needed as the return value of `SoupAuthDomainDigest`‘s auth handler.

For security reasons, you should store the encoded hash, rather than storing the cleartext password itself and calling this method only when you need to verify it. This way, if your server is compromised, the attackers will not gain access to cleartext passwords which might also be usable at other sites. (Note also that the encoded password returned by this method is identical to the encoded password stored in an Apache .htdigest file.)

#### Parameters

`username` | `const char*`
| A username.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.
`realm` | `const char*`
| An auth realm name.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.
`password` | `const char*`
| The password for `username` in `realm`.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.

#### Return value

Returns: | `char*`
| The encoded password.
| The caller of the function takes ownership of the data, and is responsible for freeing it.
| The value is a NUL terminated UTF-8 string.