Página Web/Ressource REST

4D v19

Esta página contém as opções que se utilizam para ativar e controlar os acessos REST ao banco de dados 4D.

REST permite que as aplicações externas acessem diretamente aos dados de seu banco de dados, por exemplo através da funcionalidade Open datastore.

Nota:

em 4D Server, a abertura de uma sessão REST exige que esteja disponível uma licença 4D client.
em 4D monoposto, pode abrir até três sessões REST com fins de teste.

Ativar os serviços 4D Mobile

Por razões de segurança, por padrão, 4D não responde as petições REST. Se deseja utilizar esta funcionalidade, se deve selecionar a opção Ativar os serviços 4D Mobile para que as solicitações de REST sejam processadas

Nota: os serviços REST utilizam o servidor HTTP de 4D, pelo que necessita garantir de que o servidor Web de 4D tenha sido iniciado.

A mensagem de advertência "Precaução, verifique os direitos de acesso" é mostrado quando se marca esta opção para chamar sua atenção sobre o fato de que quando os serviços REST se ativam, por padrão o acesso aos objetos da base é livre, enquanto que os acessos REST não tenham sido configurados.

Acesso Leitura/Escritura

Esta opção especifica o grupo de usuários 4D que estão autorizados a estabelecer a conexão ao banco de dados 4D usando petições REST.

Por padrão, o menu mostra <Qualquer>, o que significa que os acessos REST estão abertos a todos os usuários.
Uma vez que tenha especificado um grupo, só uma conta de usuário 4D que pertence a este grupo se pode utilizar para acessar a 4D por meio de uma solicitação REST, em particular, para abrir uma sessão usando o comando Open datastore. Se utilizar uma conta que não pertence a este grupo, 4D devolve um erro de autenticação ao remetente da solicitação.

Lembre que para que esta configuração ter efeito, o comando On 4D Mobile Authentication database method não deve ser definido. Se existir, 4D ignora configurações de acesso definidas nas Database Settings,

Atenção: dado que qualquer petição REST exige uma sessão e, portanto, uma licença válida, se recomenda filtrar as petições atribuindo um grupo de usuários 4D para o acesso REST ou utilizando On 4D Mobile Authentication database method. Do contrário, o servidor criará uma sessão para cada solicitação REST entrante (inclusive $info) e tomará uma licença. Quando uma solicitação REST entrante se vincula a uma sessão de usuário existente (criada através de uma autenticação prévia), 4D reutilizará a mesma sessão.