TsgcHTTPServer › Propriedades

TsgcHTTPServer Propriedades

Propriedades published agrupadas por finalidade, seguidas pela lista alfabética completa.

Conexão

NameDescrição
ActiveInicia ou para o servidor HTTP, abrindo os sockets de escuta nos bindings configurados.
PortPorta TCP na qual o servidor aceita conexões HTTP de entrada.
BindingsColeção de pares IP/Porta nos quais o servidor escuta; utilize-a para vincular vários endpoints simultaneamente.
MaxConnectionsNúmero máximo de conexões de cliente simultâneas aceitas pelo servidor.
KeepAliveMantém a conexão HTTP aberta após uma resposta ter sido enviada, de modo que requisições subsequentes possam reutilizá-la.

HTTP

NameDescrição
CharsetCharset aplicado às respostas de texto entregues a partir de DocumentRoot.
DocumentRootDiretório servido pelo servidor HTTP para arquivos estáticos (HTML, JavaScript, CSS, imagens, etc.).
HTTP2OptionsHabilita e ajusta o handler do protocolo HTTP/2 utilizado para servir requisições HTTPS.
HTTP3OptionsHabilita o listener HTTP/3 (QUIC) que serve requisições HTTP juntamente com HTTP/1.1 e HTTP/2, por UDP.
HTTPCompressionComprime as respostas HTTP/1.1 com gzip ou deflate quando o cliente anuncia suporte.
HTTPUploadFilesControla como os arquivos enviados por HTTP POST são armazenados em buffer (memória ou fluxo de arquivo) e salvos em disco.
ParseParamsAnalisa a query string e o corpo form-urlencoded de cada requisição em ARequestInfo.Params.

Sessions

NameDescrição
AutoStartSessionCria uma nova sessão HTTP automaticamente para cada requisição recebida quando o estado de sessão está habilitado.
SessionClassClasse usada pelo servidor para criar novas sessões HTTP; defina-a com o seu próprio descendente de TIdHTTPSession.
SessionListLista que contém as sessões HTTP ativas; leia-a para gerenciar as sessões por código, ou atribua a sua própria lista.
SessionStateHabilita o rastreamento de sessão HTTP baseado em cookie sobre o protocolo HTTP stateless.
SessionTimeOutTimeout de inatividade, em milissegundos, após o qual uma sessão HTTP é considerada expirada e elegível para remoção.

Security

NameDescrição
AuthenticationHabilita e configura a autenticação de usuário/senha para conexões HTTP de entrada.
SSLHabilita TLS/SSL no servidor para que os clientes possam conectar usando https://.
SSLOptionsMantém os caminhos de certificado, a seleção de versão TLS e o ajuste OpenSSL para o listener TLS.
SecurityOptionsRegras de admissão do handshake herdadas do mecanismo de servidor compartilhado; não aplicável a este componente (veja Observações).
MaxRequestBodySizeTamanho máximo em bytes do corpo de uma requisição HTTP recebida; protege o servidor contra ataques de esgotamento de memória.
StrictRequestParsingRejeita requisições HTTP ambíguas usadas em ataques de request-smuggling e aplica uma validação mais rígida da codificação chunked.
APIKeyManagerComponente gerenciador de chaves de API opcional utilizado para validar chaves de API de entrada antes de aceitar uma conexão.

Confiabilidade

NameDescrição
WatchDogReinicia automaticamente o servidor após um desligamento inesperado ou falha do listener.
FallBackHerdado do mecanismo de servidor compartilhado; não aplicável a este componente (veja Observações).
RateLimiterAtribui um componente de rate-limiter que limita as taxas de requisição por cliente ou por IP.
FirewallAtribui um componente de firewall que filtra conexões recebidas por IP, região ou regras personalizadas.

Avançado

NameDescrição
OptionsAgrupa flags diversas de comportamento do servidor: timeouts, páginas de teste HTTP integradas e o cabeçalho HTTP Server.
IOHandlerOptionsSeleciona a estratégia de I/O utilizada para atender às conexões: thread-per-connection, IOCP ou EPOLL.
ThreadPoolHabilita um pool de threads que recicla os threads de trabalho em vez de destruí-los quando as conexões são fechadas.
ThreadPoolOptionsConfigura o tamanho e o limite superior do pool de threads reutilizável utilizado quando ThreadPool está habilitado.
ThrottleLimita a largura de banda (bits por segundo) que o servidor lê de ou grava em cada conexão.

Diagnósticos

