source3/include/tldap.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Infrastructure for async ldap client requests
   4    Copyright (C) Volker Lendecke 2009
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef __TLDAP_H__
  21 #define __TLDAP_H__
  22
  23 #include <talloc.h>
  24 #include <tevent.h>
  25
  26 struct tldap_context;
  27 struct tldap_message;
  28
  29 struct tldap_control {
  30         const char *oid;
  31         DATA_BLOB value;
  32         bool iscritical;
  33 };
  34
  35 struct tldap_attribute {
  36         char *name;
  37         int num_values;
  38         DATA_BLOB *values;
  39 };
  40
  41 struct tldap_mod {
  42         int mod_op;
  43         char *attribute;
  44         int num_values;
  45         DATA_BLOB *values;
  46 };
  47
  48 bool tevent_req_is_ldap_error(struct tevent_req *req, int *perr);
  49
  50 struct tldap_context *tldap_context_create(TALLOC_CTX *mem_ctx, int fd);
  51 bool tldap_context_setattr(struct tldap_context *ld,
  52                            const char *name, const void *pptr);
  53 void *tldap_context_getattr(struct tldap_context *ld, const char *name);
  54
  55 struct tevent_req *tldap_sasl_bind_send(TALLOC_CTX *mem_ctx,
  56                                         struct tevent_context *ev,
  57                                         struct tldap_context *ld,
  58                                         const char *dn,
  59                                         const char *mechanism,
  60                                         DATA_BLOB *creds,
  61                                         struct tldap_control **sctrls,
  62                                         struct tldap_control **cctrls);
  63 int tldap_sasl_bind_recv(struct tevent_req *req);
  64 int tldap_sasl_bind(struct tldap_context *ldap,
  65                     const char *dn,
  66                     const char *mechanism,
  67                     DATA_BLOB *creds,
  68                     struct tldap_control **sctrls,
  69                     struct tldap_control **cctrls);
  70
  71 struct tevent_req *tldap_simple_bind_send(TALLOC_CTX *mem_ctx,
  72                                           struct tevent_context *ev,
  73                                           struct tldap_context *ldap,
  74                                           const char *dn,
  75                                           const char *passwd);
  76 int tldap_simple_bind_recv(struct tevent_req *req);
  77 int tldap_simple_bind(struct tldap_context *ldap, const char *dn,
  78                       const char *passwd);
  79
  80 struct tevent_req *tldap_search_send(TALLOC_CTX *mem_ctx,
  81                                      struct tevent_context *ev,
  82                                      struct tldap_context *ld,
  83                                      const char *base, int scope,
  84                                      const char *filter,
  85                                      const char **attrs,
  86                                      int num_attrs,
  87                                      int attrsonly,
  88                                      struct tldap_control **sctrls,
  89                                      struct tldap_control **cctrls,
  90                                      int timelimit,
  91                                      int sizelimit,
  92                                      int deref);
  93 int tldap_search_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
  94                       struct tldap_message **pmsg);
  95 int tldap_search(struct tldap_context *ld,
  96                  const char *base, int scope, const char *filter,
  97                  const char **attrs, int num_attrs, int attrsonly,
  98                  struct tldap_control **sctrls, struct tldap_control **cctrls,
  99                  int timelimit, int sizelimit, int deref,
 100                  TALLOC_CTX *mem_ctx, struct tldap_message ***pentries,
 101                  struct tldap_message ***refs);
 102 bool tldap_entry_dn(struct tldap_message *msg, char **dn);
 103 bool tldap_entry_attributes(struct tldap_message *msg, int *num_attributes,
 104                             struct tldap_attribute **attributes);
 105
 106 struct tevent_req *tldap_add_send(TALLOC_CTX *mem_ctx,
 107                                   struct tevent_context *ev,
 108                                   struct tldap_context *ld,
 109                                   const char *dn,
 110                                   int num_attributes,
 111                                   struct tldap_mod *attributes,
 112                                   struct tldap_control **sctrls,
 113                                   struct tldap_control **cctrls);
 114 int tldap_add_recv(struct tevent_req *req);
 115 int tldap_add(struct tldap_context *ld, const char *dn,
 116               int num_attributes, struct tldap_mod *attributes,
 117               struct tldap_control **sctrls, struct tldap_control **cctrls);
 118
 119 struct tevent_req *tldap_modify_send(TALLOC_CTX *mem_ctx,
 120                                      struct tevent_context *ev,
 121                                      struct tldap_context *ld,
 122                                      const char *dn,
 123                                      int num_mods, struct tldap_mod *mods,
 124                                      struct tldap_control **sctrls,
 125                                      struct tldap_control **cctrls);
 126 int tldap_modify_recv(struct tevent_req *req);
 127 int tldap_modify(struct tldap_context *ld, const char *dn,
 128                  int num_mods, struct tldap_mod *mods,
 129                  struct tldap_control **sctrls, struct tldap_control **cctrls);
 130
 131
 132 struct tevent_req *tldap_delete_send(TALLOC_CTX *mem_ctx,
 133                                      struct tevent_context *ev,
 134                                      struct tldap_context *ld,
 135                                      const char *dn,
 136                                      struct tldap_control **sctrls,
 137                                      struct tldap_control **cctrls);
 138 int tldap_delete_recv(struct tevent_req *req);
 139 int tldap_delete(struct tldap_context *ld, const char *dn,
 140                  struct tldap_control **sctrls, struct tldap_control **cctrls);
 141
 142
 143 int tldap_msg_id(const struct tldap_message *msg);
 144 int tldap_msg_type(const struct tldap_message *msg);
 145 const char *tldap_req_matcheddn(struct tevent_req *req);
 146 const char *tldap_req_diagnosticmessage(struct tevent_req *req);
 147 const char *tldap_req_referral(struct tevent_req *req);
 148 const char *tldap_ctx_matcheddn(struct tldap_context *ctx);
 149 const char *tldap_ctx_diagnosticmessage(struct tldap_context *ctx);
 150 const char *tldap_ctx_referral(struct tldap_context *ctx);
 151 const char *tldap_err2string(int rc);
 152
 153 /* DEBUG */
 154 enum tldap_debug_level {
 155         TLDAP_DEBUG_FATAL,
 156         TLDAP_DEBUG_ERROR,
 157         TLDAP_DEBUG_WARNING,
 158         TLDAP_DEBUG_TRACE
 159 };
 160
 161 void tldap_set_debug(struct tldap_context *ld,
 162                      void (*log_fn)(void *log_private,
 163                                     enum tldap_debug_level level,
 164                                     const char *fmt,
 165                                     va_list ap) PRINTF_ATTRIBUTE(3,0),
 166                      void *log_private);
 167
 168 /*
 169  * "+ 0x60" is from ASN1_APPLICATION
 170  */
 171 #define TLDAP_REQ_BIND (0 + 0x60)
 172 #define TLDAP_RES_BIND (1 + 0x60)
 173 #define TLDAP_REQ_UNBIND (2 + 0x60)
 174 #define TLDAP_REQ_SEARCH (3 + 0x60)
 175 #define TLDAP_RES_SEARCH_ENTRY (4 + 0x60)
 176 #define TLDAP_RES_SEARCH_RESULT (5 + 0x60)
 177 #define TLDAP_REQ_MODIFY (6 + 0x60)
 178 #define TLDAP_RES_MODIFY (7 + 0x60)
 179 #define TLDAP_REQ_ADD (8 + 0x60)
 180 #define TLDAP_RES_ADD (9 + 0x60)
 181 /* ASN1_APPLICATION_SIMPLE instead of ASN1_APPLICATION */
 182 #define TLDAP_REQ_DELETE (10 + 0x40)
 183 #define TLDAP_RES_DELETE (11 + 0x60)
 184 #define TLDAP_REQ_MODDN (12 + 0x60)
 185 #define TLDAP_RES_MODDN (13 + 0x60)
 186 #define TLDAP_REQ_COMPARE (14 + 0x60)
 187 #define TLDAP_RES_COMPARE (15 + 0x60)
 188 /* ASN1_APPLICATION_SIMPLE instead of ASN1_APPLICATION */
 189 #define TLDAP_REQ_ABANDON (16 + 0x40)
 190 #define TLDAP_RES_SEARCH_REFERENCE (19 + 0x60)
 191 #define TLDAP_REQ_EXTENDED (23 + 0x60)
 192 #define TLDAP_RES_EXTENDED (24 + 0x60)
 193 #define TLDAP_RES_INTERMEDIATE (25 + 0x60)
 194
 195 #define TLDAP_SUCCESS (0x00)
 196 #define TLDAP_OPERATIONS_ERROR (0x01)
 197 #define TLDAP_PROTOCOL_ERROR (0x02)
 198 #define TLDAP_TIMELIMIT_EXCEEDED (0x03)
 199 #define TLDAP_SIZELIMIT_EXCEEDED (0x04)
 200 #define TLDAP_COMPARE_FALSE (0x05)
 201 #define TLDAP_COMPARE_TRUE (0x06)
 202 #define TLDAP_STRONG_AUTH_NOT_SUPPORTED (0x07)
 203 #define TLDAP_STRONG_AUTH_REQUIRED (0x08)
 204 #define TLDAP_REFERRAL (0x0a)
 205 #define TLDAP_ADMINLIMIT_EXCEEDED (0x0b)
 206 #define TLDAP_UNAVAILABLE_CRITICAL_EXTENSION (0x0c)
 207 #define TLDAP_CONFIDENTIALITY_REQUIRED (0x0d)
 208 #define TLDAP_SASL_BIND_IN_PROGRESS (0x0e)
 209 #define TLDAP_NO_SUCH_ATTRIBUTE (0x10)
 210 #define TLDAP_UNDEFINED_TYPE (0x11)
 211 #define TLDAP_INAPPROPRIATE_MATCHING (0x12)
 212 #define TLDAP_CONSTRAINT_VIOLATION (0x13)
 213 #define TLDAP_TYPE_OR_VALUE_EXISTS (0x14)
 214 #define TLDAP_INVALID_SYNTAX (0x15)
 215 #define TLDAP_NO_SUCH_OBJECT (0x20)
 216 #define TLDAP_ALIAS_PROBLEM (0x21)
 217 #define TLDAP_INVALID_DN_SYNTAX (0x22)
 218 #define TLDAP_IS_LEAF (0x23)
 219 #define TLDAP_ALIAS_DEREF_PROBLEM (0x24)
 220 #define TLDAP_INAPPROPRIATE_AUTH (0x30)
 221 #define TLDAP_INVALID_CREDENTIALS (0x31)
 222 #define TLDAP_INSUFFICIENT_ACCESS (0x32)
 223 #define TLDAP_BUSY (0x33)
 224 #define TLDAP_UNAVAILABLE (0x34)
 225 #define TLDAP_UNWILLING_TO_PERFORM (0x35)
 226 #define TLDAP_LOOP_DETECT (0x36)
 227 #define TLDAP_NAMING_VIOLATION (0x40)
 228 #define TLDAP_OBJECT_CLASS_VIOLATION (0x41)
 229 #define TLDAP_NOT_ALLOWED_ON_NONLEAF (0x42)
 230 #define TLDAP_NOT_ALLOWED_ON_RDN (0x43)
 231 #define TLDAP_ALREADY_EXISTS (0x44)
 232 #define TLDAP_NO_OBJECT_CLASS_MODS (0x45)
 233 #define TLDAP_RESULTS_TOO_LARGE (0x46)
 234 #define TLDAP_AFFECTS_MULTIPLE_DSAS (0x47)
 235 #define TLDAP_OTHER (0x50)
 236 #define TLDAP_SERVER_DOWN (0x51)
 237 #define TLDAP_LOCAL_ERROR (0x52)
 238 #define TLDAP_ENCODING_ERROR (0x53)
 239 #define TLDAP_DECODING_ERROR (0x54)
 240 #define TLDAP_TIMEOUT (0x55)
 241 #define TLDAP_AUTH_UNKNOWN (0x56)
 242 #define TLDAP_FILTER_ERROR (0x57)
 243 #define TLDAP_USER_CANCELLED (0x58)
 244 #define TLDAP_PARAM_ERROR (0x59)
 245 #define TLDAP_NO_MEMORY (0x5a)
 246 #define TLDAP_CONNECT_ERROR (0x5b)
 247 #define TLDAP_NOT_SUPPORTED (0x5c)
 248 #define TLDAP_CONTROL_NOT_FOUND (0x5d)
 249 #define TLDAP_NO_RESULTS_RETURNED (0x5e)
 250 #define TLDAP_MORE_RESULTS_TO_RETURN (0x5f)
 251 #define TLDAP_CLIENT_LOOP (0x60)
 252 #define TLDAP_REFERRAL_LIMIT_EXCEEDED (0x61)
 253
 254 #define TLDAP_MOD_ADD (0)
 255 #define TLDAP_MOD_DELETE (1)
 256 #define TLDAP_MOD_REPLACE (2)
 257
 258 #define TLDAP_SCOPE_BASE (0)
 259 #define TLDAP_SCOPE_ONE (1)
 260 #define TLDAP_SCOPE_SUB (2)
 261
 262 #endif