Handle tids connections from rudimentary event loop in main().
[trust_router.git] / tid / tids.c
index 3e13394..2ebe887 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, JANET(UK)
+ * Copyright (c) 2012, 2015, JANET(UK)
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  *
  */
 
+#include <assert.h>
 #include <stdlib.h>
 #include <unistd.h>
+#include <fcntl.h>
 #include <string.h>
 #include <stdio.h>
 #include <errno.h>
 #include <sys/socket.h>
+#include <sys/wait.h>
 #include <netinet/in.h>
 #include <jansson.h>
-
-#include <trust_router/tid.h>
+#include <talloc.h>
+#include <tid_internal.h>
 #include <gsscon.h>
+#include <tr_debug.h>
 #include <tr_msg.h>
 
+static TID_RESP *tids_create_response (TIDS_INSTANCE *tids, TID_REQ *req) 
+{
+  TID_RESP *resp;
+
+  if ((NULL == (resp = talloc_zero(req, TID_RESP)))) {
+    tr_crit("tids_create_response: Error allocating response structure.");
+    return NULL;
+  }
+  
+  resp->result = TID_SUCCESS; /* presume success */
+  if ((NULL == (resp->rp_realm = tr_dup_name(req->rp_realm))) ||
+      (NULL == (resp->realm = tr_dup_name(req->realm))) ||
+      (NULL == (resp->comm = tr_dup_name(req->comm)))) {
+    tr_crit("tids_create_response: Error allocating fields in response.");
+    return NULL;
+  }
+  if (req->orig_coi) {
+    if (NULL == (resp->orig_coi = tr_dup_name(req->orig_coi))) {
+      tr_crit("tids_create_response: Error allocating fields in response.");
+      return NULL;
+    }
+  }
+  return resp;
+}
+
+static void tids_destroy_response(TIDS_INSTANCE *tids, TID_RESP *resp) 
+{
+  if (resp) {
+    if (resp->err_msg)
+      tr_free_name(resp->err_msg);
+    if (resp->rp_realm)
+      tr_free_name(resp->rp_realm);
+    if (resp->realm)
+      tr_free_name(resp->realm);
+    if (resp->comm)
+      tr_free_name(resp->comm);
+    if (resp->orig_coi)
+      tr_free_name(resp->orig_coi);
+    talloc_free(resp);
+  }
+}
+
 static int tids_listen (TIDS_INSTANCE *tids, int port) 
 {
     int rc = 0;
     int conn = -1;
-    struct sockaddr_storage addr;
-    struct sockaddr_in *saddr = (struct sockaddr_in *) &addr;
-    
+    int optval = 1;
+
+    union {
+      struct sockaddr_storage storage;
+      struct sockaddr_in in4;
+    } addr;
+
+    struct sockaddr_in *saddr = (struct sockaddr_in *) &addr.in4;
+
     saddr->sin_port = htons (port);
     saddr->sin_family = AF_INET;
     saddr->sin_addr.s_addr = INADDR_ANY;
 
     if (0 > (conn = socket (AF_INET, SOCK_STREAM, 0)))
       return conn;
-        
+
+    setsockopt(conn, SOL_SOCKET, SO_REUSEADDR, &optval, sizeof(optval));
+
     if (0 > (rc = bind (conn, (struct sockaddr *) saddr, sizeof(struct sockaddr_in))))
       return rc;
-        
+
     if (0 > (rc = listen(conn, 512)))
       return rc;
-    
-    fprintf (stdout, "TID Server listening on port %d\n", port);
-    return conn; 
+
+    tr_debug("tids_listen: TID Server listening on port %d", port);
+    return conn;
 }
 
