summaryrefslogtreecommitdiff
path: root/src/backend/anastasis-httpd.h
blob: b84088d8b0a10633419dd39a497473b44543d517 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
/*
  This file is part of Anastasis
  Copyright (C) 2019 Anastasis SARL

  Anastasis is free software; you can redistribute it and/or modify it under the
  terms of the GNU Affero General Public License as published by the Free Software
  Foundation; either version 3, or (at your option) any later version.

  Anastasis is distributed in the hope that it will be useful, but WITHOUT ANY
  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License along with
  Anastasis; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
*/
/**
 * @file backend/anastasis-httpd.h
 * @brief HTTP serving layer
 * @author Christian Grothoff
 */
#ifndef ANASTASIS_HTTPD_H
#define ANASTASIS_HTTPD_H

#include "platform.h"
#include "anastasis_database_lib.h"
#include <microhttpd.h>
#include <taler/taler_mhd_lib.h>
#include <gnunet/gnunet_mhd_compat.h>


/**
 * For how many years do we allow users to store truth at most? Also
 * how long we store things if the cost is zero.
 */
#define ANASTASIS_MAX_YEARS_STORAGE 5


/**
 * @brief Struct describing an URL and the handler for it.
 */
struct AH_RequestHandler
{

  /**
   * URL the handler is for.
   */
  const char *url;

  /**
   * Method the handler is for, NULL for "all".
   */
  const char *method;

  /**
   * Mime type to use in reply (hint, can be NULL).
   */
  const char *mime_type;

  /**
   * Raw data for the @e handler
   */
  const void *data;

  /**
   * Number of bytes in @e data, 0 for 0-terminated.
   */
  size_t data_size;


  /**
   * Function to call to handle the request.
   *
   * @param rh this struct
   * @param connection the MHD connection to handle
   * @return MHD result code
   */
  MHD_RESULT (*handler)(struct AH_RequestHandler *rh,
                        struct MHD_Connection *connection);

  /**
   * Default response code.
   */
  unsigned int response_code;
};


/**
 * Each MHD response handler that sets the "connection_cls" to a
 * non-NULL value must use a struct that has this struct as its first
 * member.  This struct contains a single callback, which will be
 * invoked to clean up the memory when the contection is completed.
 */
struct TM_HandlerContext;

/**
 * Signature of a function used to clean up the context
 * we keep in the "connection_cls" of MHD when handling
 * a request.
 *
 * @param hc header of the context to clean up.
 */
typedef void
(*TM_ContextCleanup)(struct TM_HandlerContext *hc);


/**
 * Each MHD response handler that sets the "connection_cls" to a
 * non-NULL value must use a struct that has this struct as its first
 * member.  This struct contains a single callback, which will be
 * invoked to clean up the memory when the connection is completed.
 */
struct TM_HandlerContext
{

  /**
   * Function to execute the handler-specific cleanup of the
   * (typically larger) context.
   */
  TM_ContextCleanup cc;

  /**
   * Handler-specific context.
   */
  void *ctx;

  /**
   * Which request handler is handling this request?
   */
  const struct AH_RequestHandler *rh;

  /**
   * URL requested by the client, for logging.
   */
  const char *url;

  /**
   * Asynchronous request context id.
   */
  struct GNUNET_AsyncScopeId async_scope_id;
};

/**
 * Handle to the database backend.
 */
extern struct ANASTASIS_DatabasePlugin *db;

/**
 * Upload limit to the service, in megabytes.
 */
extern unsigned long long AH_upload_limit_mb;

/**
 * Annual fee for the backup account.
 */
extern struct TALER_Amount AH_annual_fee;

/**
 * Fee for a truth upload.
 */
extern struct TALER_Amount AH_truth_upload_fee;

/**
 * Amount of insurance.
 */
extern struct TALER_Amount AH_insurance;

/**
 * Cost for secure question truth download.
 */
extern struct TALER_Amount AH_question_cost;

/**
 * Our Taler backend to process payments.
 */
extern char *AH_backend_url;

/**
 * Taler currency.
 */
extern char *AH_currency;

/**
 * Our configuration.
 */
extern const struct GNUNET_CONFIGURATION_Handle *AH_cfg;

/**
 * Number of policy uploads permitted per annual fee payment.
 */
extern unsigned long long AH_post_counter;

/**
 * Our fulfillment URL
 */
extern char *AH_fulfillment_url;

/**
 * Our business name.
 */
extern char *AH_business_name;

/**
 * Our server salt.
 */
extern struct ANASTASIS_CRYPTO_ProviderSaltP AH_server_salt;

/**
 * Our context for making HTTP requests.
 */
extern struct GNUNET_CURL_Context *AH_ctx;


/**
 * Kick MHD to run now, to be called after MHD_resume_connection().
 * Basically, we need to explicitly resume MHD's event loop whenever
 * we made progress serving a request.  This function re-schedules
 * the task processing MHD's activities to run immediately.
 *
 * @param cls NULL
 */
void
AH_trigger_daemon (void *cls);

/**
 * Kick GNUnet Curl scheduler to begin curl interactions.
 */
void
AH_trigger_curl (void);

#endif