Histórico da Página

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:

...

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

...