TsgcTURNServer › Events

TsgcTURNServer Events

Events you can handle, grouped by purpose, followed by the full alphabetical list.

STUN lifecycle

Name	Description
OnSTUNRequestAuthorization	Raised when an authenticated request arrives; supply the password associated with the incoming Username/Realm.
OnSTUNRequestSuccess	Raised before the server sends a successful STUN/TURN response so the handler can inspect or veto the reply.
OnSTUNRequestError	Raised before the server sends a STUN/TURN error response; allows the handler to inspect or suppress the reply.
OnSTUNException	Raised when an unhandled exception is caught while parsing or responding to a STUN/TURN message.

Allocations

Name	Description
OnTURNCreateAllocation	Raised after a new Allocation has been successfully created for a client.
OnTURNDeleteAllocation	Raised after an Allocation has been removed, either by client refresh-to-zero or because its lifetime expired.
OnTURNBeforeAllocate	Raised before a new Allocation is created; inspect the relayed IP/port and set Reject to refuse the ALLOCATE request.

Relay

Name	Description
OnTURNBeforeRelayIndication	Raised before the server relays a Send-Indication payload to a peer; set Accept to False to drop the packet.
OnTURNBeforeRelayChannelData	Raised before the server relays a ChannelData payload to a peer; set Accept to False to drop the packet.
OnTURNChannelDataDiscarded	Raised when a ChannelData message is dropped because the channel number is invalid or has no permission.
OnTURNMessageDiscarded	Raised when a TURN message received by the server is discarded before any response is produced.

All Events (alphabetical)

Name	Description
OnSTUNException	Raised when an unhandled exception is caught while parsing or responding to a STUN/TURN message.
OnSTUNRequestAuthorization	Raised when an authenticated request arrives; supply the password associated with the incoming Username/Realm.
OnSTUNRequestError	Raised before the server sends a STUN/TURN error response; allows the handler to inspect or suppress the reply.
OnSTUNRequestSuccess	Raised before the server sends a successful STUN/TURN response so the handler can inspect or veto the reply.
OnTURNBeforeAllocate	Raised before a new Allocation is created; inspect the relayed IP/port and set Reject to refuse the ALLOCATE request.
OnTURNBeforeRelayChannelData	Raised before the server relays a ChannelData payload to a peer; set Accept to False to drop the packet.
OnTURNBeforeRelayIndication	Raised before the server relays a Send-Indication payload to a peer; set Accept to False to drop the packet.
OnTURNChannelDataDiscarded	Raised when a ChannelData message is dropped because the channel number is invalid or has no permission.
OnTURNCreateAllocation	Raised after a new Allocation has been successfully created for a client.
OnTURNDeleteAllocation	Raised after an Allocation has been removed, either by client refresh-to-zero or because its lifetime expired.
OnTURNMessageDiscarded	Raised when a TURN message received by the server is discarded before any response is produced.