Servers
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 | ||
| SSLCertificateCA | Indica o caminho absoluto do certificado de CA do certificado apontado pela chave SSLCertificate. | Vazio | ||
| SSLCertificateKey | Indica o caminho absoluto do arquivo de chave do certificado apontado pela chave SSLCertificate. | Vazio | ||
| SSLCertificatePass | Senha do certificado apontado pela chave SSLCertificate. | Vazio | ||
| SSLMethod | Método de criptografia da comunicação |
| SSL/TLS | |
| SSLDisableCipher | Indica quais cifras ou conjunto de cifras devem ser desabilitadas. | Vazio | ||
| SSLCheckClientCert | Indica se fará ou não a validação do certificado de cliente, encerrando a conexão caso não valide. |
| 0 | |
| 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 |
Observações
As chaves SSLCheckClientCert e SSLCertificateCA estão disponíveis a partir da versão 20.3.1.3 do TOTVS | Application Server.
A chave SSLDisableCipher é preenchida com os mesmos valores da chave DisableCipher da seção SSLConfigure. Caso a chave não seja preenchida, será utilizado o que for configurado na chave DisableCipher da seção SSLConfigure.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas