lib/ntlm/heim-auth.h

   1 /*
   2  * Generate challange for APOP and CRAM-MD5
   3  */
   4
   5 char *
   6 heim_generate_challenge(const char *hostname); /* hostname can be NULL, the local hostname is used */
   7
   8 /*
   9  * APOP
  10  */
  11
  12 char *
  13 heim_apop_create(const char *challenge, const char *password);
  14
  15 int
  16 heim_apop_verify(const char *challenge, const char *password, const char *response);
  17
  18 /*
  19  * CRAM-MD5
  20  */
  21
  22 typedef struct heim_HMAC_MD5_STATE_s {
  23     uint32_t istate[4];
  24     uint32_t ostate[4];
  25 } heim_CRAM_MD5_STATE;
  26
  27 typedef struct heim_cram_md5 *heim_cram_md5;
  28
  29 char *
  30 heim_cram_md5_create(const char *challenge, const char *password);
  31
  32 int
  33 heim_cram_md5_verify(const char *challenge, const char *password, const char *response);
  34
  35 void
  36 heim_cram_md5_export(const char *password, heim_CRAM_MD5_STATE *state);
  37
  38 heim_cram_md5
  39 heim_cram_md5_import(void *data, size_t len);
  40
  41 int
  42 heim_cram_md5_verify_ctx(heim_cram_md5 ctx, const char *challenge, const char *response);
  43
  44 void
  45 heim_cram_md5_free(heim_cram_md5 ctx);
  46
  47 /*
  48  * DIGEST-MD5
  49  *
  50  * heim_digest_t d;
  51  *
  52  * d = heim_digest_create(1, HEIM_DIGEST_TYPE_DIGEST_MD5_HTTP);
  53  *
  54  * if ((s = heim_digest_generate_challange(d)) != NULL) abort();
  55  * send_to_client(s);
  56  * response = read_from_client();
  57  *
  58  * heim_digest_parse_response(d, response);
  59  *
  60  * const char *user = heim_digest_get_key(d, "username");
  61  * heim_digest_set_key(d, "password", "sommar17");
  62  *
  63  * if (heim_digest_verify(d, &response)) abort();
  64  *
  65  * send_to_client(response);
  66  *
  67  * heim_digest_release(d);
  68  */
  69
  70 typedef struct heim_digest_desc *heim_digest_t;
  71
  72 heim_digest_t
  73 heim_digest_create(int server, int type);
  74
  75 #define HEIM_DIGEST_TYPE_AUTO                           0
  76 #define HEIM_DIGEST_TYPE_RFC2069                        1
  77 #define HEIM_DIGEST_TYPE_MD5                            2
  78 #define HEIM_DIGEST_TYPE_MD5_SESS                       3
  79
  80 void
  81 heim_digest_init_set_key(heim_digest_t context, const char *key, const char *value);
  82
  83 const char *
  84 heim_digest_generate_challenge(heim_digest_t context);
  85
  86 int
  87 heim_digest_parse_challenge(heim_digest_t context, const char *challenge);
  88
  89 int
  90 heim_digest_parse_response(heim_digest_t context, const char *response);
  91
  92 const char *
  93 heim_digest_get_key(heim_digest_t context, const char *key);
  94
  95 int
  96 heim_digest_set_key(heim_digest_t context, const char *key, const char *value);
  97
  98 void
  99 heim_digest_set_user_password(heim_digest_t context, const char *password);
 100
 101 void
 102 heim_digest_set_user_h1hash(heim_digest_t context, void *ptr, size_t size);
 103
 104 int
 105 heim_digest_verify(heim_digest_t context, char **response);
 106
 107 const char *
 108 heim_digest_create_response(heim_digest_t context);
 109
 110 void
 111 heim_digest_get_session_key(heim_digest_t context, void **key, size_t *keySize);
 112
 113 void
 114 heim_digest_release(heim_digest_t context);