coap_crypto_internal.h

Go to the documentation of this file.

/* -*- Mode: C; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
 
/*
 * coap_crypto_internal.h -- Structures, Enums & Functions that are not
 * exposed to application programming
 *
 * Copyright (C) 2017-2025 Olaf Bergmann <bergmann@tzi.org>
 * Copyright (C) 2021-2025 Jon Shallow <supjps-libcoap@jpshallow.com>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 *
 * This file is part of the CoAP library libcoap. Please see README for terms
 * of use.
 */
 
#ifndef COAP_CRYPTO_INTERNAL_H_
#define COAP_CRYPTO_INTERNAL_H_
 
#include "oscore/oscore_cose.h"
 
#ifndef COAP_CRYPTO_MAX_KEY_SIZE
#define COAP_CRYPTO_MAX_KEY_SIZE (32)
#endif /* COAP_CRYPTO_MAX_KEY_SIZE */
 
#ifndef COAP_OSCORE_DEFAULT_REPLAY_WINDOW
#define COAP_OSCORE_DEFAULT_REPLAY_WINDOW 32
#endif /* COAP_OSCORE_DEFAULT_REPLAY_WINDOW */
 
typedef coap_bin_const_t coap_crypto_key_t;
 
typedef struct coap_crypto_aes_ccm_t {
  coap_crypto_key_t key; 
  const uint8_t *nonce;  
  size_t tag_len;        
  size_t l;              
} coap_crypto_aes_ccm_t;
 
typedef struct coap_crypto_param_t {
  cose_alg_t alg; 
  union {
    coap_crypto_aes_ccm_t aes; 
    coap_crypto_key_t key;     
  } params;
} coap_crypto_param_t;
 
int coap_crypto_check_cipher_alg(cose_alg_t alg);
 
int coap_crypto_check_hkdf_alg(cose_hkdf_alg_t hkdf_alg);
 
int coap_crypto_aead_encrypt(const coap_crypto_param_t *params,
                             coap_bin_const_t *data,
                             coap_bin_const_t *aad,
                             uint8_t *result,
                             size_t *max_result_len);
 
int coap_crypto_aead_decrypt(const coap_crypto_param_t *params,
                             coap_bin_const_t *data,
                             coap_bin_const_t *aad,
                             uint8_t *result,
                             size_t *max_result_len);
 
int coap_crypto_hmac(cose_hmac_alg_t hmac_alg,
                     coap_bin_const_t *key,
                     coap_bin_const_t *data,
                     coap_bin_const_t **hmac);
 
int coap_crypto_hash(cose_alg_t alg,
                     const coap_bin_const_t *data,
                     coap_bin_const_t **hash);
 
#endif /* COAP_CRYPTO_INTERNAL_H_ */