credman.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2019 HAW Hamburg
 * SPDX-License-Identifier: LGPL-2.1-only
 */
 
#pragma once
 
#include <unistd.h>
#include <stdint.h>
#include "modules.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#ifndef CONFIG_CREDMAN_MAX_CREDENTIALS
#define CONFIG_CREDMAN_MAX_CREDENTIALS  (2)
#endif
 
#ifndef CONFIG_CREDMAN_MAX_ASN1_OBJ
#define CONFIG_CREDMAN_MAX_ASN1_OBJ  (8)
#endif
typedef struct {
    const void *s;          
    size_t len;             
} credman_buffer_t;
 
typedef struct {
    credman_buffer_t key;   
    credman_buffer_t id;    
    credman_buffer_t hint;  
} psk_params_t;
 
typedef struct {
    const void *x;          
    const void *y;          
} ecdsa_public_key_t;
 
typedef struct {
    const void *private_key;            
    ecdsa_public_key_t public_key;      
    ecdsa_public_key_t *client_keys;    
    size_t client_keys_size;            
} ecdsa_params_t;
 
typedef uint16_t credman_tag_t;
 
#define CREDMAN_TAG_EMPTY   (0)
 
typedef enum {
    CREDMAN_TYPE_EMPTY  = 0,
    CREDMAN_TYPE_PSK    = 1,    
    CREDMAN_TYPE_ECDSA  = 2,    
} credman_type_t;
 
typedef struct {
    credman_type_t type;        
    credman_tag_t tag;          
    union {
        psk_params_t psk;       
        ecdsa_params_t ecdsa;   
    } params;                   
} credman_credential_t;
 
enum {
    CREDMAN_OK              = 0,    
    CREDMAN_EXIST           = -1,   
    CREDMAN_NO_SPACE        = -2,   
    CREDMAN_NOT_FOUND       = -3,   
    CREDMAN_INVALID         = -4,   
    CREDMAN_TYPE_UNKNOWN    = -5,   
    CREDMAN_ERROR           = -6,   
};
 
int credman_add(const credman_credential_t *credential);
 
int credman_get(credman_credential_t *credential, credman_tag_t tag,
                credman_type_t type);
 
void credman_delete(credman_tag_t tag, credman_type_t type);
 
int credman_get_used_count(void);
 
#if IS_USED(MODULE_CREDMAN_LOAD) || DOXYGEN
int credman_load_public_key(const void *buf, size_t buf_len, ecdsa_public_key_t *out);
 
int credman_load_private_key(const void *buf, size_t buf_len, credman_credential_t *cred);
 
int credman_load_private_ecc_key(const void *buf, size_t buf_len, credman_credential_t *cred);
#endif /* MODULE_CREDMAN_LOAD || DOXYGEN */
 
#ifdef TEST_SUITES
void credman_reset(void);
#endif /*TEST_SUITES */
 
#ifdef __cplusplus
}
#endif