Histórico da Página
Configurações no arquivo totvsappserver.ini
É necessário definir algumas seções no arquivo de configuração do TotvsAppserver e ajustar, quando necessário, os valores para o nome do ambiente (Chave ENVIRONMENT), porta (Chave PORT), quantidade de instâncias para execução no AppServer (Chave INSTANCES) e Chave URL para indicar o endereço em que as requisições REST serão atendidas.
Sem Formato |
---|
[ONSTART]
REFRESHRATE=30
JOBS=HTTPJOB
[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=logix12_ora ;*** NOME DO AMBIENTE LOGIX, pode ser modificado
[HTTPV11]
ENABLE=1
SOCKETS=HTTPREST
TIMEOUT=600
[HTTPREST]
PORT=8580 ;*** Porta utilizada na URI, pode ser modificada
URIS=URITESTE
SECURITY=0
[URITESTE]
URL=/ ;*** Endereço base pra atender as requisições REST. Exemplo: http://localhost:8580/api/vdp/v1/clientes
INSTANCES=2,2 ;*** Número de instâncias utilizadas para atender as requisições REST (quantidade inicial e máxima de instâncias)
ONSTART=LOGIXRESTSTART
ONCONNECT=LOGIXRESTCONNECT
ONEXIT=LOGIXRESTEXIT |
Com base na configuração acima, as requisições REST serão atendidas a partir da seguinte URL base: http://localhost:8580/rest
Ativando autenticação REST
Para ativar o controle de autenticação nas requisições REST é necessário alguns procedimentos que estão descritos a seguir:
Ative a chave SECURITY na seção HTTPREST:
Sem Formato |
---|
[HTTPREST]
PORT=8580 ;*** Porta utilizada na URI, pode ser modificada
URIS=URITESTE
SECURITY=1 ;*** Ativar a autenticação das requisições REST
|
Ativando a chave SECURITY=1 precisará configurar também as seguintes chaves CERTIFICATE, KEY e PASSPHRASE na seção [HTTPREST], com os dado do certificado SSL.
A partir da ativação da autenticação das requisições REST, na seção HEADER das requisições deverá constar o campo AUTHORIZATION
contendo as informações de usuário e senha no formato BASE64.
Para exemplo e mais informações a respeito de autenticação nas requisições REST, acesse 07. Autenticação HTTP Basic (necessário solicitar permissão para equipe TotvsTec).