Pré-condições de Instalação
- Possuir o Internet Information Services (IIS) instalado na máquina;
- Possuir o Microsoft .NET Framework 4.6 instalado na máquina;
- Possuir o AspNET 4.5 instalado na máquina.
Instruções de Instalação
- Copiar o pacote da versão para [DRIVE]:\LINX-SAFE-API-REST e descompactar;
- Abrir o Gerenciador do IIS;
- Clicar em Sites;
- Clicar com o botão direito em Default Web Site e clicar na opção Adicionar Aplicativo;(Caso aplicativo já não esteja adicionado);
- Informar o alias: safeapi; e o caminho físico: [DRIVE]:\ LINX-SAFE-API-REST. (Caso aplicativo já não esteja adicionado);
- Clicar em OK.
Configurar Autenticação
A funcionalidade de autenticação do WS SAFE Rest foi implementada para melhorar a segurança da comunicação. Ao ativá-la toda e qualquer comunicação direcionada ao WS SAFE Rest deverá ocorrer acrescida de usuário e senha, ambos cadastrados na rede/domínio.
Para que o WS SAFE Rest utilize autenticação, as seguintes configurações devem ser realizadas:
- Editar o arquivo Web.config (em \\ LINX-SAFE-API-REST) e alterar as seguintes tags:
No bloco “authorization”, a tag “allow users” define qual ou quais usuários podem se autenticar.
Ex:
<authorization>
<allow users="empresa_dom\user1,empresa_dom\user2”/>
<deny users="*"/>
</authorization>A configuração acima habilitar apenas os usuários user1 e user2 a se autenticarem no WS. Demais usuários terão acesso negado (<deny users="*"/>)
- Configurar o IIS para solicitar Autenticação
- Navegar na árvore até o diretório WS-SAFE (conforme imagem abaixo);
![](/download/attachments/34145691/image2018-1-22_16-39-48.png?version=1&modificationDate=1516650215788&api=v2)
- No painel do lado, clicar duas vezes no ícone Autenticação;
- Clicar em Autenticação Anônima o no painel de ações (do lado direito) clicar em Desabilitar;
![](/download/attachments/34145691/image2018-1-22_16-40-34.png?version=1&modificationDate=1516650215799&api=v2)
- Clicar em Autenticação Básica o no painel de ações (do lado direito) clicar em Habilitar.
![](/download/attachments/34145691/image2018-1-22_16-41-13.png?version=1&modificationDate=1516650215811&api=v2)
Ao final, as configurações de Autenticação do IIS deverão estão de acordo com a imagem abaixo:
![](/download/attachments/34145691/image2018-1-22_16-41-59.png?version=1&modificationDate=1516650215822&api=v2)