nrf_cc3xx_platform_shadow_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_SHADOW_KEY__
#define NRF_CC3XX_PLATFORM_SHADOW_KEY__
 
#define NRF_CC3XX_SHADOW_KEY_MAX_INPLACE_CHUNK_SIZE (512)
#define NRF_CC3XX_SHADOW_AEAD_CONTEXT_SIZE_WORDS (66)
 
typedef enum {
    MODE_ENCRYPT,
    MODE_DECRYPT
} nrf_cc3xx_platform_shadow_key_enc_mode_t;
 
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_shadow_key_enc_cipher_t;
 
typedef struct{
    uint32_t            slot_id;        
    size_t              key_size;       
    uint8_t const       *label;         
    size_t              label_size;     
} nrf_cc3xx_platform_shadow_key_derivation_info_t;
 
typedef struct{
    size_t                                          state;
    nrf_cc3xx_platform_shadow_key_enc_mode_t        mode;
    nrf_cc3xx_platform_shadow_key_derivation_info_t deriv_info;
    nrf_cc3xx_platform_shadow_key_enc_cipher_t      enc_cipher;
    union{
        /* The cc3xx_aead_operation size is opaque so only its size is written here */
        uint32_t cc3xx_aead[NRF_CC3XX_SHADOW_AEAD_CONTEXT_SIZE_WORDS];
    } driver_ctx;
} nrf_cc3xx_platform_shadow_key_ctx_t;
 
 
int nrf_cc3xx_platform_shadow_key_init(nrf_cc3xx_platform_shadow_key_ctx_t * ctx,
                                       uint32_t slot_id,
                                       unsigned int deriv_key_size,
                                       uint8_t const * label,
                                       size_t label_size);
 
int nrf_cc3xx_platform_shadow_key_crypt_setup(nrf_cc3xx_platform_shadow_key_ctx_t * ctx,
                                              nrf_cc3xx_platform_shadow_key_enc_cipher_t cipher,
                                              nrf_cc3xx_platform_shadow_key_enc_mode_t mode,
                                              const uint8_t * nonce,
                                              size_t nonce_size,
                                              const uint8_t * aad,
                                              size_t aad_size,
                                              size_t plaintext_size);
 
 
int nrf_cc3xx_platform_shadow_key_crypt_update(nrf_cc3xx_platform_shadow_key_ctx_t * ctx,
                                               uint8_t const * input,
                                               size_t input_size,
                                               uint8_t * output,
                                               size_t output_size,
                                               size_t * output_length);
 
int nrf_cc3xx_platform_shadow_key_crypt_finish(nrf_cc3xx_platform_shadow_key_ctx_t * ctx,
                                               uint8_t * output,
                                               size_t output_size,
                                               size_t *output_length,
                                               uint8_t * tag,
                                               size_t tag_size,
                                               size_t *tag_length);
 
 
#endif /* NRF_CC3XX_PLATFORM_SHADOW_KEY__ */