iso_connection_parameters.h

Go to the documentation of this file.

/*
 *  iso_connection_parameters.h
 *
 *  This file is part of libmms/libtase2.
 *
 *  Copyright 2013-2023 Michael Zillgihs
 *
 *  All rights reserved.
 */
 
#ifndef ISO_CONNECTION_PARAMETERS_H_
#define ISO_CONNECTION_PARAMETERS_H_
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "tls_config.h"
#include "hal_socket.h"
#include "libmms_common_api.h"
#include "asecurity.h"
#include <stdint.h>
 
typedef struct {
    uint16_t arc[10];
    int arcCount;
} ItuObjectIdentifier;
 
LIBMMS_API void
ItuObjectIdentifier_setFromString(ItuObjectIdentifier* self, const char* str);
 
LIBMMS_API char*
ItuObjectIdentifier_toString(ItuObjectIdentifier* self);
 
typedef struct {
    ItuObjectIdentifier apTitle;
    int aeQualifier;
} IsoApplicationReference;
 
typedef enum
{
    ACSE_AUTH_NONE = 0,
 
    ACSE_AUTH_PASSWORD = 1,
 
    ACSE_AUTH_CERTIFICATE = 2,
 
    ACSE_AUTH_TLS = 3,
 
    ACSE_AUTH_MECH_UNKNOWN = 99
} AcseAuthenticationMechanism;
 
typedef enum {
    ACSE_USER_OK = 0,
    ACSE_USER_NO_REASON_GIVEN = 1,
    ACSE_USER_APP_CONTEXT_NAME_NOT_SUPPORTED = 2,
    ACSE_USER_CALLING_AP_TITLE_NOT_RECOGNIZED = 3,
    ACSE_USER_CALLING_AP_INVOCATION_ID_NOT_RECOGNIZED = 4,
    ACSE_USER_CALLING_AE_QUALIFIER_NOT_RECOGNIZED = 5,
    ACSE_USER_CALLING_AE_INVOCATION_ID_NOT_RECOGNIZED = 6,
    ACSE_USER_CALLED_AP_TITLE_NOT_RECOGNIZED = 7,
    ACSE_USER_CALLED_AP_INVOCATION_ID_NOT_RECOGNIZED = 8,
    ACSE_USER_CALLED_AE_QUALIFIER_NOT_RECOGNIZED = 9,
    ACSE_USER_CALLED_AE_INVOCATION_ID_NOT_RECOGNIZED = 10,
    ACSE_USER_AUTH_MECH_NAME_NOT_RECOGNIZED = 11,
    ACSE_USER_AUTH_MECH_NAME_REQUIRED = 12,
    ACSE_USER_AUTH_FAILURE = 13,
    ACSE_USER_AUTH_REQUIRED = 14,
} AcseServiceUserDiagnostics;
 
const char*
AcseServiceUserDiagnostics_toString(AcseServiceUserDiagnostics diag);
 
typedef struct sAcseAuthenticationParameter* AcseAuthenticationParameter;
 
struct sAcseAuthenticationParameter
{
    AcseAuthenticationMechanism mechanism;
 
    union
    {
        struct
        {
            uint8_t* octetString;
            int passwordLength;
        } password; /* for mechanism = ACSE_AUTH_PASSWORD */
 
        struct
        {
            uint8_t* buf;
            int length;
        } certificate; /* for mechanism = ACSE_AUTH_CERTIFICATE or ACSE_AUTH_TLS */
 
    } value;
};
 
AcseAuthenticationParameter
AcseAuthenticationParameter_create(void);
 
void
AcseAuthenticationParameter_destroy(AcseAuthenticationParameter self);
 
void
AcseAuthenticationParameter_setAuthMechanism(AcseAuthenticationParameter self, AcseAuthenticationMechanism mechanism);
 
void
AcseAuthenticationParameter_setPassword(AcseAuthenticationParameter self, char* password);
 
typedef struct {
    uint8_t size; 
    uint8_t value[16]; 
} TSelector;
 
typedef struct {
    uint8_t size; 
    uint8_t value[16]; 
} SSelector;
 
typedef struct {
    uint8_t size; 
    uint8_t value[16]; 
} PSelector;
 
typedef struct sIsoApplicationAddress* IsoApplicationAddress;
 
struct sIsoApplicationAddress
{
    unsigned int hasAeQualifier:1;
    unsigned int hasAeInvocationId:1;
    unsigned int hasApInvocationId:1;
 
    ItuObjectIdentifier apTitle;
    int aeQualifier;
    int aeInvocationId;
    int apInvocationId;
    PSelector pSelector;
    SSelector sSelector;
    TSelector tSelector;
};
 
typedef AcseServiceUserDiagnostics
(*AcseAuthenticator)(void* parameter, AcseAuthenticationParameter authParameter, void** securityToken, IsoApplicationAddress localAppAddr, IsoApplicationAddress remoteAppAddr, Socket socket);
 
typedef ASecurityConfiguration
(*AcseALSConfigurationProvider)(void* parameter, IsoApplicationAddress localAppRef, IsoApplicationAddress remoteAppRef, Socket socket);
 
LIBMMS_API void
IsoApplicationAddress_setApTitle(IsoApplicationAddress self, const char* apTitle);
 
LIBMMS_API void
IsoApplicationAddress_setAeQualifier(IsoApplicationAddress self, int aeQualifier);
 
LIBMMS_API void
IsoApplicationAddress_setAeInvocationId(IsoApplicationAddress self, int aeInvocationId);
 
LIBMMS_API void
IsoApplicationAddress_setApInvocationId(IsoApplicationAddress self, int apInvocationId);
 
LIBMMS_API void
IsoApplicationAddress_setLowerLayerAddresses(IsoApplicationAddress self, PSelector pSelector, SSelector sSelector, TSelector tSelector);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ISO_CONNECTION_PARAMETERS_H_ */