3GPP TS 29.511 Specification References
Abbreviation | Description |
---|---|
5G-EIR | 5G-Equipment Identity Register |
EIR | Equipment Identity Register |
PEI | Permanent Equipment Identifier |
N5G-eir is a Service-based interface , to Check the status of Equipment's identity, which is an optional network function
N5g-eir_EquipmentIdentityCheck Service
Service Description
The N5g-eir_Equipment Identity Check service is provided by the 5G-EIR to check the Permanent Equipment Identifier (PEI) whether it is in the black list or not. The service can be consumed by AMF which initiates ME identity check by invoking the N5g-eirEquipmentIdentityCheckGet service operation.
The NF Service Consumer (e.g. AMF) sends a GET request to the resource representing the PEI equipment Status. It shall include the PEI as a query parameter and, optionally, the SUPI may also be included.
On success, "200 OK" with the message body containing the equipment status of the PEI.
If the PEI is not known, "404 Not Found" with the message body containing a ProblemDetails object, with the "details" attribute set to "ERROR_EQUIPMENT_UNKNOWN".
When receiving the response from the 5G-EIR, the NF Service Consumer (e.g. AMF) shall check the equipment Status and the detailed problem. Dependent upon the result, the NF Service Consume will decide its subsequent actions (e.g. sending a Registration Reject if the 5G-EIR indicates that the PEI is unknown or blacklisted).
Name | Data Type | P | Cardinality | Description |
---|---|---|---|---|
pei | Pei | M | 1 | The PEI of the UE shall be included for equipment identify checking |
supi | Supi | O | 0..1 | The SUPI of the UE |
Data Type | P | Cardinality | Response Code | Description |
---|---|---|---|---|
EirResponseData | M | 1 | 200 (OK) | Upon success, a response body containing the Equipment Status shall be returned |
ProblemDetails | M | 1 | 404 (404 Not Found) | The equipment identify checking has failed. The "cause" attribute shall be set to the following application error: - ERROR_EQUIPMENT_UNKNOWN |
Attribute Name | Data Type | P | Cardinality | Description |
---|---|---|---|---|
status | EquipmentStatus | M | 1 | Status of the UE |
Enumeration Value | Description |
---|---|
"WHITELISTED" | Indicates the PEI is whitelisted |
"BLACKLISTED" | Indicates the PEI is blacklisted |
"GREYLISTED" | Indicates the PEI is greylisted |
The common application errors defined in the Table 5.2.7.2-1 in 3GPP TS 29.500 [4] may also be used for the N5g-eir_EquipmentIdentityCheck service, and the following application errors listed in the below Table are specific for the N5g-eir_EquipmentIdentityCheck service.
Application Error | HTTP status code | Description |
---|---|---|
ERROR_EQUIPMENT_UNKNOWN | 404 | Indicate the mobile equipment is not known in the EIR. |
typedef struct __si_fg_simple_Pei
{
unsigned char value[255];
int len;
unsigned char * Pattern;
uint8_t isset;
uint8_t isNullable;
} SI_FG_SIMPLE_Pei;
typedef struct __si_fg_simple_Supi
{
unsigned char value[255];
int len;
unsigned char * Pattern;
uint8_t isset;
uint8_t isNullable;
} SI_FG_SIMPLE_Supi;
typedef struct __si_fg_simple_Uri
{
unsigned char value[255];
int len;
unsigned char * Pattern;
uint8_t isset;
uint8_t isNullable;
} SI_FG_SIMPLE_Uri;
typedef struct __si_fg_simple_String
{
unsigned char value[255];
int len;
unsigned char * Pattern;
uint8_t isset;
uint8_t isNullable;
} SI_FG_SIMPLE_String;
typedef struct __si_fg_simple_Int32
{
uint8_t isset;
uint64_t value;
uint8_t isNullable;
} SI_FG_SIMPLE_Int32;
typedef struct __si_fg_data_InvalidParam
{
SI_FG_SIMPLE_String param;
SI_FG_SIMPLE_String reason;
} SI_FG_DATA_InvalidParam;
typedef struct __si_fg_data_InvalidParam_Array
{
SI_FG_DATA_InvalidParam Items[10];
int Count;
} SI_FG_DATA_InvalidParam_Array;
typedef struct __si_fg_enum_EquipmentStatus
{
unsigned char value[75];
int len;
uint8_t isset;
} SI_FG_ENUM_EquipmentStatus;
typedef struct __si_fg_data_EirResponseData
{
SI_FG_ENUM_EquipmentStatus status;
} SI_FG_DATA_EirResponseData;
typedef struct __si_fg_data_ProblemDetails
{
SI_FG_SIMPLE_Uri type;
SI_FG_SIMPLE_String title;
SI_FG_SIMPLE_Int32 status;
SI_FG_SIMPLE_String detail;
SI_FG_SIMPLE_Uri instance;
SI_FG_SIMPLE_String cause;
SI_FG_DATA_InvalidParam_Array invalidParams;
} SI_FG_DATA_ProblemDetails;
void __si_fg_send_Neir_GetEquipmentStatus_GETRequest( SI_FG_HttpContext * httpContext, SI_FG_Neir_GetEquipmentStatusRequest * request);
void __si_fg_send_Neir_GetEquipmentStatusResponse_EirResponseData( SI_FG_HttpContext * httpContext, SI_FG_DATA_EirResponseData * eirResponseData);
void __si_fg_send_Neir_GetEquipmentStatusResponse_ProblemDetails( SI_FG_HttpContext * httpContext, SI_FG_DATA_ProblemDetails * problemDetails);
5G UE Reachability Request Parameter for AMF
posted on 2019-04-08 07:35:04 - 5G Tutorial Tutorials