NameDescrição
LogFileGrava cada requisição/resposta HTTP de entrada e de saída em um arquivo de log para depuração e auditoria.
NotifyEventsControla como os eventos do servidor em threads são sincronizados com o thread VCL principal.
VersionString somente leitura com a versão da biblioteca sgcWebSockets embutida no binário.

Todas as Propriedades (alfabética)

NameDescrição
ActiveInicia ou para o servidor HTTP, abrindo os sockets de escuta nos bindings configurados.
APIKeyManagerComponente gerenciador de chaves de API opcional utilizado para validar chaves de API de entrada antes de aceitar uma conexão.
AuthenticationHabilita e configura a autenticação de usuário/senha para conexões HTTP de entrada.
AutoStartSessionCria uma nova sessão HTTP automaticamente para cada requisição recebida quando o estado de sessão está habilitado.
BindingsColeção de pares IP/Porta nos quais o servidor escuta; utilize-a para vincular vários endpoints simultaneamente.
CharsetCharset aplicado às respostas de texto entregues a partir de DocumentRoot.
DocumentRootDiretório servido pelo servidor HTTP para arquivos estáticos (HTML, JavaScript, CSS, imagens, etc.).
FallBackHerdado do mecanismo de servidor compartilhado; não aplicável a este componente (veja Observações).
FirewallAtribui um componente de firewall que filtra conexões recebidas por IP, região ou regras personalizadas.
HTTP2OptionsHabilita e ajusta o handler do protocolo HTTP/2 utilizado para servir requisições HTTPS.
HTTP3OptionsHabilita o listener HTTP/3 (QUIC) que serve requisições HTTP juntamente com HTTP/1.1 e HTTP/2, por UDP.
HTTPCompressionComprime as respostas HTTP/1.1 com gzip ou deflate quando o cliente anuncia suporte.
HTTPUploadFilesControla como os arquivos enviados por HTTP POST são armazenados em buffer (memória ou fluxo de arquivo) e salvos em disco.
IOHandlerOptionsSeleciona a estratégia de I/O utilizada para atender às conexões: thread-per-connection, IOCP ou EPOLL.
KeepAliveMantém a conexão HTTP aberta após uma resposta ter sido enviada, de modo que requisições subsequentes possam reutilizá-la.
LogFileGrava cada requisição/resposta HTTP de entrada e de saída em um arquivo de log para depuração e auditoria.
MaxConnectionsNúmero máximo de conexões de cliente simultâneas aceitas pelo servidor.
MaxRequestBodySizeTamanho máximo em bytes do corpo de uma requisição HTTP recebida; protege o servidor contra ataques de esgotamento de memória.
NotifyEventsControla como os eventos do servidor em threads são sincronizados com o thread VCL principal.
OptionsAgrupa flags diversas de comportamento do servidor: timeouts, páginas de teste HTTP integradas e o cabeçalho HTTP Server.
ParseParamsAnalisa a query string e o corpo form-urlencoded de cada requisição em ARequestInfo.Params.
PortPorta TCP na qual o servidor aceita conexões HTTP de entrada.
RateLimiterAtribui um componente de rate-limiter que limita as taxas de requisição por cliente ou por IP.
SecurityOptionsRegras de admissão do handshake herdadas do mecanismo de servidor compartilhado; não aplicável a este componente (veja Observações).
SessionClassClasse usada pelo servidor para criar novas sessões HTTP; defina-a com o seu próprio descendente de TIdHTTPSession.
SessionListLista que contém as sessões HTTP ativas; leia-a para gerenciar as sessões por código, ou atribua a sua própria lista.
SessionStateHabilita o rastreamento de sessão HTTP baseado em cookie sobre o protocolo HTTP stateless.
SessionTimeOutTimeout de inatividade, em milissegundos, após o qual uma sessão HTTP é considerada expirada e elegível para remoção.
SSLHabilita TLS/SSL no servidor para que os clientes possam conectar usando https://.
SSLOptionsMantém os caminhos de certificado, a seleção de versão TLS e o ajuste OpenSSL para o listener TLS.
StrictRequestParsingRejeita requisições HTTP ambíguas usadas em ataques de request-smuggling e aplica uma validação mais rígida da codificação chunked.
ThreadPoolHabilita um pool de threads que recicla os threads de trabalho em vez de destruí-los quando as conexões são fechadas.
ThreadPoolOptionsConfigura o tamanho e o limite superior do pool de threads reutilizável utilizado quando ThreadPool está habilitado.
ThrottleLimita a largura de banda (bits por segundo) que o servidor lê de ou grava em cada conexão.
VersionString somente leitura com a versão da biblioteca sgcWebSockets embutida no binário.
WatchDogReinicia automaticamente o servidor após um desligamento inesperado ou falha do listener.