-static int tids_auth_connection (int conn, gss_ctx_id_t *gssctx)
+/* returns EACCES if authorization is denied */
+static int tids_auth_cb(gss_name_t clientName, gss_buffer_t displayName,
+                       void *data)
+{
+  struct tids_instance *inst = (struct tids_instance *) data;
+  TR_NAME name ={(char *) displayName->value,
+                displayName->length};
+  int result=0;
+
+  if (0!=inst->auth_handler(clientName, &name, inst->cookie)) {
+    tr_debug("tids_auth_cb: client '%.*s' denied authorization.", name.len, name.buf);
+    result=EACCES; /* denied */
+  }
+
+  return result;
+}
+
+/* returns 0 on authorization success, 1 on failure, or -1 in case of error */
+static int tids_auth_connection (struct tids_instance *inst,
+                                int conn, gss_ctx_id_t *gssctx)
 {
   int rc = 0;
   int auth, autherr = 0;
+  gss_buffer_desc nameBuffer = {0, NULL};
+  char *name = 0;
+  int nameLen = 0;
 
-  if (rc = gsscon_passive_authenticate(conn, gssctx)) {
-    fprintf(stderr, "Error from gsscon_passive_authenticate(), rc = %d.\n", rc);
+  nameLen = asprintf(&name, "trustidentity@%s", inst->hostname);
+  nameBuffer.length = nameLen;
+  nameBuffer.value = name;
+  
+  if (rc = gsscon_passive_authenticate(conn, nameBuffer, gssctx, tids_auth_cb, inst)) {
+    tr_debug("tids_auth_connection: Error from gsscon_passive_authenticate(), rc = %d.", rc);
     return -1;
   }
 
   if (rc = gsscon_authorize(*gssctx, &auth, &autherr)) {
-    fprintf(stderr, "Error from gsscon_authorize, rc = %d, autherr = %d.\n", 
+    tr_debug("tids_auth_connection: Error from gsscon_authorize, rc = %d, autherr = %d.", 
            rc, autherr);
     return -1;
   }
 
   if (auth)
-    fprintf(stdout, "Connection authenticated, conn = %d.\n", conn);
+    tr_debug("tids_auth_connection: Connection authenticated, conn = %d.", conn);
   else
-    fprintf(stderr, "Authentication failed, conn %d.\n", conn);
+    tr_debug("tids_auth_connection: Authentication failed, conn %d.", conn);
 
-  return auth;
+  return !auth;
 }
 
 static int tids_read_request (TIDS_INSTANCE *tids, int conn, gss_ctx_id_t *gssctx, TR_MSG **mreq)
@@ -105,18 +185,18 @@ static int tids_read_request (TIDS_INSTANCE *tids, int conn, gss_ctx_id_t *gssct
     return -1;
   }
 
-  fprintf(stdout, "tids_read_request():Request Received, %d bytes.\n", buflen);
+  tr_debug("tids_read_request():Request Received, %u bytes.", (unsigned) buflen);
 
   /* Parse request */
   if (NULL == ((*mreq) = tr_msg_decode(buf, buflen))) {
-    printf("tids_read_request():Error decoding request.\n");
+    tr_debug("tids_read_request():Error decoding request.");
     free (buf);
     return -1;
   }
 
   /* If this isn't a TID Request, just drop it. */
   if (TID_REQUEST != (*mreq)->msg_type) {
-    printf("tids_read_request(): Not a TID Request, dropped.\n");
+    tr_debug("tids_read_request(): Not a TID Request, dropped.");
     return -1;
   }
 
@@ -124,61 +204,108 @@ static int tids_read_request (TIDS_INSTANCE *tids, int conn, gss_ctx_id_t *gssct
   return buflen;
 }
 
-static int tids_handle_request (TIDS_INSTANCE *tids, TR_MSG *mreq, TID_RESP **resp) 
+static int tids_handle_request (TIDS_INSTANCE *tids, TR_MSG *mreq, TID_RESP *resp) 
 {
   int rc;
 
   /* Check that this is a valid TID Request.  If not, send an error return. */
-  if ((!mreq->tid_req) ||
-      (!mreq->tid_req->rp_realm) ||
-      (!mreq->tid_req->realm) ||
-      (!mreq->tid_req->comm)) {
-    printf("tids_handle_request():Not a valid TID Request.\n");
-    (*resp)->result = TID_ERROR;
-    (*resp)->err_msg = tr_new_name("Bad request format");
+  if ((!tr_msg_get_req(mreq)) ||
+      (!tr_msg_get_req(mreq)->rp_realm) ||
+      (!tr_msg_get_req(mreq)->realm) ||
+      (!tr_msg_get_req(mreq)->comm)) {
+    tr_notice("tids_handle_request(): Not a valid TID Request.");
+    resp->result = TID_ERROR;
+    resp->err_msg = tr_new_name("Bad request format");
     return -1;
   }
 
+  tid_req_add_path(tr_msg_get_req(mreq), tids->hostname, tids->tids_port);
+  
   /* Call the caller's request handler */
   /* TBD -- Handle different error returns/msgs */
-  if (0 > (rc = (*tids->req_handler)(tids, mreq->tid_req, &(*resp), tids->cookie))) {
+  if (0 > (rc = (*tids->req_handler)(tids, tr_msg_get_req(mreq), resp, tids->cookie))) {
     /* set-up an error response */
-    (*resp)->result = TID_ERROR;
-    if (!(*resp)->err_msg)     /* Use msg set by handler, if any */
-      (*resp)->err_msg = tr_new_name("Internal processing error");
+    resp->result = TID_ERROR;
+    if (!resp->err_msg)        /* Use msg set by handler, if any */
+      resp->err_msg = tr_new_name("Internal processing error");
   }
   else {
     /* set-up a success response */
-    (*resp)->result = TID_SUCCESS;
-    (*resp)->err_msg = NULL;   /* No msg on successful return */
+    resp->result = TID_SUCCESS;
+    resp->err_msg = NULL;      /* No error msg on successful return */
   }
     
   return rc;
 }
 
-int tids_send_response (TIDS_INSTANCE *tids, int conn, gss_ctx_id_t *gssctx, TID_RESP *resp)
+int tids_send_err_response (TIDS_INSTANCE *tids, TID_REQ *req, const char *err_msg) {
+  TID_RESP *resp = NULL;
+  int rc = 0;
+
+  /* If we already sent a response, don't send another no matter what. */
+  if (req->resp_sent)
+    return 0;
+
+  if (NULL == (resp = tids_create_response(tids, req))) {
+    tr_crit("tids_send_err_response: Can't create response.");
+    return -1;
+  }
+
+  
+  /* mark this as an error response, and include the error message */
+  resp->result = TID_ERROR;
+  resp->err_msg = tr_new_name((char *)err_msg);
+  resp->error_path = req->path;
+
+  rc = tids_send_response(tids, req, resp);
+  
+  tids_destroy_response(tids, resp);
+  return rc;
+}
+
+int tids_send_response (TIDS_INSTANCE *tids, TID_REQ *req, TID_RESP *resp)
 {
   int err;
   TR_MSG mresp;
   char *resp_buf;
 
+  if ((!tids) || (!req) || (!resp))
+    tr_debug("tids_send_response: Invalid parameters.");
+
+  /* Never send a second response if we already sent one. */
+  if (req->resp_sent)
+    return 0;
+
   mresp.msg_type = TID_RESPONSE;
-  mresp.tid_resp = resp;
-  
+  tr_msg_set_resp(&mresp, resp);
+
   if (NULL == (resp_buf = tr_msg_encode(&mresp))) {
-    fprintf(stderr, "Error decoding json response.\n");
+
+    fprintf(stderr, "tids_send_response: Error encoding json response.\n");
+    tr_audit_req(req);
+
     return -1;
   }
 
-  printf("Encoded response:\n%s\n", resp_buf);
-  
+  tr_debug("tids_send_response: Encoded response: %s", resp_buf);
+
+  /* If external logging is enabled, fire off a message */
+  /* TODO Can be moved to end once segfault in gsscon_write_encrypted_token fixed */
+  tr_audit_resp(resp);
+
   /* Send the response over the connection */
-  if (err = gsscon_write_encrypted_token (conn, *gssctx, resp_buf, 
+  if (err = gsscon_write_encrypted_token (req->conn, req->gssctx, resp_buf, 
                                          strlen(resp_buf) + 1)) {
-    fprintf(stderr, "Error sending response over connection.\n");
+    tr_notice("tids_send_response: Error sending response over connection.");
+
+    tr_audit_req(req);
+
     return -1;
   }
 
+  /* indicate that a response has been sent for this request */
+  req->resp_sent = 1;
+
   free(resp_buf);
 
   return 0;
@@ -191,49 +318,51 @@ static void tids_handle_connection (TIDS_INSTANCE *tids, int conn)
   int rc = 0;
   gss_ctx_id_t gssctx = GSS_C_NO_CONTEXT;
 
-  if (!tids_auth_connection(conn, &gssctx)) {
-    fprintf(stderr, "Error authorizing TID Server connection.\n");
+  if (tids_auth_connection(tids, conn, &gssctx)) {
+    tr_notice("tids_handle_connection: Error authorizing TID Server connection.");
     close(conn);
     return;
   }
 
-  printf("Connection authorized!\n");
+  tr_debug("tids_handle_connection: Connection authorized!");
 
   while (1) {  /* continue until an error breaks us out */
 
     if (0 > (rc = tids_read_request(tids, conn, &gssctx, &mreq))) {
-      fprintf(stderr, "Error from tids_read_request(), rc = %d.\n", rc);
+      tr_debug("tids_handle_connection: Error from tids_read_request(), rc = %d.", rc);
       return;
     } else if (0 == rc) {
       continue;
     }
 
+    /* Put connection information into the request structure */
+    tr_msg_get_req(mreq)->conn = conn;
+    tr_msg_get_req(mreq)->gssctx = gssctx;
+
     /* Allocate a response structure and populate common fields */
-    if ((NULL == (resp = malloc(sizeof(TID_RESP))))) {
-      fprintf(stderr, "Error allocating response structure.\n");
+    if (NULL == (resp = tids_create_response (tids, tr_msg_get_req(mreq)))) {
+      tr_crit("tids_handle_connection: Error creating response structure.");
+      /* try to send an error */
+      tids_send_err_response(tids, tr_msg_get_req(mreq), "Error creating response.");
       return;
     }
 
-    /* TBD -- handle errors */
-    resp->result = TID_SUCCESS; /* presume success */
-    resp->rp_realm = tr_dup_name(mreq->tid_req->rp_realm);
-    resp->realm = tr_dup_name(mreq->tid_req->realm);
-    resp->comm = tr_dup_name(mreq->tid_req->comm);
-    if (mreq->tid_req->orig_coi)
-      resp->orig_coi = tr_dup_name(mreq->tid_req->orig_coi);
-
-    if (0 > (rc = tids_handle_request(tids, mreq, &resp))) {
-      fprintf(stderr, "Error from tids_handle_request(), rc = %d.\n", rc);
-      return;
+    if (0 > (rc = tids_handle_request(tids, mreq, resp))) {
+      tr_debug("tids_handle_connection: Error from tids_handle_request(), rc = %d.", rc);
+      /* Fall through, to send the response, either way */
     }
 
-    if (0 > (rc = tids_send_response(tids, conn, &gssctx, resp))) {
-      fprintf(stderr, "Error from tids_send_response(), rc = %d.\n", rc);
-      return;
+    if (0 > (rc = tids_send_response(tids, tr_msg_get_req(mreq), resp))) {
+      tr_debug("tids_handle_connection: Error from tids_send_response(), rc = %d.", rc);
+      /* if we didn't already send a response, try to send a generic error. */
+      if (!tr_msg_get_req(mreq)->resp_sent)
+       tids_send_err_response(tids, tr_msg_get_req(mreq), "Error sending response.");
+      /* Fall through to free the response, either way. */
     }
-  }  
-
-  return;
+    
+    tids_destroy_response(tids, resp);
+    return;
+  } 
 }
 
 TIDS_INSTANCE *tids_create (void)
@@ -244,24 +373,105 @@ TIDS_INSTANCE *tids_create (void)
   return tids;
 }
 
+/* Get a listener for tids requests, returns its socket fd. Accept
+ * connections with tids_accept() */
+int tids_get_listener(TIDS_INSTANCE *tids, 
+                      TIDS_REQ_FUNC *req_handler,
+                      tids_auth_func *auth_handler,
+                      const char *hostname,
+                      unsigned int port,
+                      void *cookie)
+{
+  int listen = -1;
+
+  tids->tids_port = port;
+  if (0 > (listen = tids_listen(tids, port))) {
+    char errbuf[256];
+    if (0 == strerror_r(errno, errbuf, 256)) {
+      tr_debug("tids_get_listener: Error opening port %d: %s.", port, errbuf);
+    } else {
+      tr_debug("tids_get_listener: Unknown error openining port %d.", port);
+    }
+  } 
+
+  if (listen > 0) {
+    /* opening port succeeded */
+    tr_debug("tids_get_listener: Opened port %d.", port);
+    
+    /* make this socket non-blocking */
+    if (0 != fcntl(listen, F_SETFD, O_NONBLOCK)) {
+      tr_debug("tids_get_listener: Error setting O_NONBLOCK.");
+      close(listen);
+      listen=-1;
+    }
+  }
+
+  if (listen > 0) {
+    /* store the caller's request handler & cookie */
+    tids->req_handler = req_handler;
+    tids->auth_handler = auth_handler;
+    tids->hostname = hostname;
+    tids->cookie = cookie;
+  }
+
+  return listen;
+}
+
+/* Accept and process a connection on a port opened with tids_get_listener() */
+int tids_accept(TIDS_INSTANCE *tids, int listen)
+{
+  int conn=-1;
+  int pid=-1;
+
+  if (0 > (conn = accept(listen, NULL, NULL))) {
+    perror("Error from TIDS Server accept()");
+    return 1;
+  }
+
+  if (0 > (pid = fork())) {
+    perror("Error on fork()");
+    return 1;
+  }
+
+  if (pid == 0) {
+    close(listen);
+    tids_handle_connection(tids, conn);
+    close(conn);
+    exit(0); /* exit to kill forked child process */
+  } else {
+    close(conn);
+  }
+
+  /* clean up any processes that have completed  (TBD: move to main loop?) */
+  while (waitpid(-1, 0, WNOHANG) > 0);
+
+  return 0;
+}
+
+/* Process tids requests forever. Should not return except on error. */
 int tids_start (TIDS_INSTANCE *tids, 
                TIDS_REQ_FUNC *req_handler,
+               tids_auth_func *auth_handler,
+               const char *hostname,
+               unsigned int port,
                void *cookie)
 {
   int listen = -1;
   int conn = -1;
   pid_t pid;
-  int optval = 1;
 
-  if (0 > (listen = tids_listen(tids, TID_PORT)))
+  tids->tids_port = port;
+  if (0 > (listen = tids_listen(tids, port)))
     perror ("Error from tids_listen()");
 
-  setsockopt(listen, SOL_SOCKET, SO_REUSEADDR, &optval, sizeof(optval));
-
   /* store the caller's request handler & cookie */
   tids->req_handler = req_handler;
+  tids->auth_handler = auth_handler;
+  tids->hostname = hostname;
   tids->cookie = cookie;
 
+  tr_info("Trust Path Query Server starting on host %s:%d.", hostname, port);
+
   while(1) {   /* accept incoming conns until we are stopped */
 
     if (0 > (conn = accept(listen, NULL, NULL))) {
@@ -278,18 +488,23 @@ int tids_start (TIDS_INSTANCE *tids,
       close(listen);
       tids_handle_connection(tids, conn);
       close(conn);
-      exit(0);
+      exit(0); /* exit to kill forked child process */
     } else {
       close(conn);
     }
+
+    /* clean up any processes that have completed */
+    while (waitpid(-1, 0, WNOHANG) > 0);
   }
 
-  return 1;    /* should never get here */
+  return 1;    /* should never get here, loops "forever" */
 }
 
 void tids_destroy (TIDS_INSTANCE *tids)
 {
-  free(tids);
-}
-
+  /* clean up logfiles */
+  tr_log_close();
 
+  if (tids)
+    free(tids);
+}