coap_oscore.h

Go to the documentation of this file.

/*
 * Copyright (c) 2026 Martin Schröder <info@swedishembedded.com>
 * Copyright (c) 2026 Siemens AG
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef ZEPHYR_INCLUDE_NET_COAP_OSCORE_H_
#define ZEPHYR_INCLUDE_NET_COAP_OSCORE_H_
 
#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>
 
#include <zephyr/net/net_ip.h>
#include <zephyr/net/coap.h>
 
#ifdef __cplusplus
extern "C" {
#endif


struct coap_oscore_exchange {
        struct net_sockaddr_storage addr;  
        net_socklen_t addr_len;            
        uint8_t token[COAP_TOKEN_MAX_LEN]; 
        uint8_t tkl;                       
        int64_t timestamp;                 
};

struct coap_oscore_context;

enum coap_oscore_aead_alg {
        COAP_OSCORE_AEAD_AES_CCM_16_64_128 = 0,
};

enum coap_oscore_hkdf {
        COAP_OSCORE_HKDF_SHA_256 = 0,
};

struct coap_oscore_init_params {
        const uint8_t *master_secret;
        size_t master_secret_len;

        const uint8_t *sender_id;
        size_t sender_id_len;

        const uint8_t *recipient_id;
        size_t recipient_id_len;

        const uint8_t *master_salt;
        size_t master_salt_len;

        const uint8_t *id_context;
        size_t id_context_len;

        enum coap_oscore_aead_alg aead_alg;
        enum coap_oscore_hkdf hkdf;

        bool fresh_master_secret_salt;
};

int coap_oscore_context_init(struct coap_oscore_init_params *params,
                             struct coap_oscore_context **ctx);

void coap_oscore_context_free(struct coap_oscore_context *ctx);

 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_NET_COAP_OSCORE_H_ */