/usr/include/x86_64-linux-gnu/aj_authentication.h is in liballjoyntcl-dev-1504 15.04b-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 | #ifndef _AJ_AUTHENTICATION_H
#define _AJ_AUTHENTICATION_H
/**
* @file aj_authentication.h
* @defgroup aj_authentication Implementation of Authentication mechanisms
* @{
*/
/******************************************************************************
* Copyright AllSeen Alliance. All rights reserved.
*
* Permission to use, copy, modify, and/or distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
******************************************************************************/
#include "aj_bus.h"
#include "aj_config.h"
#include "aj_target.h"
#include "aj_crypto_ecc.h"
#include "aj_crypto_sha2.h"
#ifdef __cplusplus
extern "C" {
#endif
/* The key exchange is in the 16 MSB */
#define AUTH_KEYX_ECDHE 0x00400000
/* The key authentication suite is in the 16 LSB */
#define AUTH_SUITE_ECDHE_NULL (AUTH_KEYX_ECDHE | 0x0001)
#define AUTH_SUITE_ECDHE_PSK (AUTH_KEYX_ECDHE | 0x0002)
#define AUTH_SUITE_ECDHE_ECDSA (AUTH_KEYX_ECDHE | 0x0004)
#define AJ_AUTH_SUITES_NUM 3 /**< Number of supported authentication suites */
#define AUTH_CLIENT 0
#define AUTH_SERVER 1
typedef struct _KeyExchangeContext {
ecc_publickey pub;
ecc_privatekey prv;
} KeyExchangeContext;
/**
* Context for PSK authentication
* Memory is not allocated and copied
* The pointer addresses memory that exists in the lifetime of its usage
*/
typedef struct _PSKContext {
uint8_t* hint; /**< PSK hint */
size_t size; /**< Size of PSK hint */
} PSKContext;
typedef struct _KeyAuthenticationContext {
PSKContext psk; /**< Context for PSK authentication */
} KeyAuthenticationContext;
/**
* Authentication context
*/
typedef struct _AJ_AuthenticationContext {
AJ_BusAttachment* bus; /**< Bus attachement - required for auth callbacks */
uint8_t role; /**< Role (client or server) */
uint32_t suite; /**< Authentication suite */
uint32_t version; /**< Protocol version */
AJ_SHA256_Context hash; /**< Running hash of exchanged messages */
KeyExchangeContext kectx; /**< Context for key exchange step */
KeyAuthenticationContext kactx; /**< Context for key authentication step */
uint8_t mastersecret[AJ_MASTER_SECRET_LEN]; /**< Master secret */
uint32_t expiration; /**< Master secret expiration */
} AJ_AuthenticationContext;
/**
* Marshal a key exchange message
*
* @param ctx The authentication context
* @param msg The outgoing message
*
* @return
* - AJ_OK on success
* - An error status otherwise
*/
AJ_Status AJ_KeyExchangeMarshal(AJ_AuthenticationContext* ctx, AJ_Message* msg);
/**
* Unmarshal a key exchange message
*
* @param ctx The authentication context
* @param msg The incoming message
*
* @return
* - AJ_OK on success
* - An error status otherwise
*/
AJ_Status AJ_KeyExchangeUnmarshal(AJ_AuthenticationContext* ctx, AJ_Message* msg);
/**
* Marshal a key authentication message
*
* @param ctx The authentication context
* @param msg The outgoing message
*
* @return
* - AJ_OK on success
* - An error status otherwise
*/
AJ_Status AJ_KeyAuthenticationMarshal(AJ_AuthenticationContext* ctx, AJ_Message* msg);
/**
* Unmarshal a key authentication message
*
* @param ctx The authentication context
* @param msg The incoming message
*
* @return
* - AJ_OK on success
* - An error status otherwise
*/
AJ_Status AJ_KeyAuthenticationUnmarshal(AJ_AuthenticationContext* ctx, AJ_Message* msg);
/**
* Check if an authentication suite is available
*
* @param suite The authentication suite to check
* @param version The authentication protocol version
*
* @return Return true or false
*/
uint8_t AJ_IsSuiteEnabled(uint32_t suite, uint32_t version);
/**
* Enable an authentication suite
*
* @param suite The authentication suite to enable
*/
void AJ_EnableSuite(uint32_t suite);
#ifdef __cplusplus
}
#endif
/**
* @}
*/
#endif
|