Asterisk - The Open Source Telephony Project  18.5.0
Data Fields
ast_security_event_common Struct Reference

Common structure elements. More...

#include <security_events_defs.h>

Collaboration diagram for ast_security_event_common:
Collaboration graph
[legend]

Data Fields

const char * account_id
 Account ID, specific to the service type. More...
 
enum ast_security_event_type event_type
 The security event sub-type. More...
 
struct ast_security_event_ip_addr local_addr
 Local address the request came in on. More...
 
const char * module
 Module, Normally the AST_MODULE define. More...
 
struct ast_security_event_ip_addr remote_addr
 Remote address the request came from. More...
 
const char * service
 Service that generated the event. More...
 
const char * session_id
 Session ID, specific to the service type. More...
 
const struct timeval * session_tv
 Session timeval, when the session started. More...
 
uint32_t version
 security event version More...
 

Detailed Description

Common structure elements.

This is the structure header for all event descriptor structures defined below. The contents of this structure are very important and must not change. Even though these structures are exposed via a public API, we have a version field that can be used to ensure ABI safety. If the event descriptors need to be changed or updated in the future, we can safely do so and can detect ABI changes at runtime.

Definition at line 156 of file security_events_defs.h.

Field Documentation

◆ account_id

const char* account_id

Account ID, specific to the service type.

Note
optional/required, depending on event type

Definition at line 177 of file security_events_defs.h.

◆ event_type

enum ast_security_event_type event_type

◆ local_addr

struct ast_security_event_ip_addr local_addr

Local address the request came in on.

Note
Always required

Definition at line 192 of file security_events_defs.h.

◆ module

const char* module

Module, Normally the AST_MODULE define.

Note
Always optional

Definition at line 172 of file security_events_defs.h.

◆ remote_addr

struct ast_security_event_ip_addr remote_addr

Remote address the request came from.

Note
Always required

Definition at line 197 of file security_events_defs.h.

◆ service

const char* service

Service that generated the event.

Note
Always required

Examples: "SIP", "AMI"

Definition at line 167 of file security_events_defs.h.

Referenced by alloc_security_event_json_object().

◆ session_id

const char* session_id

Session ID, specific to the service type.

Note
Always required

Definition at line 182 of file security_events_defs.h.

◆ session_tv

const struct timeval* session_tv

Session timeval, when the session started.

Note
Always optional

Definition at line 187 of file security_events_defs.h.

◆ version

uint32_t version

security event version

Definition at line 160 of file security_events_defs.h.

Referenced by alloc_security_event_json_object(), ast_security_event_report(), and ParsingContext::next().


The documentation for this struct was generated from the following file: