blob: 61242f736d830635c88b0c9b64004c8cebb5387d [file] [log] [blame]
// 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.
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include "macaroon_caveat.h"
// 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);