nrf_cc3xx_platform_derived_key.h

Go to the documentation of this file.

/*
 * Copyright (c) 2021 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
#include <stdint.h>
 
#ifndef NRF_CC3XX_PLATFORM_DERIVED_KEY__
#define NRF_CC3XX_PLATFORM_DERIVED_KEY__
 
typedef enum {
    ALG_AES_128_BIT         = 1,
    ALG_AES_256_BIT         = 2,
    ALG_CHACHA20_256_BIT    = 3,
    ALG_CHACHAPOLY_256_BIT  = 3 /* Intentionally the same as CHACHA20 */
} nrf_cc3xx_platform_cipher_info_t;
 
typedef struct{
    uint32_t            slot_id;        
    size_t              key_size;       
    const uint8_t     * label;          
    size_t              label_size;     
    const uint8_t     * context;        
    size_t              context_size;   
} nrf_cc3xx_platform_derivation_info_t;
 
typedef struct{
    const uint8_t     * nonce;      
    size_t              nonce_size; 
    const uint8_t     * aad;        
    size_t              aad_size;   
    uint8_t           * tag;        
    size_t              tag_size;   
} nrf_cc3xx_platform_auth_info_t;
 
typedef struct{
    nrf_cc3xx_platform_derivation_info_t    deriv_info;     
    nrf_cc3xx_platform_cipher_info_t        cipher_info;    
    nrf_cc3xx_platform_auth_info_t          auth_info;      
    size_t                                  state;          
} nrf_cc3xx_platform_derived_key_ctx_t;
 
int nrf_cc3xx_platform_derived_key_init(nrf_cc3xx_platform_derived_key_ctx_t * ctx);
 
 
int nrf_cc3xx_platform_derived_key_set_info(nrf_cc3xx_platform_derived_key_ctx_t * ctx,
                                            uint32_t slot_id,
                                            unsigned int key_size,
                                            uint8_t const * label,
                                            size_t label_size);
 
 
int nrf_cc3xx_platform_derived_key_set_cipher(nrf_cc3xx_platform_derived_key_ctx_t * ctx,
                                              nrf_cc3xx_platform_cipher_info_t cipher_info);
 
int nrf_cc3xx_platform_derived_key_set_auth_info(nrf_cc3xx_platform_derived_key_ctx_t * ctx,
                                                 const uint8_t * nonce,
                                                 size_t nonce_size,
                                                 const uint8_t * aad,
                                                 size_t aad_size,
                                                 uint8_t * tag,
                                                 size_t tag_size);
 
 
int nrf_cc3xx_platform_derived_key_encrypt(nrf_cc3xx_platform_derived_key_ctx_t * ctx,
                                           uint8_t * output,
                                           size_t input_size,
                                           uint8_t const * input);
 
 
int nrf_cc3xx_platform_derived_key_decrypt(nrf_cc3xx_platform_derived_key_ctx_t * ctx,
                                           uint8_t * output,
                                           size_t input_size,
                                           uint8_t const * input);
 
#endif /* NRF_CC3XX_PLATFORM_DERIVED_KEY__ */