Add TID_REQ_COUNT handler
[trust_router.git] / tr / tr_tid.c
1 /*
2  * Copyright (c) 2016, JANET(UK)
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  *
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * 3. Neither the name of JANET(UK) nor the names of its contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
24  * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
25  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
26  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
27  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
29  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
31  * OF THE POSSIBILITY OF SUCH DAMAGE.
32  *
33  */
34
35 #include <talloc.h>
36
37 #include <trust_router/tr_dh.h>
38 #include <tid_internal.h>
39 #include <tr_filter.h>
40 #include <tr_comm.h>
41 #include <tr_idp.h>
42 #include <tr_rp.h>
43 #include <tr_event.h>
44 #include <tr_debug.h>
45 #include <gsscon.h>
46 #include <trp_internal.h>
47 #include <tr_config.h>
48 #include <tr_mq.h>
49 #include <tr_util.h>
50 #include <tr_tid.h>
51
52 /* Structure to hold data for the tid response callback */
53 typedef struct tr_resp_cookie {
54   int thread_id;
55   TID_RESP *resp;
56 } TR_RESP_COOKIE;
57
58 /* hold a tids instance and a config manager */
59 struct tr_tids_event_cookie {
60   TIDS_INSTANCE *tids;
61   TR_CFG_MGR *cfg_mgr;
62   TRPS_INSTANCE *trps;
63 };
64
65 static void tr_tidc_resp_handler(TIDC_INSTANCE *tidc, 
66                                  TID_REQ *req,
67                                  TID_RESP *resp, 
68                                  void *resp_cookie)
69 {
70   TR_RESP_COOKIE *cookie=talloc_get_type_abort(resp_cookie, TR_RESP_COOKIE);
71
72   tr_debug("tr_tidc_resp_handler: Response received! Realm = %s, Community = %s, result = %s.",
73            resp->realm->buf,
74            resp->comm->buf,
75            (TID_SUCCESS==resp->result)?"success":"error");
76
77   if (resp->error_path!=NULL)
78     tr_debug("tr_tids_resp_handler: error_path is set.");
79   cookie->resp=tid_resp_dup(cookie, resp);
80 }
81
82 /* data for AAA req forwarding threads */
83 struct tr_tids_fwd_cookie {
84   int thread_id;
85   pthread_mutex_t mutex; /* lock on the mq (separate from the locking within the mq, see below) */
86   TR_MQ *mq; /* messages from thread to main process; set to NULL to disable response */
87   TR_NAME *aaa_hostname;
88   DH *dh_params;
89   TID_REQ *fwd_req; /* the req to duplicate */
90 };
91
92 static int tr_tids_fwd_cookie_destructor(void *obj)
93 {
94   struct tr_tids_fwd_cookie *c=talloc_get_type_abort(obj, struct tr_tids_fwd_cookie);
95   if (c->aaa_hostname!=NULL)
96     tr_free_name(c->aaa_hostname);
97   if (c->dh_params!=NULL)
98     tr_destroy_dh_params(c->dh_params);
99   return 0;
100 }
101
102 /* Block until we get the lock, returns 0 on success.
103  * The mutex is used to protect changes to the mq pointer in
104  * a thread's cookie. The master thread sets this to null to indicate
105  * that it has abandoned the thread and the message queue is no longer
106  * valid. This is unrelated to the locking in the message queue
107  * implementation itself. */
108 static int tr_tids_fwd_get_mutex(struct tr_tids_fwd_cookie *cookie)
109 {
110   if (cookie==NULL)
111     return -1;
112
113   return (pthread_mutex_lock(&(cookie->mutex)));
114 }
115
116 static int tr_tids_fwd_release_mutex(struct tr_tids_fwd_cookie *cookie)
117 {
118   if (cookie==NULL)
119     return -1;
120
121   return (pthread_mutex_unlock(&(cookie->mutex)));
122 }
123
124 /* values for messages */
125 #define TR_TID_MQMSG_SUCCESS "tid success"
126 #define TR_TID_MQMSG_FAILURE "tid failure"
127
128 /* Thread main for sending and receiving a request to a single AAA server */
129 static void *tr_tids_req_fwd_thread(void *arg)
130 {
131   TALLOC_CTX *tmp_ctx=talloc_new(NULL);
132   struct tr_tids_fwd_cookie *args=talloc_get_type_abort(arg, struct tr_tids_fwd_cookie);
133   TIDC_INSTANCE *tidc=tidc_create();
134   TR_MQ_MSG *msg=NULL;
135   TR_RESP_COOKIE *cookie=NULL;
136   int rc=0;
137   int success=0;
138
139   talloc_steal(tmp_ctx, args); /* take responsibility for the cookie */
140
141   if (tidc!=NULL)
142     talloc_steal(tmp_ctx, tidc);
143
144   /* create the cookie we will use for our response */
145   cookie=talloc(tmp_ctx, TR_RESP_COOKIE);
146   if (cookie==NULL) {
147     tr_notice("tr_tids_req_fwd_thread: unable to allocate response cookie.");
148     success=0;
149     goto cleanup;
150   }
151   cookie->thread_id=args->thread_id;
152   tr_debug("tr_tids_req_fwd_thread: thread %d started.", cookie->thread_id);
153
154   /* Create a TID client instance */
155   if (tidc==NULL) {
156     tr_crit("tr_tids_req_fwd_thread: Unable to allocate TIDC instance.");
157     /*tids_send_err_response(tids, orig_req, "Memory allocation failure");*/
158     /* TODO: encode reason for failure */
159     success=0;
160     goto cleanup;
161   }
162
163   /* Set-up TID connection */
164   if (-1==(args->fwd_req->conn = tidc_open_connection(tidc, 
165                                                       args->aaa_hostname->buf,
166                                                       TID_PORT, /* TODO: make this configurable */
167                                                      &(args->fwd_req->gssctx)))) {
168     tr_notice("tr_tids_req_fwd_thread: Error in tidc_open_connection.");
169     /* tids_send_err_response(tids, orig_req, "Can't open connection to next hop TIDS"); */
170     /* TODO: encode reason for failure */
171     success=0;
172     goto cleanup;
173   };
174   tr_debug("tr_tids_req_fwd_thread: thread %d opened TID connection to %s.",
175            cookie->thread_id,
176            args->aaa_hostname->buf);
177
178   /* Send a TID request. */
179   if (0 > (rc = tidc_fwd_request(tidc, args->fwd_req, tr_tidc_resp_handler, (void *)cookie))) {
180     tr_notice("Error from tidc_fwd_request, rc = %d.", rc);
181     success=0;
182     goto cleanup;
183   }
184   /* cookie->resp should now contain our copy of the response */
185   success=1;
186   tr_debug("tr_tids_req_fwd_thread: thread %d received response.");
187
188 cleanup:
189   /* Notify parent thread of the response, if it's still listening. */
190   if (0!=tr_tids_fwd_get_mutex(args)) {
191     tr_notice("tr_tids_req_fwd_thread: thread %d unable to acquire mutex.", cookie->thread_id);
192   } else if (NULL!=args->mq) {
193     /* mq is still valid, so we can queue our response */
194     tr_debug("tr_tids_req_fwd_thread: thread %d using valid msg queue.", cookie->thread_id);
195     if (success)
196       msg=tr_mq_msg_new(tmp_ctx, TR_TID_MQMSG_SUCCESS, TR_MQ_PRIO_NORMAL);
197     else
198       msg=tr_mq_msg_new(tmp_ctx, TR_TID_MQMSG_FAILURE, TR_MQ_PRIO_NORMAL);
199
200     if (msg==NULL)
201       tr_notice("tr_tids_req_fwd_thread: thread %d unable to allocate response msg.", cookie->thread_id);
202
203     tr_mq_msg_set_payload(msg, (void *)cookie, NULL);
204     if (NULL!=cookie)
205       talloc_steal(msg, cookie); /* attach this to the msg so we can forget about it */
206     tr_mq_add(args->mq, msg);
207     talloc_steal(NULL, args); /* take out of our tmp_ctx; master thread now responsible for freeing */
208     tr_debug("tr_tids_req_fwd_thread: thread %d queued response message.", cookie->thread_id);
209     if (0!=tr_tids_fwd_release_mutex(args))
210       tr_notice("tr_tids_req_fwd_thread: Error releasing mutex.");
211   }
212
213   talloc_free(tmp_ctx);
214   return NULL;
215 }
216
217 /* Merges r2 into r1 if they are compatible. */
218 static TID_RC tr_tids_merge_resps(TID_RESP *r1, TID_RESP *r2)
219 {
220   /* ensure these are compatible replies */
221   if ((r1->result!=TID_SUCCESS) || (r2->result!=TID_SUCCESS))
222     return TID_ERROR;
223
224   if ((0!=tr_name_cmp(r1->rp_realm, r2->rp_realm)) ||
225       (0!=tr_name_cmp(r1->realm, r2->realm)) ||
226       (0!=tr_name_cmp(r1->comm, r2->comm)))
227     return TID_ERROR;
228
229   tid_srvr_blk_add(r1->servers, tid_srvr_blk_dup(r1, r2->servers));
230   return TID_SUCCESS;
231 }
232
233 /**
234  * Process a TID request
235  *
236  * Return value of -1 means to send a TID_ERROR response. Fill in resp->err_msg or it will
237  * be returned as a generic error.
238  *
239  * @param tids
240  * @param orig_req
241  * @param resp
242  * @param cookie_in
243  * @return
244  */
245 static int tr_tids_req_handler(TIDS_INSTANCE *tids,
246                                TID_REQ *orig_req, 
247                                TID_RESP *resp,
248                                void *cookie_in)
249 {
250   TALLOC_CTX *tmp_ctx=talloc_new(NULL);
251   TR_AAA_SERVER *aaa_servers=NULL, *this_aaa=NULL;
252   int n_aaa=0;
253   int idp_shared=0;
254   TR_AAA_SERVER_ITER *aaa_iter=NULL;
255   pthread_t aaa_thread[TR_TID_MAX_AAA_SERVERS];
256   struct tr_tids_fwd_cookie *aaa_cookie[TR_TID_MAX_AAA_SERVERS]={NULL};
257   TID_RESP *aaa_resp[TR_TID_MAX_AAA_SERVERS]={NULL};
258   TR_RP_CLIENT *rp_client=NULL;
259   TR_RP_CLIENT_ITER *rpc_iter=NULL;
260   TR_NAME *apc = NULL;
261   TID_REQ *fwd_req = NULL;
262   TR_COMM *cfg_comm = NULL;
263   TR_COMM *cfg_apc = NULL;
264   TR_FILTER_ACTION oaction = TR_FILTER_ACTION_REJECT;
265   time_t expiration_interval=0;
266   struct tr_tids_event_cookie *cookie=talloc_get_type_abort(cookie_in, struct tr_tids_event_cookie);
267   TR_CFG_MGR *cfg_mgr=cookie->cfg_mgr;
268   TRPS_INSTANCE *trps=cookie->trps;
269   TRP_ROUTE *route=NULL;
270   TR_MQ *mq=NULL;
271   TR_MQ_MSG *msg=NULL;
272   unsigned int n_responses=0;
273   unsigned int n_failed=0;
274   struct timespec ts_abort={0};
275   unsigned int resp_frac_numer=cfg_mgr->active->internal->tid_resp_numer;
276   unsigned int resp_frac_denom=cfg_mgr->active->internal->tid_resp_denom;
277   TR_RESP_COOKIE *payload=NULL;
278   TR_FILTER_TARGET *target=NULL;
279   int ii=0;
280   int retval=-1;
281
282   if ((!tids) || (!orig_req) || (!resp)) {
283     tr_debug("tr_tids_req_handler: Bad parameters");
284     retval=-1;
285     goto cleanup;
286   }
287
288   tr_debug("tr_tids_req_handler: Request received (conn = %d)! Realm = %s, Comm = %s", orig_req->conn, 
289            orig_req->realm->buf, orig_req->comm->buf);
290
291   /* Duplicate the request, so we can modify and forward it */
292   if (NULL == (fwd_req=tid_dup_req(orig_req))) {
293     tr_debug("tr_tids_req_handler: Unable to duplicate request.");
294     retval=-1; /* response will be a generic internal error */
295     goto cleanup;
296   }
297   talloc_steal(tmp_ctx, fwd_req);
298
299   if (NULL == (cfg_comm=tr_comm_table_find_comm(cfg_mgr->active->ctable, orig_req->comm))) {
300     tr_notice("tr_tids_req_hander: Request for unknown comm: %s.", orig_req->comm->buf);
301     tid_resp_set_err_msg(resp, tr_new_name("Unknown community"));
302     retval=-1;
303     goto cleanup;
304   }
305
306   /* We now need to apply the filters associated with the RP client handing us the request.
307    * It is possible (or even likely) that more than one client is associated with the GSS
308    * name we got from the authentication. We will apply all of them in an arbitrary order.
309    * For this to result in well-defined behavior, either only accept or only reject filter
310    * lines should be used, or a unique GSS name must be given for each RP realm. */
311
312   if (!tids->gss_name) {
313     tr_notice("tr_tids_req_handler: No GSS name for incoming request.");
314     tid_resp_set_err_msg(resp, tr_new_name("No GSS name for request"));
315     retval=-1;
316     goto cleanup;
317   }
318
319   /* Keep original constraints, may add more from the filter. These will be added to orig_req as
320    * well. Need to verify that this is acceptable behavior, but it's what we've always done. */
321   fwd_req->cons=orig_req->cons;
322
323   target=tr_filter_target_tid_req(tmp_ctx, orig_req);
324   if (target==NULL) {
325     tr_crit("tid_req_handler: Unable to allocate filter target, cannot apply filter!");
326     tid_resp_set_err_msg(resp, tr_new_name("Incoming TID request filter error"));
327     retval=-1;
328     goto cleanup;
329   }
330
331   rpc_iter=tr_rp_client_iter_new(tmp_ctx);
332   if (rpc_iter==NULL) {
333     tr_err("tid_req_handler: Unable to allocate RP client iterator.");
334     retval=-1;
335     goto cleanup;
336   }
337   for (rp_client=tr_rp_client_iter_first(rpc_iter, cfg_mgr->active->rp_clients);
338        rp_client != NULL;
339        rp_client=tr_rp_client_iter_next(rpc_iter)) {
340
341     if (!tr_gss_names_matches(rp_client->gss_names, tids->gss_name))
342       continue; /* skip any that don't match the GSS name */
343
344     if (TR_FILTER_MATCH == tr_filter_apply(target,
345                                            tr_filter_set_get(rp_client->filters,
346                                                              TR_FILTER_TYPE_TID_INBOUND),
347                                            &(fwd_req->cons),
348                                            &oaction))
349       break; /* Stop looking, oaction is set */
350   }
351
352   /* We get here whether or not a filter matched. If tr_filter_apply() doesn't match, it returns
353    * a default action of reject, so we don't have to check why we exited the loop. */
354   if (oaction != TR_FILTER_ACTION_ACCEPT) {
355     tr_notice("tr_tids_req_handler: Incoming TID request rejected by filter for GSS name", orig_req->rp_realm->buf);
356     tid_resp_set_err_msg(resp, tr_new_name("Incoming TID request filter error"));
357     retval = -1;
358     goto cleanup;
359   }
360
361   /* Check that the rp_realm is a member of the community in the request */
362   if (NULL == tr_comm_find_rp(cfg_mgr->active->ctable, cfg_comm, orig_req->rp_realm)) {
363     tr_notice("tr_tids_req_handler: RP Realm (%s) not member of community (%s).", orig_req->rp_realm->buf, orig_req->comm->buf);
364     tid_resp_set_err_msg(resp, tr_new_name("RP COI membership error"));
365     retval=-1;
366     goto cleanup;
367   }
368
369   /* Map the comm in the request from a COI to an APC, if needed */
370   if (TR_COMM_COI == cfg_comm->type) {
371     if (orig_req->orig_coi!=NULL) {
372       tr_notice("tr_tids_req_handler: community %s is COI but COI to APC mapping already occurred. Dropping request.",
373                orig_req->comm->buf);
374       tid_resp_set_err_msg(resp, tr_new_name("Second COI to APC mapping would result, permitted only once."));
375       retval=-1;
376       goto cleanup;
377     }
378     
379     tr_debug("tr_tids_req_handler: Community was a COI, switching.");
380     /* TBD -- In theory there can be more than one?  How would that work? */
381     if ((!cfg_comm->apcs) || (!cfg_comm->apcs->id)) {
382       tr_notice("No valid APC for COI %s.", orig_req->comm->buf);
383       tid_resp_set_err_msg(resp, tr_new_name("No valid APC for community"));
384       retval=-1;
385       goto cleanup;
386     }
387     apc = tr_dup_name(cfg_comm->apcs->id);
388
389     /* Check that the APC is configured */
390     if (NULL == (cfg_apc = tr_comm_table_find_comm(cfg_mgr->active->ctable, apc))) {
391       tr_notice("tr_tids_req_hander: Request for unknown comm: %s.", apc->buf);
392       tid_resp_set_err_msg(resp, tr_new_name("Unknown APC"));
393       retval=-1;
394       goto cleanup;
395     }
396
397     fwd_req->comm = apc;
398     fwd_req->orig_coi = orig_req->comm;
399
400     /* Check that rp_realm is a  member of this APC */
401     if (NULL == (tr_comm_find_rp(cfg_mgr->active->ctable, cfg_apc, orig_req->rp_realm))) {
402       tr_notice("tr_tids_req_hander: RP Realm (%s) not member of community (%s).", orig_req->rp_realm->buf, orig_req->comm->buf);
403       tid_resp_set_err_msg(resp, tr_new_name("RP APC membership error"));
404       retval=-1;
405       goto cleanup;
406     }
407   }
408
409   /* Look up the route for this community/realm. */
410   tr_debug("tr_tids_req_handler: looking up route.");
411   route=trps_get_selected_route(trps, orig_req->comm, orig_req->realm);
412   if (route==NULL) {
413     /* No route. Use default AAA servers if we have them. */
414     tr_debug("tr_tids_req_handler: No route for realm %s, defaulting.", orig_req->realm->buf);
415     if (NULL == (aaa_servers = tr_default_server_lookup(cfg_mgr->active->default_servers,
416                                                         orig_req->comm))) {
417       tr_notice("tr_tids_req_handler: No default AAA servers, discarded.");
418       tid_resp_set_err_msg(resp, tr_new_name("No path to AAA Server(s) for realm"));
419       retval = -1;
420       goto cleanup;
421     }
422     idp_shared = 0;
423   } else {
424     /* Found a route. Determine the AAA servers or next hop address. */
425     tr_debug("tr_tids_req_handler: found route.");
426     if (trp_route_is_local(route)) {
427       tr_debug("tr_tids_req_handler: route is local.");
428       aaa_servers = tr_idp_aaa_server_lookup(cfg_mgr->active->ctable->idp_realms,
429                                              orig_req->realm,
430                                              orig_req->comm,
431                                              &idp_shared);
432     } else {
433       tr_debug("tr_tids_req_handler: route not local.");
434       aaa_servers = tr_aaa_server_new(tmp_ctx, trp_route_get_next_hop(route));
435       idp_shared = 0;
436     }
437
438     /* Since we aren't defaulting, check idp coi and apc membership */
439     if (NULL == (tr_comm_find_idp(cfg_mgr->active->ctable, cfg_comm, fwd_req->realm))) {
440       tr_notice("tr_tids_req_handler: IDP Realm (%s) not member of community (%s).", orig_req->realm->buf, orig_req->comm->buf);
441       tid_resp_set_err_msg(resp, tr_new_name("IDP community membership error"));
442       retval=-1;
443       goto cleanup;
444     }
445     if ( cfg_apc && (NULL == (tr_comm_find_idp(cfg_mgr->active->ctable, cfg_apc, fwd_req->realm)))) {
446       tr_notice("tr_tids_req_handler: IDP Realm (%s) not member of APC (%s).", orig_req->realm->buf, orig_req->comm->buf);
447       tid_resp_set_err_msg(resp, tr_new_name("IDP APC membership error"));
448       retval=-1;
449       goto cleanup;
450     }
451   }
452
453   /* Make sure we came through with a AAA server. If not, we can't handle the request. */
454   if (NULL == aaa_servers) {
455     tr_notice("tr_tids_req_handler: no route or AAA server for realm (%s) in community (%s).",
456               orig_req->realm->buf, orig_req->comm->buf);
457     tid_resp_set_err_msg(resp, tr_new_name("Missing trust route error"));
458     retval = -1;
459     goto cleanup;
460   }
461
462   /* send a TID request to the AAA server(s), and get the answer(s) */
463   tr_debug("tr_tids_req_handler: sending TID request(s).");
464   if (cfg_apc)
465     expiration_interval = cfg_apc->expiration_interval;
466   else expiration_interval = cfg_comm->expiration_interval;
467   if (fwd_req->expiration_interval)
468     fwd_req->expiration_interval =  (expiration_interval < fwd_req->expiration_interval) ? expiration_interval : fwd_req->expiration_interval;
469   else fwd_req->expiration_interval = expiration_interval;
470
471   /* Set up message queue for replies from req forwarding threads */
472   mq=tr_mq_new(tmp_ctx);
473   if (mq==NULL) {
474     tr_notice("tr_tids_req_handler: unable to allocate message queue.");
475     retval=-1;
476     goto cleanup;
477   }
478   tr_debug("tr_tids_req_handler: message queue allocated.");
479
480   /* start threads */
481   aaa_iter=tr_aaa_server_iter_new(tmp_ctx);
482   if (aaa_iter==NULL) {
483     tr_notice("tr_tids_req_handler: unable to allocate AAA server iterator.");
484     retval=-1;
485     goto cleanup;
486   }
487   for (n_aaa=0, this_aaa=tr_aaa_server_iter_first(aaa_iter, aaa_servers);
488        this_aaa!=NULL;
489        n_aaa++, this_aaa=tr_aaa_server_iter_next(aaa_iter)) {
490     tr_debug("tr_tids_req_handler: Preparing to start thread %d.", n_aaa);
491
492     aaa_cookie[n_aaa]=talloc(tmp_ctx, struct tr_tids_fwd_cookie);
493     if (aaa_cookie[n_aaa]==NULL) {
494       tr_notice("tr_tids_req_handler: unable to allocate cookie for AAA thread %d.", n_aaa);
495       retval=-1;
496       goto cleanup;
497     }
498     talloc_set_destructor((void *)(aaa_cookie[n_aaa]), tr_tids_fwd_cookie_destructor);
499     /* fill in the cookie. To ensure the thread has valid data even if we exit first and
500      * abandon it, duplicate anything pointed to (except the mq). */
501     aaa_cookie[n_aaa]->thread_id=n_aaa;
502     if (0!=pthread_mutex_init(&(aaa_cookie[n_aaa]->mutex), NULL)) {
503       tr_notice("tr_tids_req_handler: unable to init mutex for AAA thread %d.", n_aaa);
504       retval=-1;
505       goto cleanup;
506     }
507     aaa_cookie[n_aaa]->mq=mq;
508     aaa_cookie[n_aaa]->aaa_hostname=tr_dup_name(this_aaa->hostname);
509     aaa_cookie[n_aaa]->dh_params=tr_dh_dup(orig_req->tidc_dh);
510     aaa_cookie[n_aaa]->fwd_req=tid_dup_req(fwd_req);
511     talloc_steal(aaa_cookie[n_aaa], aaa_cookie[n_aaa]->fwd_req);
512     tr_debug("tr_tids_req_handler: cookie %d initialized.", n_aaa);
513
514     /* Take the cookie out of tmp_ctx before starting thread. If thread starts, it becomes
515      * responsible for freeing it until it queues a response. If we did not do this, the possibility
516      * exists that this function exits, freeing the cookie, before the thread takes the cookie
517      * out of our tmp_ctx. This would cause a segfault or talloc error in the thread. */
518     talloc_steal(NULL, aaa_cookie[n_aaa]);
519     if (0!=pthread_create(&(aaa_thread[n_aaa]), NULL, tr_tids_req_fwd_thread, aaa_cookie[n_aaa])) {
520       talloc_steal(tmp_ctx, aaa_cookie[n_aaa]); /* thread start failed; steal this back */
521       tr_notice("tr_tids_req_handler: unable to start AAA thread %d.", n_aaa);
522       retval=-1;
523       goto cleanup;
524     }
525     tr_debug("tr_tids_req_handler: thread %d started.", n_aaa);
526   }
527
528   /* determine expiration time */
529   if (0!=tr_mq_pop_timeout(cfg_mgr->active->internal->tid_req_timeout, &ts_abort)) {
530     tr_notice("tr_tids_req_handler: unable to read clock for timeout.");
531     retval=-1;
532     goto cleanup;
533   }
534
535   /* wait for responses */
536   tr_debug("tr_tids_req_handler: waiting for response(s).");
537   n_responses=0;
538   n_failed=0;
539   while (((n_responses+n_failed)<n_aaa) &&
540          (NULL!=(msg=tr_mq_pop(mq, &ts_abort)))) {
541     /* process message */
542     if (0==strcmp(tr_mq_msg_get_message(msg), TR_TID_MQMSG_SUCCESS)) {
543       payload=talloc_get_type_abort(tr_mq_msg_get_payload(msg), TR_RESP_COOKIE);
544       talloc_steal(tmp_ctx, payload); /* put this back in our context */
545       aaa_resp[payload->thread_id]=payload->resp; /* save pointers to these */
546
547       if (payload->resp->result==TID_SUCCESS) {
548         tr_tids_merge_resps(resp, payload->resp);
549         n_responses++;
550       } else {
551         n_failed++;
552         tr_notice("tr_tids_req_handler: TID error received from AAA server %d: %.*s",
553                   payload->thread_id,
554                   payload->resp->err_msg->len,
555                   payload->resp->err_msg->buf);
556       }
557     } else if (0==strcmp(tr_mq_msg_get_message(msg), TR_TID_MQMSG_FAILURE)) {
558       /* failure */
559       n_failed++;
560       payload=talloc_get_type(tr_mq_msg_get_payload(msg), TR_RESP_COOKIE);
561       if (payload!=NULL) 
562         talloc_steal(tmp_ctx, payload); /* put this back in our context */
563       else {
564         /* this means the thread was unable to allocate a response cookie, and we thus cannot determine which thread it was. This is bad and should never happen in a working system.. Give up. */
565         tr_notice("tr_tids_req_handler: TID request thread sent invalid reply. Aborting!");
566         retval=-1;
567         goto cleanup;
568       }
569       tr_notice("tr_tids_req_handler: TID request for AAA server %d failed.",
570                 payload->thread_id);
571     } else {
572       /* unexpected message */
573       tr_err("tr_tids_req_handler: Unexpected message received. Aborting!");
574       retval=-1;
575       goto cleanup;
576     }
577     
578     /* Set the cookie pointer to NULL so we know we've dealt with this one. The
579      * cookie itself is in our tmp_ctx, which we'll free before exiting. Let it hang
580      * around in case we are still using pointers to elements of the cookie. */
581     aaa_cookie[payload->thread_id]=NULL;
582
583     tr_mq_msg_free(msg);
584
585     /* check whether we've received enough responses to exit */
586     if ((idp_shared && (n_responses>0)) ||
587         (resp_frac_denom*n_responses>=resp_frac_numer*n_aaa))
588       break;
589   }
590
591   tr_debug("tr_tids_req_handler: done waiting for responses. %d responses, %d failures.",
592            n_responses, n_failed);
593   /* Inform any remaining threads that we will no longer handle their responses. */
594   for (ii=0; ii<n_aaa; ii++) {
595     if (aaa_cookie[ii]!=NULL) {
596       if (0!=tr_tids_fwd_get_mutex(aaa_cookie[ii]))
597         tr_notice("tr_tids_req_handler: unable to get mutex for AAA thread %d.", ii);
598
599       aaa_cookie[ii]->mq=NULL; /* threads will not try to respond through a null mq */
600
601       if (0!=tr_tids_fwd_release_mutex(aaa_cookie[ii]))
602         tr_notice("tr_tids_req_handler: unable to release mutex for AAA thread %d.", ii);
603     }
604   }
605
606   /* Now all threads have either replied (and aaa_cookie[ii] is null) or have been told not to
607    * reply (by setting their mq pointer to null). However, some may have responded by placing
608    * a message on the mq after we last checked but before we set their mq pointer to null. These
609    * will not know that we gave up on them, so we must free their cookies for them. We can just
610    * go through any remaining messages on the mq to identify these threads. By putting them in
611    * our context instead of freeing them directly, we ensure we don't accidentally invalidate
612    * any of our own pointers into the structure before this function exits. */
613   while (NULL!=(msg=tr_mq_pop(mq, NULL))) {
614     payload=(TR_RESP_COOKIE *)tr_mq_msg_get_payload(msg);
615     if (aaa_cookie[payload->thread_id]!=NULL)
616       talloc_steal(tmp_ctx, aaa_cookie[payload->thread_id]);
617
618     tr_mq_msg_free(msg);
619   }
620
621   if (n_responses==0) {
622     /* No requests succeeded, so this will be an error */
623     retval = -1;
624
625     /* If we got any error responses, send an arbitrarily chosen one. */
626     for (ii=0; ii<n_aaa; ii++) {
627       if (aaa_resp[ii] != NULL) {
628         tid_resp_cpy(resp, aaa_resp[ii]);
629         goto cleanup;
630       }
631     }
632     /* No error responses at all, so generate our own error. */
633     tid_resp_set_err_msg(resp, tr_new_name("Unable to contact AAA server(s)."));
634     goto cleanup;
635   }
636
637   /* success! */
638   retval=0;
639     
640 cleanup:
641   talloc_free(tmp_ctx);
642   return retval;
643 }
644
645 static int tr_tids_gss_handler(gss_name_t client_name, TR_NAME *gss_name,
646                                void *data)
647 {
648   struct tr_tids_event_cookie *cookie=talloc_get_type_abort(data, struct tr_tids_event_cookie);
649   TIDS_INSTANCE *tids = cookie->tids;
650   TR_CFG_MGR *cfg_mgr = cookie->cfg_mgr;
651
652   if ((!client_name) || (!gss_name) || (!tids) || (!cfg_mgr)) {
653     tr_debug("tr_tidc_gss_handler: Bad parameters.");
654     return -1;
655   }
656
657   /* Ensure at least one client exists using this GSS name */
658   if (NULL == tr_rp_client_lookup(cfg_mgr->active->rp_clients, gss_name)) {
659     tr_debug("tr_tids_gss_handler: Unknown GSS name %.*s", gss_name->len, gss_name->buf);
660     return -1;
661   }
662
663   /* Store the GSS name */
664   tids->gss_name = tr_dup_name(gss_name);
665   tr_debug("Client's GSS Name: %.*s", gss_name->len, gss_name->buf);
666
667   return 0;
668 }
669
670
671 /***** TIDS event handling *****/
672
673 /* called when a connection to the TIDS port is received */
674 static void tr_tids_event_cb(int listener, short event, void *arg)
675 {
676   TIDS_INSTANCE *tids = (TIDS_INSTANCE *)arg;
677
678   if (0==(event & EV_READ))
679     tr_debug("tr_tids_event_cb: unexpected event on TIDS socket (event=0x%X)", event);
680   else 
681     tids_accept(tids, listener);
682 }
683
684 /* Configure the tids instance and set up its event handler.
685  * Returns 0 on success, nonzero on failure. Fills in
686  * *tids_event (which should be allocated by caller). */
687 int tr_tids_event_init(struct event_base *base,
688                        TIDS_INSTANCE *tids,
689                        TR_CFG_MGR *cfg_mgr,
690                        TRPS_INSTANCE *trps,
691                        struct tr_socket_event *tids_ev)
692 {
693   TALLOC_CTX *tmp_ctx=talloc_new(NULL);
694   struct tr_tids_event_cookie *cookie=NULL;
695   int retval=0;
696   int ii=0;
697
698   if (tids_ev == NULL) {
699     tr_debug("tr_tids_event_init: Null tids_ev.");
700     retval=1;
701     goto cleanup;
702   }
703
704   /* Create the cookie for callbacks. We'll put it in the tids context, so it will
705    * be cleaned up when tids is freed by talloc_free. */
706   cookie=talloc(tmp_ctx, struct tr_tids_event_cookie);
707   if (cookie == NULL) {
708     tr_debug("tr_tids_event_init: Unable to allocate cookie.");
709     retval=1;
710     goto cleanup;
711   }
712   cookie->tids=tids;
713   cookie->cfg_mgr=cfg_mgr;
714   cookie->trps=trps;
715   talloc_steal(tids, cookie);
716
717   /* get a tids listener */
718   tids_ev->n_sock_fd = (int)tids_get_listener(tids,
719                                               tr_tids_req_handler,
720                                               tr_tids_gss_handler,
721                                               cfg_mgr->active->internal->hostname,
722                                               cfg_mgr->active->internal->tids_port,
723                                               (void *)cookie,
724                                               tids_ev->sock_fd,
725                                               TR_MAX_SOCKETS);
726   if (tids_ev->n_sock_fd==0) {
727     tr_crit("Error opening TID server socket.");
728     retval=1;
729     goto cleanup;
730   }
731
732   /* Set up events */
733   for (ii=0; ii<tids_ev->n_sock_fd; ii++) {
734     tids_ev->ev[ii]=event_new(base,
735                               tids_ev->sock_fd[ii],
736                               EV_READ|EV_PERSIST,
737                               tr_tids_event_cb,
738                               (void *)tids);
739     event_add(tids_ev->ev[ii], NULL);
740   }
741
742 cleanup:
743   talloc_free(tmp_ctx);
744   return retval;
745 }