source/libcli/smb_composite/connect.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3
   4    Copyright (C) Andrew Tridgell 2005
   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 2 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, write to the Free Software
  18    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19 */
  20 /*
  21   a composite API for making a full SMB connection
  22 */
  23
  24 #include "includes.h"
  25 #include "libcli/raw/libcliraw.h"
  26 #include "libcli/composite/composite.h"
  27 #include "libcli/smb_composite/smb_composite.h"
  28 #include "lib/events/events.h"
  29 #include "libcli/resolve/resolve.h"
  30 #include "auth/credentials/credentials.h"
  31 #include "librpc/gen_ndr/ndr_nbt.h"
  32
  33 /* the stages of this call */
  34 enum connect_stage {CONNECT_RESOLVE,
  35                     CONNECT_SOCKET,
  36                     CONNECT_SESSION_REQUEST,
  37                     CONNECT_NEGPROT,
  38                     CONNECT_SESSION_SETUP,
  39                     CONNECT_SESSION_SETUP_ANON,
  40                     CONNECT_TCON};
  41
  42 struct connect_state {
  43         enum connect_stage stage;
  44         struct smbcli_socket *sock;
  45         struct smbcli_transport *transport;
  46         struct smbcli_session *session;
  47         struct smb_composite_connect *io;
  48         union smb_tcon *io_tcon;
  49         struct smb_composite_sesssetup *io_setup;
  50         struct smbcli_request *req;
  51         struct composite_context *creq;
  52 };
  53
  54
  55 static void request_handler(struct smbcli_request *);
  56 static void composite_handler(struct composite_context *);
  57
  58 /*
  59   setup a negprot send
  60 */
  61 static NTSTATUS connect_send_negprot(struct composite_context *c,
  62                                      struct smb_composite_connect *io)
  63 {
  64         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
  65
  66         state->req = smb_raw_negotiate_send(state->transport, lp_cli_maxprotocol());
  67         NT_STATUS_HAVE_NO_MEMORY(state->req);
  68
  69         state->req->async.fn = request_handler;
  70         state->req->async.private = c;
  71         state->stage = CONNECT_NEGPROT;
  72
  73         return NT_STATUS_OK;
  74 }
  75
  76
  77 /*
  78   a tree connect request has completed
  79 */
  80 static NTSTATUS connect_tcon(struct composite_context *c,
  81                              struct smb_composite_connect *io)
  82 {
  83         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
  84         NTSTATUS status;
  85
  86         status = smb_raw_tcon_recv(state->req, c, state->io_tcon);
  87         NT_STATUS_NOT_OK_RETURN(status);
  88
  89         io->out.tree->tid = state->io_tcon->tconx.out.tid;
  90         if (state->io_tcon->tconx.out.dev_type) {
  91                 io->out.tree->device = talloc_strdup(io->out.tree,
  92                                                      state->io_tcon->tconx.out.dev_type);
  93         }
  94         if (state->io_tcon->tconx.out.fs_type) {
  95                 io->out.tree->fs_type = talloc_strdup(io->out.tree,
  96                                                       state->io_tcon->tconx.out.fs_type);
  97         }
  98
  99         /* all done! */
 100         c->state = COMPOSITE_STATE_DONE;
 101
 102         return NT_STATUS_OK;
 103 }
 104
 105
 106 /*
 107   a session setup request with anonymous fallback has completed
 108 */
 109 static NTSTATUS connect_session_setup_anon(struct composite_context *c,
 110                                            struct smb_composite_connect *io)
 111 {
 112         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
 113         NTSTATUS status;
 114
 115         status = smb_composite_sesssetup_recv(state->creq);
 116         NT_STATUS_NOT_OK_RETURN(status);
 117
 118         io->out.anonymous_fallback_done = True;
 119
 120         state->session->vuid = state->io_setup->out.vuid;
 121
 122         /* setup for a tconx */
 123         io->out.tree = smbcli_tree_init(state->session, state, True);
 124         NT_STATUS_HAVE_NO_MEMORY(io->out.tree);
 125
 126         state->io_tcon = talloc(c, union smb_tcon);
 127         NT_STATUS_HAVE_NO_MEMORY(state->io_tcon);
 128
 129         /* connect to a share using a tree connect */
 130         state->io_tcon->generic.level = RAW_TCON_TCONX;
 131         state->io_tcon->tconx.in.flags = 0;
 132         state->io_tcon->tconx.in.password = data_blob(NULL, 0);
 133
 134         state->io_tcon->tconx.in.path = talloc_asprintf(state->io_tcon,
 135                                                  "\\\\%s\\%s",
 136                                                  io->in.called_name,
 137                                                  io->in.service);
 138         NT_STATUS_HAVE_NO_MEMORY(state->io_tcon->tconx.in.path);
 139         if (!io->in.service_type) {
 140                 state->io_tcon->tconx.in.device = "?????";
 141         } else {
 142                 state->io_tcon->tconx.in.device = io->in.service_type;
 143         }
 144
 145         state->req = smb_raw_tcon_send(io->out.tree, state->io_tcon);
 146         NT_STATUS_HAVE_NO_MEMORY(state->req);
 147         if (state->req->state == SMBCLI_REQUEST_ERROR) {
 148                 return state->req->status;
 149         }
 150
 151         state->req->async.fn = request_handler;
 152         state->req->async.private = c;
 153         state->stage = CONNECT_TCON;
 154
 155         return NT_STATUS_OK;
 156 }
 157
 158 /*
 159   a session setup request has completed
 160 */
 161 static NTSTATUS connect_session_setup(struct composite_context *c,
 162                                       struct smb_composite_connect *io)
 163 {
 164         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
 165         NTSTATUS status;
 166
 167         status = smb_composite_sesssetup_recv(state->creq);
 168
 169         if (!NT_STATUS_IS_OK(status) &&
 170             !cli_credentials_is_anonymous(state->io->in.credentials) &&
 171             io->in.fallback_to_anonymous) {
 172
 173                 state->io_setup->in.credentials = cli_credentials_init(state);
 174                 NT_STATUS_HAVE_NO_MEMORY(state->io_setup->in.credentials);
 175                 cli_credentials_set_conf(state->io_setup->in.credentials);
 176                 cli_credentials_set_anonymous(state->io_setup->in.credentials);
 177
 178                 /* If the preceding attempt was with extended security, we
 179                  * have been given a uid in the NTLMSSP_CHALLENGE reply. This
 180                  * would lead to an invalid uid in the anonymous fallback */
 181                 state->session->vuid = 0;
 182
 183                 state->creq = smb_composite_sesssetup_send(state->session,
 184                                                            state->io_setup);
 185                 NT_STATUS_HAVE_NO_MEMORY(state->creq);
 186                 if (state->creq->state == COMPOSITE_STATE_ERROR) {
 187                         return state->creq->status;
 188                 }
 189                 state->creq->async.fn = composite_handler;
 190                 state->creq->async.private_data = c;
 191                 state->stage = CONNECT_SESSION_SETUP_ANON;
 192
 193                 return NT_STATUS_OK;
 194         }
 195
 196         NT_STATUS_NOT_OK_RETURN(status);
 197
 198         state->session->vuid = state->io_setup->out.vuid;
 199
 200         /* setup for a tconx */
 201         io->out.tree = smbcli_tree_init(state->session, state, True);
 202         NT_STATUS_HAVE_NO_MEMORY(io->out.tree);
 203
 204         state->io_tcon = talloc(c, union smb_tcon);
 205         NT_STATUS_HAVE_NO_MEMORY(state->io_tcon);
 206
 207         /* connect to a share using a tree connect */
 208         state->io_tcon->generic.level = RAW_TCON_TCONX;
 209         state->io_tcon->tconx.in.flags = 0;
 210         state->io_tcon->tconx.in.password = data_blob(NULL, 0);
 211
 212         state->io_tcon->tconx.in.path = talloc_asprintf(state->io_tcon,
 213                                                  "\\\\%s\\%s",
 214                                                  io->in.called_name,
 215                                                  io->in.service);
 216         NT_STATUS_HAVE_NO_MEMORY(state->io_tcon->tconx.in.path);
 217         if (!io->in.service_type) {
 218                 state->io_tcon->tconx.in.device = "?????";
 219         } else {
 220                 state->io_tcon->tconx.in.device = io->in.service_type;
 221         }
 222
 223         state->req = smb_raw_tcon_send(io->out.tree, state->io_tcon);
 224         NT_STATUS_HAVE_NO_MEMORY(state->req);
 225         if (state->req->state == SMBCLI_REQUEST_ERROR) {
 226                 return state->req->status;
 227         }
 228
 229         state->req->async.fn = request_handler;
 230         state->req->async.private = c;
 231         state->stage = CONNECT_TCON;
 232
 233         return NT_STATUS_OK;
 234 }
 235
 236 /*
 237   a negprot request has completed
 238 */
 239 static NTSTATUS connect_negprot(struct composite_context *c,
 240                                 struct smb_composite_connect *io)
 241 {
 242         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
 243         NTSTATUS status;
 244
 245         status = smb_raw_negotiate_recv(state->req);
 246         NT_STATUS_NOT_OK_RETURN(status);
 247
 248         /* next step is a session setup */
 249         state->session = smbcli_session_init(state->transport, state, True);
 250         NT_STATUS_HAVE_NO_MEMORY(state->session);
 251
 252         state->io_setup = talloc(c, struct smb_composite_sesssetup);
 253         NT_STATUS_HAVE_NO_MEMORY(state->io_setup);
 254
 255         /* prepare a session setup to establish a security context */
 256         state->io_setup->in.sesskey      = state->transport->negotiate.sesskey;
 257         state->io_setup->in.capabilities = state->transport->negotiate.capabilities;
 258         state->io_setup->in.credentials  = io->in.credentials;
 259         state->io_setup->in.workgroup    = io->in.workgroup;
 260
 261         state->creq = smb_composite_sesssetup_send(state->session, state->io_setup);
 262         NT_STATUS_HAVE_NO_MEMORY(state->creq);
 263         if (state->creq->state == COMPOSITE_STATE_ERROR) {
 264                 return state->creq->status;
 265         }
 266
 267         state->creq->async.fn = composite_handler;
 268         state->creq->async.private_data = c;
 269         state->stage = CONNECT_SESSION_SETUP;
 270
 271         return NT_STATUS_OK;
 272 }
 273
 274
 275 /*
 276   a session request operation has completed
 277 */
 278 static NTSTATUS connect_session_request(struct composite_context *c,
 279                                         struct smb_composite_connect *io)
 280 {
 281         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
 282         NTSTATUS status;
 283
 284         status = smbcli_transport_connect_recv(state->req);
 285         NT_STATUS_NOT_OK_RETURN(status);
 286
 287         /* next step is a negprot */
 288         return connect_send_negprot(c, io);
 289 }
 290
 291 /*
 292   a socket connection operation has completed
 293 */
 294 static NTSTATUS connect_socket(struct composite_context *c,
 295                                struct smb_composite_connect *io)
 296 {
 297         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
 298         NTSTATUS status;
 299         struct nbt_name calling, called;
 300
 301         status = smbcli_sock_connect_recv(state->creq, state, &state->sock);
 302         NT_STATUS_NOT_OK_RETURN(status);
 303
 304         /* the socket is up - we can initialise the smbcli transport layer */
 305         state->transport = smbcli_transport_init(state->sock, state, True);
 306         NT_STATUS_HAVE_NO_MEMORY(state->transport);
 307
 308         if (is_ipaddress(state->sock->hostname) &&
 309             (state->io->in.called_name != NULL)) {
 310                 /* If connecting to an IP address, we might want the real name
 311                  * of the host for later kerberos. The called name is a better
 312                  * approximation */
 313                 state->sock->hostname =
 314                         talloc_strdup(state->sock, io->in.called_name);
 315                 NT_STATUS_HAVE_NO_MEMORY(state->sock->hostname);
 316         }
 317
 318         make_nbt_name_client(&calling, cli_credentials_get_workstation(io->in.credentials));
 319
 320         nbt_choose_called_name(state, &called, io->in.called_name, NBT_NAME_SERVER);
 321
 322         /* we have a connected socket - next step is a session
 323            request, if needed. Port 445 doesn't need it, so it goes
 324            straight to the negprot */
 325         if (state->sock->port == 445) {
 326                 status = nbt_name_dup(state->transport, &called,
 327                                       &state->transport->called);
 328                 NT_STATUS_NOT_OK_RETURN(status);
 329                 return connect_send_negprot(c, io);
 330         }
 331
 332         state->req = smbcli_transport_connect_send(state->transport, &calling, &called);
 333         NT_STATUS_HAVE_NO_MEMORY(state->req);
 334
 335         state->req->async.fn = request_handler;
 336         state->req->async.private = c;
 337         state->stage = CONNECT_SESSION_REQUEST;
 338
 339         return NT_STATUS_OK;
 340 }
 341
 342
 343 /*
 344   called when name resolution is finished
 345 */
 346 static NTSTATUS connect_resolve(struct composite_context *c,
 347                                 struct smb_composite_connect *io)
 348 {
 349         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
 350         NTSTATUS status;
 351         const char *address;
 352
 353         status = resolve_name_recv(state->creq, state, &address);
 354         NT_STATUS_NOT_OK_RETURN(status);
 355
 356         state->creq = smbcli_sock_connect_send(state, address, io->in.port,
 357                                                io->in.dest_host, c->event_ctx);
 358         NT_STATUS_HAVE_NO_MEMORY(state->creq);
 359
 360         state->stage = CONNECT_SOCKET;
 361         state->creq->async.private_data = c;
 362         state->creq->async.fn = composite_handler;
 363
 364         return NT_STATUS_OK;
 365 }
 366
 367
 368 /*
 369   handle and dispatch state transitions
 370 */
 371 static void state_handler(struct composite_context *c)
 372 {
 373         struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
 374
 375         switch (state->stage) {
 376         case CONNECT_RESOLVE:
 377                 c->status = connect_resolve(c, state->io);
 378                 break;
 379         case CONNECT_SOCKET:
 380                 c->status = connect_socket(c, state->io);
 381                 break;
 382         case CONNECT_SESSION_REQUEST:
 383                 c->status = connect_session_request(c, state->io);
 384                 break;
 385         case CONNECT_NEGPROT:
 386                 c->status = connect_negprot(c, state->io);
 387                 break;
 388         case CONNECT_SESSION_SETUP:
 389                 c->status = connect_session_setup(c, state->io);
 390                 break;
 391         case CONNECT_SESSION_SETUP_ANON:
 392                 c->status = connect_session_setup_anon(c, state->io);
 393                 break;
 394         case CONNECT_TCON:
 395                 c->status = connect_tcon(c, state->io);
 396                 break;
 397         }
 398
 399         if (!NT_STATUS_IS_OK(c->status)) {
 400                 c->state = COMPOSITE_STATE_ERROR;
 401         }
 402
 403         if (c->state >= COMPOSITE_STATE_DONE &&
 404             c->async.fn) {
 405                 c->async.fn(c);
 406         }
 407 }
 408
 409
 410 /*
 411   handler for completion of a smbcli_request sub-request
 412 */
 413 static void request_handler(struct smbcli_request *req)
 414 {
 415         struct composite_context *c = talloc_get_type(req->async.private,
 416                                                      struct composite_context);
 417         state_handler(c);
 418 }
 419
 420 /*
 421   handler for completion of a smbcli_composite sub-request
 422 */
 423 static void composite_handler(struct composite_context *creq)
 424 {
 425         struct composite_context *c = talloc_get_type(creq->async.private_data,
 426                                                      struct composite_context);
 427         state_handler(c);
 428 }
 429
 430 /*
 431   a function to establish a smbcli_tree from scratch
 432 */
 433 struct composite_context *smb_composite_connect_send(struct smb_composite_connect *io,
 434                                                      TALLOC_CTX *mem_ctx,
 435                                                      struct event_context *event_ctx)
 436 {
 437         struct composite_context *c;
 438         struct connect_state *state;
 439         struct nbt_name name;
 440
 441         c = talloc_zero(mem_ctx, struct composite_context);
 442         if (c == NULL) goto failed;
 443
 444         state = talloc(c, struct connect_state);
 445         if (state == NULL) goto failed;
 446
 447         if (event_ctx == NULL) {
 448                 event_ctx = event_context_init(mem_ctx);
 449         }
 450
 451         state->io = io;
 452
 453         c->state = COMPOSITE_STATE_IN_PROGRESS;
 454         c->event_ctx = talloc_reference(c, event_ctx);
 455         c->private_data = state;
 456
 457         state->stage = CONNECT_RESOLVE;
 458         make_nbt_name_server(&name, io->in.dest_host);
 459         state->creq = resolve_name_send(&name, c->event_ctx, lp_name_resolve_order());
 460
 461         if (state->creq == NULL) goto failed;
 462         state->creq->async.private_data = c;
 463         state->creq->async.fn = composite_handler;
 464
 465         return c;
 466 failed:
 467         talloc_free(c);
 468         return NULL;
 469 }
 470
 471 /*
 472   recv half of async composite connect code
 473 */
 474 NTSTATUS smb_composite_connect_recv(struct composite_context *c, TALLOC_CTX *mem_ctx)
 475 {
 476         NTSTATUS status;
 477
 478         status = composite_wait(c);
 479
 480         if (NT_STATUS_IS_OK(status)) {
 481                 struct connect_state *state = talloc_get_type(c->private_data, struct connect_state);
 482                 talloc_steal(mem_ctx, state->io->out.tree);
 483         }
 484
 485         talloc_free(c);
 486         return status;
 487 }
 488
 489 /*
 490   sync version of smb_composite_connect
 491 */
 492 NTSTATUS smb_composite_connect(struct smb_composite_connect *io, TALLOC_CTX *mem_ctx,
 493                                struct event_context *ev)
 494 {
 495         struct composite_context *c = smb_composite_connect_send(io, mem_ctx, ev);
 496         return smb_composite_connect_recv(c, mem_ctx);
 497 }