2 This file is part of GNUnet.
3 Copyright (C) 2012-2015 Christian Grothoff (and other contributing authors)
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 3, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
21 * @author Martin Schanzenbach
22 * @file gns/plugin_rest_gns.c
23 * @brief GNUnet GNS REST plugin
28 #include "gnunet_rest_plugin.h"
29 #include <gnunet_dnsparser_lib.h>
30 #include <gnunet_identity_service.h>
31 #include <gnunet_gnsrecord_lib.h>
32 #include <gnunet_namestore_service.h>
33 #include <gnunet_gns_service.h>
34 #include <gnunet_rest_lib.h>
37 #define API_NAMESPACE "/resolver"
39 #define GNUNET_REST_JSONAPI_GNS_RECORD_TYPE "record_type"
41 #define GNUNET_REST_JSONAPI_GNS_TYPEINFO "gns_name"
43 #define GNUNET_REST_JSONAPI_GNS_RECORD "records"
45 #define GNUNET_REST_JSONAPI_GNS_EGO "ego"
47 #define GNUNET_REST_JSONAPI_GNS_PKEY "pkey"
49 #define GNUNET_REST_JSONAPI_GNS_OPTIONS "options"
52 * @brief struct returned by the initialization function of the plugin
56 const struct GNUNET_CONFIGURATION_Handle *cfg;
59 const struct GNUNET_CONFIGURATION_Handle *cfg;
64 * Handle to GNS service.
66 struct GNUNET_GNS_Handle *gns;
69 * Desired timeout for the lookup (default is no timeout).
71 struct GNUNET_TIME_Relative timeout;
74 * Handle to lookup request
76 struct GNUNET_GNS_LookupRequest *lookup_request;
79 * Lookup an ego with the identity service.
81 struct GNUNET_IDENTITY_EgoLookup *el;
84 * Handle for identity service.
86 struct GNUNET_IDENTITY_Handle *identity;
89 * Active operation on identity service.
91 struct GNUNET_IDENTITY_Operation *id_op;
94 * ID of a task associated with the resolution process.
96 struct GNUNET_SCHEDULER_Task * timeout_task;
99 * The root of the received JSON or NULL
104 * The plugin result processor
106 GNUNET_REST_ResultProcessor proc;
109 * The closure of the result processor
114 * The name to look up
120 * In string representation from JSON
126 * In string representation from JSON
128 const char *pkey_str;
136 * The public key of to use for lookup
138 struct GNUNET_CRYPTO_EcdsaPublicKey pkey;
141 * The public key to use for lookup
143 struct GNUNET_CRYPTO_EcdsaPublicKey pkeym;
146 * The resolver options
148 enum GNUNET_GNS_LocalOptions options;
153 struct GNUNET_CRYPTO_EcdsaPrivateKey shorten_key;
159 * Cleanup lookup handle.
161 * @param handle Handle to clean up
164 cleanup_handle (struct LookupHandle *handle)
166 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
168 if (NULL != handle->json_root)
169 json_decref (handle->json_root);
171 if (NULL != handle->name)
172 GNUNET_free (handle->name);
173 if (NULL != handle->el)
175 GNUNET_IDENTITY_ego_lookup_cancel (handle->el);
178 if (NULL != handle->id_op)
180 GNUNET_IDENTITY_cancel (handle->id_op);
181 handle->id_op = NULL;
183 if (NULL != handle->lookup_request)
185 GNUNET_GNS_lookup_cancel (handle->lookup_request);
186 handle->lookup_request = NULL;
188 if (NULL != handle->identity)
190 GNUNET_IDENTITY_disconnect (handle->identity);
191 handle->identity = NULL;
193 if (NULL != handle->gns)
195 GNUNET_GNS_disconnect (handle->gns);
199 if (NULL != handle->timeout_task)
201 GNUNET_SCHEDULER_cancel (handle->timeout_task);
203 GNUNET_free (handle);
208 * Task run on shutdown. Cleans up everything.
211 * @param tc scheduler context
215 const struct GNUNET_SCHEDULER_TaskContext *tc)
217 struct LookupHandle *handle = cls;
218 struct MHD_Response *resp = GNUNET_REST_create_json_response (NULL);
219 handle->proc (handle->proc_cls, resp, MHD_HTTP_BAD_REQUEST);
220 cleanup_handle (handle);
225 * Create json representation of a GNSRECORD
227 * @param rd the GNSRECORD_Data
230 gnsrecord_to_json (const struct GNUNET_GNSRECORD_Data *rd)
232 const char *typename;
237 typename = GNUNET_GNSRECORD_number_to_typename (rd->record_type);
238 string_val = GNUNET_GNSRECORD_value_to_string (rd->record_type,
242 if (NULL == string_val)
244 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
245 "Record of type %d malformed, skipping\n",
246 (int) rd->record_type);
249 record_obj = json_object();
250 json_object_set_new (record_obj, "type", json_string (typename));
251 json_object_set_new (record_obj, "value", json_string (string_val));
252 GNUNET_free (string_val);
254 if (GNUNET_GNSRECORD_RF_RELATIVE_EXPIRATION & rd->flags)
256 struct GNUNET_TIME_Relative time_rel;
257 time_rel.rel_value_us = rd->expiration_time;
258 exp_str = GNUNET_STRINGS_relative_time_to_string (time_rel, 1);
262 struct GNUNET_TIME_Absolute time_abs;
263 time_abs.abs_value_us = rd->expiration_time;
264 exp_str = GNUNET_STRINGS_absolute_time_to_string (time_abs);
266 json_object_set_new (record_obj, "expiration_time", json_string (exp_str));
268 json_object_set_new (record_obj, "expired",
269 json_boolean (GNUNET_YES == GNUNET_GNSRECORD_is_expired (rd)));
274 * Function called with the result of a GNS lookup.
276 * @param cls the 'const char *' name that was resolved
277 * @param rd_count number of records returned
278 * @param rd array of @a rd_count records with the results
281 process_lookup_result (void *cls, uint32_t rd_count,
282 const struct GNUNET_GNSRECORD_Data *rd)
284 struct LookupHandle *handle = cls;
285 struct MHD_Response *resp;
286 struct JsonApiObject *json_object;
287 struct JsonApiResource *json_resource;
290 json_t *result_array;
293 result_array = json_array();
294 json_object = GNUNET_REST_jsonapi_object_new ();
295 json_resource = GNUNET_REST_jsonapi_resource_new (GNUNET_REST_JSONAPI_GNS_TYPEINFO, handle->name);
296 handle->lookup_request = NULL;
297 for (i=0; i<rd_count; i++)
299 if ( (rd[i].record_type != handle->type) &&
300 (GNUNET_GNSRECORD_TYPE_ANY != handle->type) )
302 record_obj = gnsrecord_to_json (&(rd[i]));
303 json_array_append (result_array, record_obj);
304 json_decref (record_obj);
306 GNUNET_REST_jsonapi_resource_add_attr (json_resource,
307 GNUNET_REST_JSONAPI_GNS_RECORD,
309 GNUNET_REST_jsonapi_object_resource_add (json_object, json_resource);
310 GNUNET_REST_jsonapi_data_serialize (json_object, &result);
311 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Result %s\n", result);
312 json_decref (result_array);
313 GNUNET_REST_jsonapi_object_delete (json_object);
314 resp = GNUNET_REST_create_json_response (result);
315 handle->proc (handle->proc_cls, resp, MHD_HTTP_OK);
316 GNUNET_free (result);
317 cleanup_handle (handle);
322 * Perform the actual resolution, starting with the zone
323 * identified by the given public key and the shorten zone.
325 * @param pkey public key to use for the zone, can be NULL
326 * @param shorten_key private key used for shortening, can be NULL
329 lookup_with_keys (struct LookupHandle *handle, const struct GNUNET_CRYPTO_EcdsaPrivateKey *shorten_key)
331 if (UINT32_MAX == handle->type)
333 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
334 _("Invalid typename specified, assuming `ANY'\n"));
335 handle->type = GNUNET_GNSRECORD_TYPE_ANY;
337 if (NULL != handle->name)
339 handle->lookup_request = GNUNET_GNS_lookup (handle->gns,
345 &process_lookup_result,
350 GNUNET_SCHEDULER_add_now (&do_error, handle);
356 * Method called to with the ego we are to use for shortening
359 * @param cls closure contains the public key to use
360 * @param ego ego handle, NULL if not found
361 * @param ctx context for application to store data for this ego
362 * (during the lifetime of this process, initially NULL)
363 * @param name name assigned by the user for this ego,
364 * NULL if the user just deleted the ego and it
365 * must thus no longer be used
368 identity_shorten_cb (void *cls,
369 struct GNUNET_IDENTITY_Ego *ego,
373 struct LookupHandle *handle = cls;
375 handle->id_op = NULL;
377 lookup_with_keys (handle, NULL);
379 lookup_with_keys (handle,
380 GNUNET_IDENTITY_ego_get_private_key (ego));
384 * Perform the actual resolution, starting with the zone
385 * identified by the given public key.
387 * @param pkey public key to use for the zone
390 lookup_with_public_key (struct LookupHandle *handle)
392 handle->pkeym = handle->pkey;
393 GNUNET_break (NULL == handle->id_op);
394 handle->id_op = GNUNET_IDENTITY_get (handle->identity,
396 &identity_shorten_cb,
398 if (NULL == handle->id_op)
401 lookup_with_keys (handle, NULL);
406 * Method called to with the ego we are to use for the lookup,
407 * when the ego is determined by a name.
409 * @param cls closure (NULL, unused)
410 * @param ego ego handle, NULL if not found
413 identity_zone_cb (void *cls,
414 const struct GNUNET_IDENTITY_Ego *ego)
416 struct LookupHandle *handle = cls;
421 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
422 _("Ego for not found, cannot perform lookup.\n"));
423 GNUNET_SCHEDULER_add_now (&do_error, handle);
428 GNUNET_IDENTITY_ego_get_public_key (ego, &handle->pkey);
429 lookup_with_public_key (handle);
431 json_decref(handle->json_root);
435 * Method called to with the ego we are to use for the lookup,
436 * when the ego is the one for the default master zone.
438 * @param cls closure (NULL, unused)
439 * @param ego ego handle, NULL if not found
440 * @param ctx context for application to store data for this ego
441 * (during the lifetime of this process, initially NULL)
442 * @param name name assigned by the user for this ego,
443 * NULL if the user just deleted the ego and it
444 * must thus no longer be used
447 identity_master_cb (void *cls,
448 struct GNUNET_IDENTITY_Ego *ego,
453 struct LookupHandle *handle = cls;
455 handle->id_op = NULL;
458 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
459 _("Ego for `gns-master' not found, cannot perform lookup. Did you run gnunet-gns-import.sh?\n"));
460 GNUNET_SCHEDULER_add_now (&do_error, handle);
463 GNUNET_IDENTITY_ego_get_public_key (ego, &handle->pkey);
464 /* main name is our own master zone, do no look for that in the DHT */
465 handle->options = GNUNET_GNS_LO_LOCAL_MASTER;
466 /* if the name is of the form 'label.gnu', never go to the DHT */
468 if (NULL != handle->name)
469 dot = strchr (handle->name, '.');
470 if ( (NULL != dot) &&
471 (0 == strcasecmp (dot, ".gnu")) )
472 handle->options = GNUNET_GNS_LO_NO_DHT;
473 lookup_with_public_key (handle);
477 * Parse REST uri for name and record type
479 * @param url Url to parse
480 * @param handle lookup handle to populate
481 * @return GNUNET_SYSERR on error
484 parse_url (const char *url, struct LookupHandle *handle)
487 char tmp_url[strlen(url)+1];
490 strcpy (tmp_url, url);
491 tok = strtok ((char*)tmp_url, "/");
493 return GNUNET_SYSERR;
494 name = strtok (NULL, "/");
496 return GNUNET_SYSERR;
497 GNUNET_asprintf (&handle->name,
500 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
501 "Got name: %s\n", handle->name);
506 * Function processing the REST call
508 * @param method HTTP method
509 * @param url URL of the HTTP request
510 * @param data body of the HTTP request (optional)
511 * @param data_size length of the body
512 * @param proc callback function for the result
513 * @param proc_cls closure for callback function
514 * @return GNUNET_OK if request accepted
517 rest_gns_process_request(struct RestConnectionDataHandle *conndata_handle,
518 GNUNET_REST_ResultProcessor proc,
521 struct LookupHandle *handle = GNUNET_new (struct LookupHandle);
522 struct GNUNET_HashCode key;
524 handle->timeout = GNUNET_TIME_UNIT_FOREVER_REL;
525 handle->proc_cls = proc_cls;
527 //parse name and type from url
528 if (GNUNET_OK != parse_url (conndata_handle->url, handle))
530 GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Error parsing url...\n");
531 GNUNET_SCHEDULER_add_now (&do_error, handle);
534 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
536 handle->gns = GNUNET_GNS_connect (cfg);
537 handle->identity = GNUNET_IDENTITY_connect (cfg, NULL, NULL);
538 handle->timeout_task = GNUNET_SCHEDULER_add_delayed (handle->timeout,
540 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
542 if (NULL == handle->gns)
544 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
545 "Connecting to GNS failed\n");
546 GNUNET_SCHEDULER_add_now (&do_error, handle);
549 GNUNET_CRYPTO_hash (GNUNET_REST_JSONAPI_GNS_OPTIONS,
550 strlen (GNUNET_REST_JSONAPI_GNS_OPTIONS),
552 handle->options = GNUNET_GNS_LO_DEFAULT;
554 GNUNET_CONTAINER_multihashmap_contains (conndata_handle->url_param_map,
557 handle->options = GNUNET_GNS_LO_DEFAULT;//TODO(char*) GNUNET_CONTAINER_multihashmap_get (conndata_handle->url_param_map,
560 GNUNET_CRYPTO_hash (GNUNET_REST_JSONAPI_GNS_RECORD_TYPE,
561 strlen (GNUNET_REST_JSONAPI_GNS_RECORD_TYPE),
564 GNUNET_CONTAINER_multihashmap_contains (conndata_handle->url_param_map,
567 handle->type = GNUNET_GNSRECORD_typename_to_number
568 (GNUNET_CONTAINER_multihashmap_get (conndata_handle->url_param_map,
572 handle->type = GNUNET_GNSRECORD_TYPE_ANY;
574 GNUNET_CRYPTO_hash (GNUNET_REST_JSONAPI_GNS_PKEY,
575 strlen (GNUNET_REST_JSONAPI_GNS_PKEY),
578 GNUNET_CONTAINER_multihashmap_contains (conndata_handle->url_param_map,
581 handle->pkey_str = GNUNET_CONTAINER_multihashmap_get (conndata_handle->url_param_map,
584 GNUNET_CRYPTO_ecdsa_public_key_from_string (handle->pkey_str,
585 strlen(handle->pkey_str),
588 GNUNET_SCHEDULER_add_now (&do_error, handle);
591 lookup_with_public_key (handle);
594 GNUNET_CRYPTO_hash (GNUNET_REST_JSONAPI_GNS_EGO,
595 strlen (GNUNET_REST_JSONAPI_GNS_EGO),
598 GNUNET_CONTAINER_multihashmap_contains (conndata_handle->url_param_map,
601 handle->ego_str = GNUNET_CONTAINER_multihashmap_get (conndata_handle->url_param_map,
603 handle->el = GNUNET_IDENTITY_ego_lookup (cfg,
609 if ( (NULL != handle->name) &&
610 (strlen (handle->name) > 4) &&
611 (0 == strcmp (".zkey",
612 &handle->name[strlen (handle->name) - 4])) )
614 GNUNET_CRYPTO_ecdsa_key_get_public
615 (GNUNET_CRYPTO_ecdsa_key_get_anonymous (),
617 lookup_with_public_key (handle);
621 GNUNET_break (NULL == handle->id_op);
622 handle->id_op = GNUNET_IDENTITY_get (handle->identity,
626 GNUNET_assert (NULL != handle->id_op);
631 * Entry point for the plugin.
633 * @param cls the "struct GNUNET_NAMESTORE_PluginEnvironment*"
634 * @return NULL on error, otherwise the plugin context
637 libgnunet_plugin_rest_gns_init (void *cls)
639 static struct Plugin plugin;
641 struct GNUNET_REST_Plugin *api;
643 if (NULL != plugin.cfg)
644 return NULL; /* can only initialize once! */
645 memset (&plugin, 0, sizeof (struct Plugin));
647 api = GNUNET_new (struct GNUNET_REST_Plugin);
649 api->name = API_NAMESPACE;
650 api->process_request = &rest_gns_process_request;
651 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
652 _("GNS REST API initialized\n"));
658 * Exit point from the plugin.
660 * @param cls the plugin context (as returned by "init")
661 * @return always NULL
664 libgnunet_plugin_rest_gns_done (void *cls)
666 struct GNUNET_REST_Plugin *api = cls;
667 struct Plugin *plugin = api->cls;
671 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
672 "GNS REST plugin is finished\n");
676 /* end of plugin_rest_gns.c */