Histórico da Página
Índice |
---|
1 - Visão Geral
Para utilização dos Apps é necessário que o REST do Protheus esteja habilitado e configurado corretamente, com a autenticação habilitada. Nas seções abaixo temos alguns exemplos de configuração e validação.
2 - Configuração do REST
Para fazer a configuração do Rest é recomendado que seja criada uma cópia do appserver do Protheus para que ele rode em instâncias separadas conforme no exemplo abaixo:
...
Informações | ||
---|---|---|
| ||
Caso você utiliza mais de um tipo de webservice, para correto funcionamento das integrações, o appserver REST e SOAP não devem rodar na mesma instância do serviço, nem estar expostos na mesma porta. |
3 - Configuração do appserver.ini:
O arquivo appserver.ini deve conter as chaves abaixo:
...
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:
4 - Problemas mais comuns:
A falta de quaisquer uma das chaves no exemplo acima faz com que o REST não funcione como esperado. Abaixo listamos algumas:
...
- 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.
5.1 Acesso pelo navegador
A primeira e mais fácil de fazer, é acessa-lo pelo navegador, verificando esse acesso é possível saber se o REST esta de pé. Caso não seja possível acessa-lo, os aplicativos não irão funcionar.
Como testar:
5.1.1 - Ambiente local
Caso esteja fazendo o teste em ambiente local, siga os passos abaixo:
...
Acessar o endereço pelo navegador.
5.1.2 - Ambiente do cliente
Caso o teste seja feito em um ambiente do cliente, será necessário orienta-lo a seguir os passos acima.
...
Em ambos os casos, deverá ser aberta uma página semelhante a abaixo:
5 - Documentações auxiliares:
Abaixo algumas documentações que podem auxiliar em caso de dúvidas/problemas:
Framework: Configuração do REST (Geral)
02. REST com ERP Microsiga Protheus
Exemplo de configuração do REST
...