7 * Generate challange for APOP and CRAM-MD5
11 heim_generate_challenge(const char *hostname
); /* hostname can be NULL, the local hostname is used */
18 heim_apop_create(const char *challenge
, const char *password
);
21 heim_apop_verify(const char *challenge
, const char *password
, const char *response
);
27 typedef struct heim_HMAC_MD5_STATE_s
{
30 } heim_CRAM_MD5_STATE
;
32 typedef struct heim_cram_md5_data
*heim_cram_md5
;
35 heim_cram_md5_create(const char *challenge
, const char *password
);
38 heim_cram_md5_verify(const char *challenge
, const char *password
, const char *response
);
41 heim_cram_md5_export(const char *password
, heim_CRAM_MD5_STATE
*state
);
44 heim_cram_md5_import(void *data
, size_t len
);
47 heim_cram_md5_verify_ctx(heim_cram_md5 ctx
, const char *challenge
, const char *response
);
50 heim_cram_md5_free(heim_cram_md5 ctx
);
57 * d = heim_digest_create(1, HEIM_DIGEST_TYPE_DIGEST_MD5_HTTP);
59 * if ((s = heim_digest_generate_challange(d)) != NULL) abort();
61 * response = read_from_client();
63 * heim_digest_parse_response(d, response);
64 * const char *user = heim_digest_get_key(d, "username");
65 * heim_digest_set_key(d, "password", "sommar17");
67 * if (heim_digest_verify(d, &response)) abort();
69 * send_to_client(response);
71 * heim_digest_release(d);
74 typedef struct heim_digest_desc
*heim_digest_t
;
77 heim_digest_create(int server
, int type
);
79 #define HEIM_DIGEST_TYPE_AUTO 0
80 #define HEIM_DIGEST_TYPE_RFC2069 1
81 #define HEIM_DIGEST_TYPE_RFC2617_MD5 2
82 #define HEIM_DIGEST_TYPE_RFC2617_MD5_SESS 4
83 #define HEIM_DIGEST_TYPE_RFC2831 8
85 #define HEIM_DIGEST_TYPE_RFC2617_OR_RFC2831 12
87 /* old deprecated names, use the two above instead */
88 #define HEIM_DIGEST_TYPE_MD5 2
89 #define HEIM_DIGEST_TYPE_MD5_SESS 4
92 heim_digest_init_set_key(heim_digest_t context
, const char *key
, const char *value
);
95 heim_digest_generate_challenge(heim_digest_t context
);
98 heim_digest_parse_challenge(heim_digest_t context
, const char *challenge
);
101 heim_digest_parse_response(heim_digest_t context
, const char *response
);
104 heim_digest_get_key(heim_digest_t context
, const char *key
);
107 heim_digest_set_key(heim_digest_t context
, const char *key
, const char *value
);
110 heim_digest_set_user_password(heim_digest_t context
, const char *password
);
113 heim_digest_set_user_h1hash(heim_digest_t context
, void *ptr
, size_t size
);
116 heim_digest_verify(heim_digest_t context
, char **response
);
119 heim_digest_create_response(heim_digest_t context
, char **response
);
122 heim_digest_get_session_key(heim_digest_t context
, void **key
, size_t *keySize
);
125 heim_digest_release(heim_digest_t context
);
128 heim_digest_userhash(const char *user
, const char *realm
, const char *password
);
131 heim_digest_server_response(heim_digest_t context
);