TURN Server | Allocations

Todas as operações TURN giram em torno de alocações e todas as mensagens TURN estão associadas a uma Allocation. Uma alocação consiste em:

 

• O endereço de transporte retransmitido
• A 5-Tupla: Endereço IP do cliente, porta IP do cliente, endereço IP do servidor, porta do servidor e protocolo de transporte.
• As informações de autenticação.
• O tempo de expiração de cada endereço de transporte retransmitido.
• Uma lista de permissões para cada endereço de transporte retransmitido (relayed).
• Uma lista de bindings de canais para cada endereço de transporte retransmitido.

 

Quando um cliente TURN envia uma requisição Allocate, esta mensagem TURN é processada pelo servidor, que tenta criar um novo Relayed Transport Address. Por padrão, se houver alguma porta UDP disponível, ele criará um novo Relayed Address, mas você pode utilizar o evento OnTURNBeforeAllocate para rejeitar uma nova requisição de Allocation.

 

procedure OnTURNBeforeAllocate(Sender: TObject; const aSocket: TsgcSocketConnection; 
  const aIP: string; aPort: Word; var Reject: Boolean);
begin
  if not (your own rules) then
	Reject := false;
end;

Se o processo continuar, o servidor cria uma nova allocation e o evento OnTURNCreateAllocation é chamado. Este evento fornece informações sobre a Allocation através da classe TsgcTURNAllocationItem.

 

procedure OnTURNCreateAllocation(Sender: TObject; const aSocket: TsgcSocketConnection; 
  const Allocation: TsgcTURNAllocationItem);
begin
  DoLog('New Allocation: ' + Allocation.RelayIP + ':' + IntToStr(Allocation.RelayPort));
end;

 

Quando a Allocation expira ou é excluída ao receber uma Refresh Request do cliente com um lifetime de zero, o evento OnTURNDeleteAllocation é disparado.

 

procedure OnTURNDeleteAllocation(Sender: TObject; const aSocket: TsgcSocketConnection; 
  const Allocation: TsgcTURNAllocationItem);
begin
  DoLog('Allocation Deleted: ' + Allocation.RelayIP + ':' + IntToStr(Allocation.RelayPort));
end;