O primeiro nível de configuração(ões) que precisamos fazer para utilização do HTTP Server são os servidores que indicam qual(is) porta(s) receberão requisições HTTP. No TOTVS | Application Server podemos configurar mais de um servidor HTTP. Cada seção de server criada no arquivo de configuração deve ser informada na chave SERVERS, da seção HTTPSERVER.
Nesta seção podemos configurar as seguintes chaves:
Chave | Descrição | Valores | Padrão | Obrigatório |
---|---|---|---|---|
Port | Porta TCP utilizada para acesso ao servidor. | 80 | 80 | X |
Locations | Indica a seção que configura um site ou location no servidor. | N/A | X | |
HostName | Valor que será utilizado no header HTTP Server nas respostas do servidor. | X | ||
IpAddress | Indica um endereço IP que receberá as conexões do servidor HTTP. Caso não seja indicado, todas as intefaces de rede disponíveis serão utilizadas | |||
lingerTimeout | Tempo máximo em segundos para esperar a resposta de close do TCP/IP antes de abortar a conexão | 30 | ||
SslCertificate | Indica o caminho absoluto do certificado que será utilizado no servidor. A configuração do certificado implica que a comunicação neste servidor será segura utilizando o protocolo SSL. | Sem certificado | ||
SslCertificateKey | Nome do arquivo de chave do certificado | Vazio | ||
SslCertificatePass | Senha do certificado | Vazio | ||
SslMethod | Método de criptografia da comunicação | SSL/TLS | ||
ContentTypes | Define o nome da sessão que será responsável pelos content-types. | |||
Charset | Define o encode padrão que será utilizado pelo servidor, | UTF8 | X | |
MaxRequests | Número máximo de requisições por conexão, se for zero não há limite de requisições. Caso seja maior que zeros a conexão será encerrada após responder a quantidade de requisições informada. | 0 | ||
AllowMethods | Lista dos métodos HTTP permitidos para o servidor. Somente os métodos permitidos pelo servidor serão válidos nas locations e CORS. O padrão é ter todos os métodos que o servidor suporta. | Todos os métodos suportados | ||
InactiveTimeOut | Tempo em segundos que a conexão será mantida sem que o cliente efetue requisições. Se for zero não há limite de tempo para fechar a conexão. | 0 | ||
MimeType | MimeType padrão para as respostas do servidor. Se a aplicação REST não informar o MimeType, e se o valor for informado para o servidor, ele será utilizado. | |||
OptionsProcess | Como o servidor deve processar o método OPTIONS. Os valores devem ser entre 0 e 2, onde: 0 - Se houver um REST para responder ao método OPTIONS ele será acionado. Ele deve responder os métodos válidos. Se houver um erro de execução o cliente receberá uma mensagem de erro compatível. Se o serviço não existir o servidor responderá com os métodos informados nas chaves AllowMethods. 1 - O serviço REST deve responder os métodos válidos. Se não existir ou houver um erro de execução o cliente receberá uma mensagem de erro compatível. 2 - O servidor deve responder com os métodos informados nas chaves AllowMethods. | 0 |