Histórico da Página
No LOGIX, existem configurações a serem definidas no arquivo de configuração do TotvsAppserver (Arquivo Totvsappserver.ini
) para executar e desenvolver métodos utilizando a arquitetura REST na tecnologia TotvsTec.
A seguir será apresentado um exemplo de configuração do TotvsAppserver e algumas referências para outras documentações também disponíveis a respeito do mesmo assunto.
Para mais detalhes a respeito de conceitos, configurações e testes utilizando arquitetura REST com TotvsTec clique AQUI.
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 |
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