lib/silcclient/client_keyagr.c

   1 /*
   2
   3   client_keyagr.c
   4
   5   Author: Pekka Riikonen <priikone@poseidon.pspt.fi>
   6
   7   Copyright (C) 2001 Pekka Riikonen
   8
   9   This program is free software; you can redistribute it and/or modify
  10   it under the terms of the GNU General Public License as published by
  11   the Free Software Foundation; either version 2 of the License, or
  12   (at your option) any later version.
  13
  14   This program is distributed in the hope that it will be useful,
  15   but WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17   GNU General Public License for more details.
  18
  19 */
  20 /* $Id$ */
  21 /* This file includes the Key Agreement packet processing and actual
  22    key agreement routines. This file has nothing to do with the actual
  23    connection key exchange protocol, it is implemented in the client.c
  24    and in protocol.c. This file implements the client-to-client key
  25    agreement as defined by the SILC protocol. */
  26
  27 #include "clientlibincludes.h"
  28 #include "client_internal.h"
  29
  30 SILC_TASK_CALLBACK(silc_client_key_agreement_final);
  31 SILC_TASK_CALLBACK(silc_client_process_key_agreement);
  32 SILC_TASK_CALLBACK(silc_client_key_agreement_timeout);
  33 SILC_TASK_CALLBACK(silc_client_perform_key_agreement_start);
  34
  35 /* Key agreement context */
  36 struct SilcClientKeyAgreementStruct {
  37   SilcClient client;
  38   SilcClientConnection conn;
  39   int fd;                                 /* Listening/connection socket */
  40   SilcSocketConnection sock;              /* Remote socket connection */
  41   SilcClientEntry client_entry;           /* Destination client */
  42   SilcKeyAgreementCallback completion;    /* Key agreement completion */
  43   void *context;                          /* User context */
  44   SilcTask timeout;                       /* Timeout task */
  45   SilcClientKEInternalContext *proto_ctx; /* Key Exchange protocol context */
  46 };
  47
  48 /* Packet sending function used by the SKE in the key agreement process. */
  49
  50 static void silc_client_key_agreement_send_packet(SilcSKE ske,
  51                                                   SilcBuffer packet,
  52                                                   SilcPacketType type,
  53                                                   void *context)
  54 {
  55   SilcProtocol protocol = (SilcProtocol)context;
  56   SilcClientKEInternalContext *ctx =
  57     (SilcClientKEInternalContext *)protocol->context;
  58   void *tmp;
  59
  60   /* Send the packet immediately. We will assure that the packet is not
  61      encrypted by setting the socket's user_data pointer to NULL. The
  62      silc_client_packet_send would take the keys (wrong keys that is,
  63      because user_data is the current SilcClientConnection) from it and
  64      we cannot allow that. The packets are never encrypted when doing SKE
  65      with another client. */
  66   tmp = ske->sock->user_data;
  67   ske->sock->user_data = NULL;
  68   silc_client_packet_send(ctx->client, ske->sock, type, NULL, 0, NULL, NULL,
  69                           packet->data, packet->len, TRUE);
  70   ske->sock->user_data = tmp;
  71 }
  72
  73 /* Timeout callback that is called to close the connection and free the
  74    socket connection data. */
  75
  76 SILC_TASK_CALLBACK(silc_client_key_agreement_close)
  77 {
  78   SilcClientKeyAgreement ke = (SilcClientKeyAgreement)context;
  79
  80   silc_schedule_unset_listen_fd(ke->client->schedule, ke->sock->sock);
  81   silc_schedule_unset_listen_fd(ke->client->schedule, ke->fd);
  82   silc_net_close_connection(ke->sock->sock);
  83   silc_net_close_connection(ke->fd);
  84   silc_socket_free(ke->sock);
  85   silc_free(ke);
  86 }
  87
  88 /* This callback is called after the key agreement protocol has been
  89    performed. This calls the final completion callback for the application. */
  90
  91 SILC_TASK_CALLBACK(silc_client_key_agreement_final)
  92 {
  93   SilcProtocol protocol = (SilcProtocol)context;
  94   SilcClientKEInternalContext *ctx =
  95     (SilcClientKEInternalContext *)protocol->context;
  96   SilcClient client = (SilcClient)ctx->client;
  97   SilcClientKeyAgreement ke = (SilcClientKeyAgreement)ctx->context;
  98
  99   SILC_LOG_DEBUG(("Start"));
 100
 101   if (protocol->state == SILC_PROTOCOL_STATE_ERROR ||
 102       protocol->state == SILC_PROTOCOL_STATE_FAILURE) {
 103     /* Error occured during protocol */
 104     ke->client_entry->ke = NULL;
 105     ke->completion(ke->client, ke->conn, ke->client_entry,
 106                    SILC_KEY_AGREEMENT_ERROR, NULL, ke->context);
 107     silc_ske_free_key_material(ctx->keymat);
 108     goto out;
 109   }
 110
 111   /* Pass the negotiated key material to the application. The application
 112      is responsible of freeing the key material. */
 113   ke->client_entry->ke = NULL;
 114   ke->completion(ke->client, ke->conn, ke->client_entry,
 115                  SILC_KEY_AGREEMENT_OK, ctx->keymat, ke->context);
 116
 117  out:
 118   silc_protocol_free(protocol);
 119   if (ctx->ske)
 120     silc_ske_free(ctx->ske);
 121   if (ctx->dest_id)
 122     silc_free(ctx->dest_id);
 123   silc_schedule_task_del_by_fd(client->schedule, ke->fd);
 124   silc_schedule_unset_listen_fd(ke->client->schedule, ke->fd);
 125   silc_net_close_connection(ke->fd);
 126   if (ke->timeout)
 127     silc_schedule_task_del(client->schedule, ke->timeout);
 128   silc_client_del_socket(ke->client, ke->sock);
 129
 130   silc_schedule_task_add(client->schedule, 0,
 131                      silc_client_key_agreement_close,
 132                      (void *)ke, 0, 1,
 133                      SILC_TASK_TIMEOUT, SILC_TASK_PRI_NORMAL);
 134
 135   silc_free(ctx);
 136 }
 137
 138 /* Key agreement callback that is called when remote end has initiated
 139    the key agreement protocol. This accepts the incoming TCP/IP connection
 140    for the key agreement protocol. */
 141
 142 SILC_TASK_CALLBACK(silc_client_process_key_agreement)
 143 {
 144   SilcClientKeyAgreement ke = (SilcClientKeyAgreement)context;
 145   SilcClient client = ke->client;
 146   SilcClientConnection conn = ke->conn;
 147   SilcSocketConnection newsocket;
 148   SilcClientKEInternalContext *proto_ctx;
 149   int sock;
 150
 151   SILC_LOG_DEBUG(("Start"));
 152
 153   sock = silc_net_accept_connection(ke->fd);
 154   if (sock < 0) {
 155     client->internal->ops->say(client, conn, SILC_CLIENT_MESSAGE_AUDIT,
 156                                "Could not accept key agreement connection: ",
 157                                strerror(errno));
 158     ke->client_entry->ke = NULL;
 159     ke->completion(ke->client, ke->conn, ke->client_entry,
 160                    SILC_KEY_AGREEMENT_ERROR, NULL, ke->context);
 161     silc_schedule_task_del_by_fd(client->schedule, ke->fd);
 162     silc_schedule_unset_listen_fd(ke->client->schedule, ke->fd);
 163     silc_net_close_connection(ke->fd);
 164     if (ke->timeout)
 165       silc_schedule_task_del(client->schedule, ke->timeout);
 166     silc_free(ke);
 167     return;
 168   }
 169
 170   /* Set socket options */
 171   silc_net_set_socket_nonblock(sock);
 172   silc_net_set_socket_opt(sock, SOL_SOCKET, SO_REUSEADDR, 1);
 173
 174   /* Create socket for this connection (it is of type UNKNOWN since this
 175      really is not a real SILC connection. It is only for the key
 176      agreement protocol). */
 177   silc_socket_alloc(sock, SILC_SOCKET_TYPE_UNKNOWN, (void *)conn, &newsocket);
 178   ke->sock = newsocket;
 179
 180   /* Perform name and address lookups for the remote host. */
 181   silc_net_check_host_by_sock(sock, &newsocket->hostname, &newsocket->ip);
 182   if (!newsocket->hostname && !newsocket->ip) {
 183     client->internal->ops->say(client, conn, SILC_CLIENT_MESSAGE_AUDIT,
 184                                "Could not resolve the remote IP or hostname");
 185     ke->client_entry->ke = NULL;
 186     ke->completion(ke->client, ke->conn, ke->client_entry,
 187                    SILC_KEY_AGREEMENT_ERROR, NULL, ke->context);
 188     silc_schedule_task_del_by_fd(client->schedule, ke->fd);
 189     silc_schedule_unset_listen_fd(ke->client->schedule, ke->fd);
 190     silc_net_close_connection(ke->fd);
 191     if (ke->timeout)
 192       silc_schedule_task_del(client->schedule, ke->timeout);
 193     silc_free(ke);
 194     return;
 195   }
 196   if (!newsocket->hostname)
 197     newsocket->hostname = strdup(newsocket->ip);
 198   newsocket->port = silc_net_get_remote_port(sock);
 199   silc_client_add_socket(client, newsocket);
 200
 201   /* Allocate internal context for key exchange protocol. This is
 202      sent as context for the protocol. */
 203   proto_ctx = silc_calloc(1, sizeof(*proto_ctx));
 204   proto_ctx->client = client;
 205   proto_ctx->sock = silc_socket_dup(newsocket);
 206   proto_ctx->rng = client->rng;
 207   proto_ctx->responder = TRUE;
 208   proto_ctx->context = context;
 209   proto_ctx->send_packet = silc_client_key_agreement_send_packet;
 210   proto_ctx->verify = silc_client_protocol_ke_verify_key;
 211   ke->proto_ctx = proto_ctx;
 212
 213   /* Prepare the connection for key exchange protocol. We allocate the
 214      protocol but will not start it yet. The connector will be the
 215      initiator of the protocol thus we will wait for initiation from
 216      there before we start the protocol. */
 217   silc_protocol_alloc(SILC_PROTOCOL_CLIENT_KEY_EXCHANGE,
 218                       &newsocket->protocol, proto_ctx,
 219                       silc_client_key_agreement_final);
 220
 221   /* Register the connection for network input and output. This sets
 222      that scheduler will listen for incoming packets for this connection
 223      and sets that outgoing packets may be sent to this connection as well.
 224      However, this doesn't set the scheduler for outgoing traffic, it
 225      will be set separately by calling SILC_CLIENT_SET_CONNECTION_FOR_OUTPUT,
 226      later when outgoing data is available. */
 227   context = (void *)client;
 228   SILC_CLIENT_REGISTER_CONNECTION_FOR_IO(sock);
 229 }
 230
 231 /* Timeout occured during key agreement. This means that the key agreement
 232    protocol was not completed in the specified timeout. We will call the
 233    completion callback. */
 234
 235 SILC_TASK_CALLBACK(silc_client_key_agreement_timeout)
 236 {
 237   SilcClientKeyAgreement ke = (SilcClientKeyAgreement)context;
 238
 239   ke->client_entry->ke = NULL;
 240   ke->completion(ke->client, ke->conn, ke->client_entry,
 241                  SILC_KEY_AGREEMENT_TIMEOUT, NULL, ke->context);
 242
 243   if (ke->sock) {
 244     silc_client_del_socket(ke->client, ke->sock);
 245     silc_socket_free(ke->sock);
 246   }
 247   if (ke->proto_ctx && ke->proto_ctx->ske)
 248     silc_ske_free(ke->proto_ctx->ske);
 249   ke->client_entry->ke = NULL;
 250   if (ke->fd)
 251     silc_schedule_task_del_by_fd(ke->client->schedule, ke->fd);
 252   silc_schedule_unset_listen_fd(ke->client->schedule, ke->fd);
 253   silc_net_close_connection(ke->fd);
 254   silc_free(ke);
 255 }
 256
 257 /* Sends key agreement request to the remote client indicated by the
 258    `client_entry'. If the caller provides the `hostname' and the `port'
 259    arguments then the library will bind the client to that hostname and
 260    that port for the key agreement protocol. It also sends the `hostname'
 261    and the `port' in the key agreement packet to the remote client. This
 262    would indicate that the remote client may initiate the key agreement
 263    protocol to the `hostname' on the `port'.  If port is zero then the
 264    bound port is undefined (the operating system defines it).
 265
 266    If the `hostname' and `port' is not provided then empty key agreement
 267    packet is sent to the remote client. The remote client may reply with
 268    the same packet including its hostname and port. If the library receives
 269    the reply from the remote client the `key_agreement' client operation
 270    callback will be called to verify whether the user wants to perform the
 271    key agreement or not.
 272
 273    NOTE: If the application provided the `hostname' and the `port' and the
 274    remote side initiates the key agreement protocol it is not verified
 275    from the user anymore whether the protocol should be executed or not.
 276    By setting the `hostname' and `port' the user gives permission to
 277    perform the protocol (we are responder in this case).
 278
 279    NOTE: If the remote side decides not to initiate the key agreement
 280    or decides not to reply with the key agreement packet then we cannot
 281    perform the key agreement at all. If the key agreement protocol is
 282    performed the `completion' callback with the `context' will be called.
 283    If remote side decides to ignore the request the `completion' will be
 284    called after the specified timeout, `timeout_secs'.
 285
 286    NOTE: If the `hostname' and the `port' was not provided the `completion'
 287    will not be called at all since this does nothing more than sending
 288    a packet to the remote host.
 289
 290    NOTE: There can be only one active key agreement for one client entry.
 291    Before setting new one, the old one must be finished (it is finished
 292    after calling the completion callback) or the function
 293    silc_client_abort_key_agreement must be called. */
 294
 295 void silc_client_send_key_agreement(SilcClient client,
 296                                     SilcClientConnection conn,
 297                                     SilcClientEntry client_entry,
 298                                     const char *hostname,
 299                                     const char *bindhost,
 300                                     int port,
 301                                     uint32 timeout_secs,
 302                                     SilcKeyAgreementCallback completion,
 303                                     void *context)
 304 {
 305   SilcSocketConnection sock = conn->sock;
 306   SilcClientKeyAgreement ke = NULL;
 307   SilcBuffer buffer;
 308
 309   if (!client_entry || client_entry->ke)
 310     return;
 311
 312   /* Create the listener if hostname and port was provided.
 313    * also, use bindhost if it was specified.
 314    */
 315
 316   if (hostname) {
 317     ke = silc_calloc(1, sizeof(*ke));
 318
 319     if (bindhost)
 320       ke->fd = silc_net_create_server(port, bindhost);
 321     else
 322       ke->fd = silc_net_create_server(port, hostname);
 323
 324     if (ke->fd < 0) {
 325       client->internal->ops->say(
 326                      client, conn, SILC_CLIENT_MESSAGE_ERROR,
 327                      "Cannot create listener on %s on port %d: %s",
 328                      (bindhost) ? bindhost:hostname, port, strerror(errno));
 329       completion(client, conn, client_entry, SILC_KEY_AGREEMENT_FAILURE,
 330                  NULL, context);
 331       silc_free(ke);
 332
 333       return;
 334     }
 335
 336     ke->client = client;
 337     ke->conn = conn;
 338     ke->client_entry = client_entry;
 339     ke->completion = completion;
 340     ke->context = context;
 341
 342     /* Add listener task to the scheduler. This task receives the key
 343        negotiations. */
 344     silc_schedule_task_add(client->schedule, ke->fd,
 345                            silc_client_process_key_agreement,
 346                            (void *)ke, 0, 0,
 347                            SILC_TASK_FD,
 348                            SILC_TASK_PRI_NORMAL);
 349
 350     /* Register a timeout task that will be executed if the connector
 351        will not start the key exchange protocol within the specified
 352        timeout. */
 353     ke->timeout = silc_schedule_task_add(client->schedule, 0,
 354                                          silc_client_key_agreement_timeout,
 355                                          (void *)ke, timeout_secs, 0,
 356                                          SILC_TASK_TIMEOUT, SILC_TASK_PRI_LOW);
 357   }
 358
 359   /* Encode the key agreement payload */
 360   buffer = silc_key_agreement_payload_encode(hostname,
 361                                              !ke ? port :
 362                                              silc_net_get_local_port(ke->fd));
 363
 364   /* Send the key agreement packet to the client */
 365   silc_client_packet_send(client, sock, SILC_PACKET_KEY_AGREEMENT,
 366                           client_entry->id, SILC_ID_CLIENT, NULL, NULL,
 367                           buffer->data, buffer->len, FALSE);
 368   silc_buffer_free(buffer);
 369
 370 }
 371
 372 static int
 373 silc_client_connect_to_client_internal(SilcClientInternalConnectContext *ctx)
 374 {
 375   int sock;
 376
 377   /* Create connection to server asynchronously */
 378   sock = silc_net_create_connection_async(NULL, ctx->port, ctx->host);
 379   if (sock < 0)
 380     return -1;
 381
 382   /* Register task that will receive the async connect and will
 383      read the result. */
 384   ctx->task = silc_schedule_task_add(ctx->client->schedule, sock,
 385                                      silc_client_perform_key_agreement_start,
 386                                      (void *)ctx, 0, 0,
 387                                      SILC_TASK_FD,
 388                                      SILC_TASK_PRI_NORMAL);
 389   silc_schedule_set_listen_fd(ctx->client->schedule, sock, SILC_TASK_WRITE);
 390
 391   ctx->sock = sock;
 392
 393   return sock;
 394 }
 395
 396 /* Routine used by silc_client_perform_key_agreement to create connection
 397    to the remote client on specified port. */
 398
 399 static int
 400 silc_client_connect_to_client(SilcClient client,
 401                               SilcClientConnection conn, int port,
 402                               char *host, void *context)
 403 {
 404   SilcClientInternalConnectContext *ctx;
 405
 406   /* Allocate internal context for connection process. This is
 407      needed as we are doing async connecting. */
 408   ctx = silc_calloc(1, sizeof(*ctx));
 409   ctx->client = client;
 410   ctx->conn = conn;
 411   ctx->host = strdup(host);
 412   ctx->port = port;
 413   ctx->tries = 0;
 414   ctx->context = context;
 415
 416   /* Do the actual connecting process */
 417   return silc_client_connect_to_client_internal(ctx);
 418 }
 419
 420 /* Callback that is called after connection has been created. This actually
 421    starts the key agreement protocol. This is initiator function. */
 422
 423 SILC_TASK_CALLBACK(silc_client_perform_key_agreement_start)
 424 {
 425   SilcClientInternalConnectContext *ctx =
 426     (SilcClientInternalConnectContext *)context;
 427   SilcClient client = ctx->client;
 428   SilcClientConnection conn = ctx->conn;
 429   SilcClientKeyAgreement ke = (SilcClientKeyAgreement)ctx->context;
 430   int opt, opt_len = sizeof(opt);
 431
 432   SILC_LOG_DEBUG(("Start"));
 433
 434   /* Check the socket status as it might be in error */
 435   silc_net_get_socket_opt(fd, SOL_SOCKET, SO_ERROR, &opt, &opt_len);
 436   if (opt != 0) {
 437     if (ctx->tries < 2) {
 438       /* Connection failed but lets try again */
 439       client->internal->ops->say(client, conn, SILC_CLIENT_MESSAGE_ERROR,
 440                                  "Could not connect to client %s: %s",
 441                                  ctx->host, strerror(opt));
 442       client->internal->ops->say(client, conn, SILC_CLIENT_MESSAGE_AUDIT,
 443                                  "Connecting to port %d of client %s resumed",
 444                                  ctx->port, ctx->host);
 445
 446       /* Unregister old connection try */
 447       silc_schedule_unset_listen_fd(client->schedule, fd);
 448       silc_net_close_connection(fd);
 449       silc_schedule_task_del(client->schedule, ctx->task);
 450
 451       /* Try again */
 452       silc_client_connect_to_client_internal(ctx);
 453       ctx->tries++;
 454     } else {
 455       /* Connection failed and we won't try anymore */
 456       client->internal->ops->say(client, conn, SILC_CLIENT_MESSAGE_ERROR,
 457                                  "Could not connect to client %s: %s",
 458                                  ctx->host, strerror(opt));
 459       silc_schedule_unset_listen_fd(client->schedule, fd);
 460       silc_net_close_connection(fd);
 461       silc_schedule_task_del(client->schedule, ctx->task);
 462       silc_free(ctx->host);
 463       silc_free(ctx);
 464
 465       /* Call the completion callback */
 466       ke->completion(ke->client, ke->conn, ke->client_entry,
 467                      SILC_KEY_AGREEMENT_FAILURE, NULL, ke->context);
 468       silc_free(ke);
 469     }
 470     return;
 471   }
 472
 473   silc_schedule_unset_listen_fd(client->schedule, fd);
 474   silc_schedule_task_del(client->schedule, ctx->task);
 475
 476   ke->fd = fd;
 477
 478   /* Now actually perform the key agreement protocol */
 479   silc_client_perform_key_agreement_fd(ke->client, ke->conn,
 480                                        ke->client_entry, ke->fd, ctx->host,
 481                                        ke->completion, ke->context);
 482   silc_free(ke);
 483   silc_free(ctx->host);
 484   silc_free(ctx);
 485 }
 486
 487 /* Performs the actual key agreement protocol. Application may use this
 488    to initiate the key agreement protocol. This can be called for example
 489    after the application has received the `key_agreement' client operation,
 490    and did not return TRUE from it.
 491
 492    The `hostname' is the remote hostname (or IP address) and the `port'
 493    is the remote port. The `completion' callback with the `context' will
 494    be called after the key agreement protocol.
 495
 496    NOTE: If the application returns TRUE in the `key_agreement' client
 497    operation the library will automatically start the key agreement. In this
 498    case the application must not call this function. However, application
 499    may choose to just ignore the `key_agreement' client operation (and
 500    merely just print information about it on the screen) and call this
 501    function when the user whishes to do so (by, for example, giving some
 502    specific command). Thus, the API provides both, automatic and manual
 503    initiation of the key agreement. Calling this function is the manual
 504    initiation and returning TRUE in the `key_agreement' client operation
 505    is the automatic initiation. */
 506
 507 void silc_client_perform_key_agreement(SilcClient client,
 508                                        SilcClientConnection conn,
 509                                        SilcClientEntry client_entry,
 510                                        char *hostname,
 511                                        int port,
 512                                        SilcKeyAgreementCallback completion,
 513                                        void *context)
 514 {
 515   SilcClientKeyAgreement ke;
 516
 517   SILC_LOG_DEBUG(("Start"));
 518
 519   if (!client_entry || !hostname || !port)
 520     return;
 521
 522   ke = silc_calloc(1, sizeof(*ke));
 523   ke->client = client;
 524   ke->conn = conn;
 525   ke->client_entry = client_entry;
 526   ke->completion = completion;
 527   ke->context = context;
 528
 529   /* Connect to the remote client */
 530   ke->fd = silc_client_connect_to_client(client, conn, port, hostname, ke);
 531   if (ke->fd < 0) {
 532     completion(client, conn, client_entry, SILC_KEY_AGREEMENT_FAILURE,
 533                NULL, context);
 534     silc_free(ke);
 535     return;
 536   }
 537 }
 538
 539 /* Same as above but application has created already the connection to
 540    the remote host. The `sock' is the socket to the remote connection.
 541    Application can use this function if it does not want the client library
 542    to create the connection. */
 543
 544 void silc_client_perform_key_agreement_fd(SilcClient client,
 545                                           SilcClientConnection conn,
 546                                           SilcClientEntry client_entry,
 547                                           int sock,
 548                                           char *hostname,
 549                                           SilcKeyAgreementCallback completion,
 550                                           void *context)
 551 {
 552   SilcClientKeyAgreement ke;
 553   SilcClientKEInternalContext *proto_ctx;
 554   SilcProtocol protocol;
 555
 556   SILC_LOG_DEBUG(("Start"));
 557
 558   if (!client_entry)
 559     return;
 560
 561   ke = silc_calloc(1, sizeof(*ke));
 562   ke->client = client;
 563   ke->conn = conn;
 564   ke->client_entry = client_entry;
 565   ke->fd = sock;
 566   ke->completion = completion;
 567   ke->context = context;
 568
 569   /* Allocate new socket connection object */
 570   silc_socket_alloc(sock, SILC_SOCKET_TYPE_UNKNOWN, (void *)conn, &ke->sock);
 571   silc_client_add_socket(client, ke->sock);
 572   ke->sock->hostname = strdup(hostname);
 573   ke->sock->port = silc_net_get_remote_port(sock);
 574
 575   /* Allocate internal context for key exchange protocol. This is
 576      sent as context for the protocol. */
 577   proto_ctx = silc_calloc(1, sizeof(*proto_ctx));
 578   proto_ctx->client = client;
 579   proto_ctx->sock = silc_socket_dup(ke->sock);
 580   proto_ctx->rng = client->rng;
 581   proto_ctx->responder = FALSE;
 582   proto_ctx->context = ke;
 583   proto_ctx->send_packet = silc_client_key_agreement_send_packet;
 584   proto_ctx->verify = silc_client_protocol_ke_verify_key;
 585   ke->proto_ctx = proto_ctx;
 586
 587   /* Perform key exchange protocol. */
 588   silc_protocol_alloc(SILC_PROTOCOL_CLIENT_KEY_EXCHANGE,
 589                       &protocol, (void *)proto_ctx,
 590                       silc_client_key_agreement_final);
 591   ke->sock->protocol = protocol;
 592
 593   /* Register the connection for network input and output. This sets
 594      that scheduler will listen for incoming packets for this connection
 595      and sets that outgoing packets may be sent to this connection as well.
 596      However, this doesn't set the scheduler for outgoing traffic, it will
 597      be set separately by calling SILC_CLIENT_SET_CONNECTION_FOR_OUTPUT,
 598      later when outgoing data is available. */
 599   context = (void *)client;
 600   SILC_CLIENT_REGISTER_CONNECTION_FOR_IO(sock);
 601
 602   /* Execute the protocol */
 603   silc_protocol_execute(protocol, client->schedule, 0, 0);
 604 }
 605
 606 /* This function can be called to unbind the hostname and the port for
 607    the key agreement protocol. However, this function has effect only
 608    before the key agreement protocol has been performed. After it has
 609    been performed the library will automatically unbind the port. The
 610    `client_entry' is the client to which we sent the key agreement
 611    request. */
 612
 613 void silc_client_abort_key_agreement(SilcClient client,
 614                                      SilcClientConnection conn,
 615                                      SilcClientEntry client_entry)
 616 {
 617   if (!client_entry)
 618     return;
 619
 620   if (client_entry->ke) {
 621     SilcClientKeyAgreement ke;
 622
 623     if (client_entry->ke->sock) {
 624       silc_client_del_socket(client_entry->ke->client, client_entry->ke->sock);
 625       silc_socket_free(client_entry->ke->sock);
 626     }
 627     silc_schedule_task_del_by_fd(client->schedule, client_entry->ke->fd);
 628     if (client_entry->ke->timeout)
 629       silc_schedule_task_del(client->schedule,
 630                              client_entry->ke->timeout);
 631     ke = client_entry->ke;
 632     client_entry->ke = NULL;
 633     ke->completion(client, conn, client_entry,
 634                    SILC_KEY_AGREEMENT_ABORTED, NULL, ke->context);
 635     silc_free(ke);
 636   }
 637 }
 638
 639 /* Callback function that is called after we've resolved the client
 640    information who sent us the key agreement packet from the server.
 641    We actually call the key_agreement client operation now. */
 642
 643 static void
 644 silc_client_key_agreement_resolve_cb(SilcClient client,
 645                                      SilcClientConnection conn,
 646                                      SilcClientEntry *clients,
 647                                      uint32 clients_count,
 648                                      void *context)
 649 {
 650   SilcPacketContext *packet = (SilcPacketContext *)context;
 651   SilcKeyAgreementPayload payload;
 652   int ret;
 653   SilcKeyAgreementCallback completion;
 654   void *completion_context;
 655
 656   if (!clients)
 657     goto out;
 658
 659   /* Parse the key agreement payload */
 660   payload = silc_key_agreement_payload_parse(packet->buffer->data,
 661                                              packet->buffer->len);
 662   if (!payload)
 663     goto out;
 664
 665   /* Call the key_agreement client operation */
 666   ret = client->internal->ops->key_agreement(
 667                                    client, conn, clients[0],
 668                                    silc_key_agreement_get_hostname(payload),
 669                                    silc_key_agreement_get_port(payload),
 670                                    &completion, &completion_context);
 671
 672   /* If the user returned TRUE then we'll start the key agreement right
 673      here and right now. */
 674   if (ret == TRUE)
 675     silc_client_perform_key_agreement(client, conn, clients[0],
 676                                       silc_key_agreement_get_hostname(payload),
 677                                       silc_key_agreement_get_port(payload),
 678                                       completion, completion_context);
 679
 680   silc_key_agreement_payload_free(payload);
 681
 682  out:
 683   silc_packet_context_free(packet);
 684 }
 685
 686 /* Received Key Agreement packet from remote client. Process the packet
 687    and resolve the client information from the server before actually
 688    letting the application know that we've received this packet.  Then
 689    call the key_agreement client operation and let the user decide
 690    whether we perform the key agreement protocol now or not. */
 691
 692 void silc_client_key_agreement(SilcClient client,
 693                                SilcSocketConnection sock,
 694                                SilcPacketContext *packet)
 695 {
 696   SilcClientID *remote_id;
 697
 698   if (packet->src_id_type != SILC_ID_CLIENT)
 699     return;
 700
 701   remote_id = silc_id_str2id(packet->src_id, packet->src_id_len,
 702                              SILC_ID_CLIENT);
 703   if (!remote_id)
 704     return;
 705
 706   silc_client_get_client_by_id_resolve(client, sock->user_data, remote_id,
 707                                        silc_client_key_agreement_resolve_cb,
 708                                        silc_packet_context_dup(packet));
 709   silc_free(remote_id);
 710 }