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
|
// Copyright 2015 The Weave Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef LIBUWEAVE_SRC_MACAROON_H_
#define LIBUWEAVE_SRC_MACAROON_H_
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include "macaroon_caveat.h"
#define UW_MACAROON_MAC_LEN 16
// Note: If we are looking to make memory savings on MCUs,
// at the cost of a little extra processing, we can make
// the macaroon encoding the actual in-memory representation.
// This can save much copying of macaroon data if need be.
typedef struct {
uint8_t mac_tag[UW_MACAROON_MAC_LEN];
size_t num_caveats;
const UwMacaroonCaveat* caveats;
} UwMacaroon;
bool uw_macaroon_new_from_mac_tag_(UwMacaroon* new_macaroon,
const uint8_t mac_tag[UW_MACAROON_MAC_LEN],
const UwMacaroonCaveat* caveats,
size_t num_caveats);
bool uw_macaroon_new_from_root_key_(UwMacaroon* new_macaroon,
const uint8_t* root_key,
size_t root_key_len,
const UwMacaroonCaveat* caveats,
size_t num_caveats);
bool uw_macaroon_verify_(const UwMacaroon* macaroon,
const uint8_t* root_key,
size_t root_key_len);
// Create a new macaroon with a new caveat
bool uw_macaroon_extend_(const UwMacaroon* old_macaroon,
UwMacaroon* new_macaroon,
const UwMacaroonCaveat* additional_caveat,
uint8_t* buffer, size_t buffer_size);
// Encode a Macaroon to a byte string
bool uw_macaroon_dump_(const UwMacaroon* macaroon,
uint8_t* out,
size_t out_len,
size_t* resulting_str_len);
// Decode a byte string to a Macaroon (the caveats_buffer here is used only for
// the caveat pointer list *caveats in the UwMacaroon *macaroon). One note is
// that the function doesn't copy string values to new buffers, so the caller
// may maintain the input string around to make caveats with string values to
// be usuable.
bool uw_macaroon_load_(const uint8_t* in,
size_t in_len,
uint8_t* caveats_buffer,
size_t caveats_buffer_size,
UwMacaroon* macaroon);
#endif // LIBUWEAVE_SRC_MACAROON_H_
|
