Histórico da Página
...
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[General]
MAXSTRINGSIZE=10
[HTTPV11]
Enable=1
Sockets=HTTPREST
[HTTPREST]
Port=8080
IPsBind=
URIs=HTTPURI
Security=1
[HTTPURI]
URL=/rest
PrepareIn=ALL
Instances=2,5,1,1
CORSEnable=1
AllowOrigin=*
[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=environment
[ONSTART]
jobs=HTTPJOB
RefreshRate=30
|
Obs: O exemplo abaixo contém valores obrigatórios referente ao REST com comentários.
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[General] MAXSTRINGSIZE=10 ;//MAXSTRINGSIZE: Essa chave é obrigatória com o valor mínimo de 10. [HTTPV11] Enable=1 Sockets=HTTPREST [HTTPREST] Port=8080 ;//Port: portaPorta que o REST irá utilizar para subir o serviço, pode ser alterada para qualquer outra porta. IPsBind= URIs=HTTPURI Security=1 ;//Security: O valor 1 é obrigatório. InactiveTimeout=60 ;// Tempo em segundos que a conexão será mantida sem que o cliente efetue requisições. MaxRequests=0 ;//Número máximo de requisições por conexão SSLCheckClientCert=0 ;//Indica se fará ou não a validação do certificado de cliente, encerrando a conexão caso não valide. [HTTPURI] ;//HTTPURI: mesmoMesmo valor da chave URIs, definido na linha 713. URL=/rest ;//URL: pathPath onde o rest irá subir, pode ser alterado. PrepareIn=ALL ;//PrepareIn: Chave que indica qual environment será preparado para o rest. ALL significa que deve ser preparado para atender todas as empresas. Caso você queira utilizar o REST com empresa 1 filial 01, por exemplo, inserir na chave 1,01. Instances=2,5,1,1 ;//Instances: Chave obrigatória, mais informações sobre configuração em http://tdn.totvs.com/display/tec/Instances . A configuração desta chave impacta diretamente no total de licenças consumidas pelo REST. CORSEnable=1 ;//CORSEnable: essaEssa chave é obrigatória e com o valor 1, caso contrário, o REST não aceitara as requisições dos apps. AllowOrigin=* ;//AllowOrigin: Essa chave limita os IP's que o REST do Protheus pode responder, deve conter o valor * (responder para qualquer ip) ou os ip's específicos onde a integração será realizada. [HTTPJOB] MAIN=HTTP_START ;//MAIN: Cria um JOB que inicializa o servidor HTTP na inicialização do serviço. ENVIRONMENT=environment ;//ENVIRONMENT: Diz em qual environment(ambiente) o JOB será configurado. [ONSTART] jobs=HTTPJOB // ;//Jobs: Indica que o HTTPJOB será iniciado quando o serviço for iniciado. RefreshRate=30 ;//RefreshRate: Indica qual a taxa de atualização para reiniciar o JOB em caso de falha |
Obs: O exemplo acima contém apenas os valores obrigatórios referente ao REST.
. |
Informações | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
A partir da lib 20230403 em ambientes com binário a partir do 20.3.1.3 é possível a configuração das tags InactiveTimeout, MaxRequests, SSLCertificateCA e SSLCheckClientCert nos Sockets Rest.
Maiores detalhes: HTTPSERVER - Servers |
Informações | ||
---|---|---|
| ||
Exclusivamente para o aplicativo Meu Coletor de Dados, é necessário incluir a chave MODULE na seção HTTPURI:
A configuração do REST do Meu Coletor de Dados não pode ser compartilhada com os demais aplicativos. |
Informações | ||
---|---|---|
| ||
Exclusivamente para o aplicativo Minha Produção, caso seja configurado o Acesso Direto (alternativa ao Mingle), é necessário incluir a chave MODULE na seção HTTPURI:
A configuração do REST do Meu Coletor de Dados não pode ser compartilhada com os demais aplicativos e a empresa/filial deve ser obrigatoriamente informada na cláusula PrepareIn. |
3.1 Configuração REST no Intera
Se você está na modalidade Intera de licenciamento, a configuração do REST terá uma pequena particularidade.
Estamos falando da chave "stateless" na sessão [URIHTML], que define a maneira em que as licenças serão consumidas: Na inicialização da thread ou por demanda.
Para habilitar o comportamento de consumo de licença por demanda, o conteúdo da chave deve ser "1". Caso a chave não exista ou contenha o valor zero, o consumo de licença na inicialização da thread será mantido.
Informações | ||
---|---|---|
| ||
[URIHTML] |
Saiba mais detalhes acessando este link.
Após configurado, você pode iniciar o executável do appserver do REST em modo console e verificar se ele subiu corretamente através da mensagem no console:
...
A chave AllowOrigin indica de quais ip's o REST pode responder. Quando o valor é * (asterisco), indica que o Protheus pode responder para qualquer ip.
Para utilização dos Apps, é possível limitar o acesso apenas para os ranges de ip's do Mingle (criar link para documentação do Mingle) listados abaixo:
- 34.66.1.67
- 34.66.27.255
- 34.121.152.77
- 34.122.88.30
- 146.148.50.219
- 104.155.181.56
- 34.28.132.209
- 35.225.171.255
- 34.69.186.150
- 138.219.88.0/24
- 189.125.78.128/25
- 187.94.48.0/20
- 189.89.32.0/20
- 181.41.160.0/19
Obs: Essa configuração também deve ser feita no firewall da rede do cliente.
5 - Validações:
Existem diferentes maneiras para verificar se o REST esta com a configuração correta.
...
Dicas sobre Configuração REST Protheus®