5g-team
/
srsRAN_4G
mirror of https://github.com/pvnis/srsRAN_4G.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
fix-cqi
master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'bce6b5cc0f'
${ noResults }
srsRAN_4G/lib/include/srsran/common/liblte_security.h

353 lines
16 KiB
C
Raw Normal View History Unescape Escape

update license header for liblte_*.{h,cc} files user license-agnostic text to refer to license file. make sure copyrights/years are correct.
4 years ago
/**
*
* \section COPYRIGHT
*
* Copyright 2014 Ben Wojtowicz
* 2016-2020 Software Radio Systems Limited
*
* By using this file, you agree to the terms and conditions set
* forth in the LICENSE file which can be found at the top level of
* the distribution.
*
*/
adding liblte sources
8 years ago
rename srsLTE to srsRAN
4 years ago
#ifndef SRSRAN_LIBLTE_SECURITY_H
#define SRSRAN_LIBLTE_SECURITY_H
adding liblte sources
8 years ago
/*******************************************************************************
INCLUDES
*******************************************************************************/
rename srsLTE to srsRAN
4 years ago
#include "srsran/asn1/liblte_common.h"
adding liblte sources
8 years ago
/*******************************************************************************
DEFINES
*******************************************************************************/
/*******************************************************************************
TYPEDEFS
*******************************************************************************/
/*******************************************************************************
DECLARATIONS
*******************************************************************************/
Added OPc option to UE. (needs testing.)
6 years ago
/*********************************************************************
Name: compute_OPc
Description: Computes OPc from OP and K.
Document Reference: 35.206 v10.0.0 Annex 3
*********************************************************************/
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_compute_opc(uint8* k, uint8* op, uint8* op_c);
Added OPc option to UE. (needs testing.)
6 years ago
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_generate_k_asme
Description: Generate the security key Kasme.
Document Reference: 33.401 v10.0.0 Annex A.2
*********************************************************************/
// Defines
// Enums
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM
liblte_security_generate_k_asme(uint8* ck, uint8* ik, uint8* ak, uint8* sqn, uint16 mcc, uint16 mnc, uint8* k_asme);
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_generate_k_enb
Description: Generate the security key Kenb.
Document Reference: 33.401 v10.0.0 Annex A.2
*********************************************************************/
// Defines
// Enums
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_security_generate_k_enb(uint8* k_asme, uint32 nas_count, uint8* k_enb);
adding liblte sources
8 years ago
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_security_generate_k_enb_star(uint8* k_enb, uint32 pci, uint32_t earfcn, uint8* k_enb_star);
X2 (constant NCC) working
7 years ago
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_security_generate_nh(uint8_t* k_asme, uint8_t* sync, uint8_t* nh);
S1/X2 handover tested and working
7 years ago
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_generate_k_nas
Description: Generate the NAS security keys KNASenc and KNASint.
Document Reference: 33.401 v10.0.0 Annex A.2
*********************************************************************/
// Defines
// Enums
Clang-formated liblte_*
5 years ago
typedef enum {
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_EEA0 = 0,
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_128_EEA1,
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_128_EEA2,
First ZUC working test case
6 years ago
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_128_EEA3,
Clang-formated liblte_*
5 years ago
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_N_ITEMS,
} LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_ENUM;
static const char liblte_security_ciphering_algorithm_id_text[LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_N_ITEMS][20] = {
Clang format UE, eNB and lib (#850) * Clang-formated UE, eNB and lib. * Fixed compiling errors from clang-format. * Fix linking issues introduced by clang-format * Fix poor formating in initializing arrays of arrays. * Fix mistake in conflict resolution on rm_turbo.c * Re-apply clang format to gtpc_ies.h
5 years ago
"EEA0",
"128-EEA1",
"128-EEA2"};
Clang-formated liblte_*
5 years ago
typedef enum {
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_EIA0 = 0,
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_128_EIA1,
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_128_EIA2,
First ZUC working test case
6 years ago
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_128_EIA3,
Clang-formated liblte_*
5 years ago
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_N_ITEMS,
} LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_ENUM;
static const char liblte_security_integrity_algorithm_id_text[LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_N_ITEMS][20] = {
Clang format UE, eNB and lib (#850) * Clang-formated UE, eNB and lib. * Fixed compiling errors from clang-format. * Fix linking issues introduced by clang-format * Fix poor formating in initializing arrays of arrays. * Fix mistake in conflict resolution on rm_turbo.c * Re-apply clang format to gtpc_ies.h
5 years ago
"EIA0",
"128-EIA1",
"128-EIA2"};
adding liblte sources
8 years ago
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_security_generate_k_nas(uint8* k_asme,
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_ENUM enc_alg_id,
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_ENUM int_alg_id,
uint8* k_nas_enc,
uint8* k_nas_int);
S1/X2 handover tested and working
7 years ago
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_generate_k_rrc
Description: Generate the RRC security keys KRRCenc and KRRCint.
Document Reference: 33.401 v10.0.0 Annex A.2
*********************************************************************/
// Defines
// Enums
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_security_generate_k_rrc(uint8* k_enb,
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_ENUM enc_alg_id,
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_ENUM int_alg_id,
uint8* k_rrc_enc,
uint8* k_rrc_int);
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_generate_k_up
Description: Generate the user plane security keys KUPenc and
KUPint.
Document Reference: 33.401 v10.0.0 Annex A.2
*********************************************************************/
// Defines
// Enums
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_security_generate_k_up(uint8* k_enb,
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_ENUM enc_alg_id,
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_ENUM int_alg_id,
uint8* k_up_enc,
uint8* k_up_int);
adding liblte sources
8 years ago
Added function for derive keys
4 years ago
LIBLTE_ERROR_ENUM liblte_security_generate_sk_gnb(uint8_t* k_enb, uint8_t* sk_gnb, uint16_t scg_counter);
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_128_eia2
Description: 128-bit integrity algorithm EIA2.
Document Reference: 33.401 v10.0.0 Annex B.2.3
33.102 v10.0.0 Section 6.5.4
RFC4493
*********************************************************************/
// Defines
Clang-formated liblte_*
5 years ago
#define LIBLTE_SECURITY_DIRECTION_UPLINK 0
adding liblte sources
8 years ago
#define LIBLTE_SECURITY_DIRECTION_DOWNLINK 1
// Enums
// Structs
// Functions
security: refactor code, fix race in eia1 * state funktion for eia1 (mitigate race condition) * Extra file for snow3g * just use mbedtls aes * ref specification * adding const keyword to security functions
5 years ago
LIBLTE_ERROR_ENUM liblte_security_128_eia1(const uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* msg,
created security cfg handling class for rrc ue and refactor bearer_list handling
5 years ago
uint32 msg_len,
uint8* mac);
security: refactor code, fix race in eia1 * state funktion for eia1 (mitigate race condition) * Extra file for snow3g * just use mbedtls aes * ref specification * adding const keyword to security functions
5 years ago
LIBLTE_ERROR_ENUM liblte_security_128_eia2(const uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* msg,
uint32 msg_len,
uint8* mac);
LIBLTE_ERROR_ENUM liblte_security_128_eia2(const uint8* key,
Clang format UE, eNB and lib (#850) * Clang-formated UE, eNB and lib. * Fixed compiling errors from clang-format. * Fix linking issues introduced by clang-format * Fix poor formating in initializing arrays of arrays. * Fix mistake in conflict resolution on rm_turbo.c * Re-apply clang format to gtpc_ies.h
5 years ago
uint32 count,
uint8 bearer,
uint8 direction,
LIBLTE_BIT_MSG_STRUCT* msg,
uint8* mac);
security: refactor code, fix race in eia1 * state funktion for eia1 (mitigate race condition) * Extra file for snow3g * just use mbedtls aes * ref specification * adding const keyword to security functions
5 years ago
LIBLTE_ERROR_ENUM liblte_security_128_eia3(const uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* msg,
uint32 msg_len,
uint8* mac);
adding liblte sources
8 years ago
NAS-plane encryption working (thanks to David Rupprecht)
7 years ago
/*********************************************************************
Name: liblte_security_encryption_eea1
Description: 128-bit encryption algorithm EEA1.
Document Reference: 33.401 v13.1.0 Annex B.1.2
35.215 v13.0.0 References
Specification of the 3GPP Confidentiality and
Integrity Algorithms UEA2 & UIA2 D1 v2.1
*********************************************************************/
Clang format UE, eNB and lib (#850) * Clang-formated UE, eNB and lib. * Fixed compiling errors from clang-format. * Fix linking issues introduced by clang-format * Fix poor formating in initializing arrays of arrays. * Fix mistake in conflict resolution on rm_turbo.c * Re-apply clang format to gtpc_ies.h
5 years ago
LIBLTE_ERROR_ENUM liblte_security_encryption_eea1(uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* msg,
uint32 msg_len,
uint8* out);
NAS-plane encryption working (thanks to David Rupprecht)
7 years ago
/*********************************************************************
Name: liblte_security_decryption_eea1
Description: 128-bit decryption algorithm EEA1.
Document Reference: 33.401 v13.1.0 Annex B.1.2
35.215 v13.0.0 References
Specification of the 3GPP Confidentiality and
Integrity Algorithms UEA2 & UIA2 D1 v2.1
*********************************************************************/
Clang format UE, eNB and lib (#850) * Clang-formated UE, eNB and lib. * Fixed compiling errors from clang-format. * Fix linking issues introduced by clang-format * Fix poor formating in initializing arrays of arrays. * Fix mistake in conflict resolution on rm_turbo.c * Re-apply clang format to gtpc_ies.h
5 years ago
LIBLTE_ERROR_ENUM liblte_security_decryption_eea1(uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* ct,
uint32 ct_len,
uint8* out);
NAS-plane encryption working (thanks to David Rupprecht)
7 years ago
/*********************************************************************
Name: liblte_security_encryption_eea2
Description: 128-bit encryption algorithm EEA2.
Document Reference: 33.401 v13.1.0 Annex B.1.3
*********************************************************************/
Clang format UE, eNB and lib (#850) * Clang-formated UE, eNB and lib. * Fixed compiling errors from clang-format. * Fix linking issues introduced by clang-format * Fix poor formating in initializing arrays of arrays. * Fix mistake in conflict resolution on rm_turbo.c * Re-apply clang format to gtpc_ies.h
5 years ago
LIBLTE_ERROR_ENUM liblte_security_encryption_eea2(uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* msg,
uint32 msg_len,
uint8* out);
NAS-plane encryption working (thanks to David Rupprecht)
7 years ago
/*********************************************************************
Name: liblte_security_decryption_eea2
Description: 128-bit decryption algorithm EEA2.
Document Reference: 33.401 v13.1.0 Annex B.1.3
*********************************************************************/
Clang format UE, eNB and lib (#850) * Clang-formated UE, eNB and lib. * Fixed compiling errors from clang-format. * Fix linking issues introduced by clang-format * Fix poor formating in initializing arrays of arrays. * Fix mistake in conflict resolution on rm_turbo.c * Re-apply clang format to gtpc_ies.h
5 years ago
LIBLTE_ERROR_ENUM liblte_security_decryption_eea2(uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* ct,
uint32 ct_len,
uint8* out);
LIBLTE_ERROR_ENUM liblte_security_encryption_eea3(uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* msg,
uint32 msg_len,
uint8* out);
LIBLTE_ERROR_ENUM liblte_security_decryption_eea3(uint8* key,
uint32 count,
uint8 bearer,
uint8 direction,
uint8* msg,
uint32 msg_len,
uint8* out);
Add decryption function and all tests for enc
6 years ago
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_milenage_f1
Description: Milenage security function F1. Computes network
authentication code MAC-A from key K, random
challenge RAND, sequence number SQN, and
authentication management field AMF.
Document Reference: 35.206 v10.0.0 Annex 3
*********************************************************************/
// Defines
// Enums
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_security_milenage_f1(uint8* k, uint8* op, uint8* rand, uint8* sqn, uint8* amf, uint8* mac_a);
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_milenage_f1_star
Description: Milenage security function F1*. Computes resynch
authentication code MAC-S from key K, random
challenge RAND, sequence number SQN, and
authentication management field AMF.
Document Reference: 35.206 v10.0.0 Annex 3
*********************************************************************/
// Defines
// Enums
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM
liblte_security_milenage_f1_star(uint8* k, uint8* op, uint8* rand, uint8* sqn, uint8* amf, uint8* mac_s);
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_milenage_f2345
Description: Milenage security functions F2, F3, F4, and F5.
Computes response RES, confidentiality key CK,
integrity key IK, and anonymity key AK from random
challenge RAND.
Document Reference: 35.206 v10.0.0 Annex 3
*********************************************************************/
// Defines
// Enums
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM
liblte_security_milenage_f2345(uint8* k, uint8* op, uint8* rand, uint8* res, uint8* ck, uint8* ik, uint8* ak);
adding liblte sources
8 years ago
/*********************************************************************
Name: liblte_security_milenage_f5_star
Description: Milenage security function F5*. Computes resynch
anonymity key AK from key K and random challenge
RAND.
Document Reference: 35.206 v10.0.0 Annex 3
*********************************************************************/
// Defines
// Enums
// Structs
// Functions
Clang-formated liblte_*
5 years ago
LIBLTE_ERROR_ENUM liblte_security_milenage_f5_star(uint8* k, uint8* op, uint8* rand, uint8* ak);
adding liblte sources
8 years ago
Added function for derive keys
4 years ago
LIBLTE_ERROR_ENUM liblte_security_generate_k_nr_rrc(uint8* k_gnb,
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_ENUM enc_alg_id,
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_ENUM int_alg_id,
uint8* k_rrc_enc,
uint8* k_rrc_int);
LIBLTE_ERROR_ENUM liblte_security_generate_k_nr_up(uint8* k_gnb,
LIBLTE_SECURITY_CIPHERING_ALGORITHM_ID_ENUM enc_alg_id,
LIBLTE_SECURITY_INTEGRITY_ALGORITHM_ID_ENUM int_alg_id,
uint8* k_up_enc,
uint8* k_up_int);
rename srsLTE to srsRAN
4 years ago
#endif // SRSRAN_LIBLTE_SECURITY_H