summaryrefslogtreecommitdiff
path: root/src/irmd/oap.h
blob: 25c07408acf488a2a8bd94d3fac6acc02056c6b6 (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
/*
 * Ouroboros - Copyright (C) 2016 - 2024
 *
 * Ouroboros Allocation Protocol (OAP) Component
 *
 *    Dimitri Staessens <dimitri@ouroboros.rocks>
 *    Sander Vrijders   <sander@ouroboros.rocks>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., http://www.fsf.org/about/contact/.
 */

#ifndef OUROBOROS_IRMD_OAP_H
#define OUROBOROS_IRMD_OAP_H

#include <ouroboros/crypt.h>
#include <ouroboros/flow.h>
#include <ouroboros/name.h>
#include <ouroboros/utils.h>

/* OAP authentication state (in oap/auth.c) */
int  oap_auth_init(void);

void oap_auth_fini(void);

int  oap_auth_add_ca_crt(void * crt);

/*
* Prepare OAP request header for server, returns context
* Passes client data for srv, returns srv data for client
*/
int  oap_cli_prepare(void **                  ctx,
                     const struct name_info * info,
                     buffer_t *               req_buf,
                     buffer_t                 data);

/*
 * Server processes header, creates response header, returns secret key.
 * data is in/out: input=srv data to send, output=cli data received.
 */
int  oap_srv_process(const struct name_info * info,
                     buffer_t                 req_buf,
                     buffer_t *               rsp_buf,
                     buffer_t *               data,
                     struct crypt_sk *        sk);

/* Complete OAP, returns secret key and server data, frees ctx */
int  oap_cli_complete(void *                   ctx,
                      const struct name_info * info,
                      buffer_t                 rsp_buf,
                      buffer_t *               data,
                      struct crypt_sk *        sk);

/* Free OAP state (on failure before complete) */
void oap_ctx_free(void * ctx);

#endif /* OUROBOROS_IRMD_OAP_H */