Manual de instalação e configuração RMS | API Manager

01. DADOS GERAIS:

02. PRÉ-REQUISITOS:

*Sugerimos que após realizar todas as instalações acima, reinicie o servidor.

03. INSTALAÇÃO - Implantação das APIs:

Conforme listado nos pré-requisitos é necessário que a estrutura de diretórios esteja devidamente estruturada na pasta "...\inetpub\wwwroot";

Será necessário liberar permissão total do diretório "wwwroot" para os os usuários IIS (IIS_IUSRS); Esse processo é necessário para que os projetos possam manipular arquivos.

1. Localize a pasta RMS (pacote baixado na central de downloads) ;
2. Copie a pasta RMSServices para o diretório RMS, dentro da estrutura do IIS.
3. 
   1. Caso, já exista esta pasta, basta copiar apenas o conteúdo, para seu diretório RMSServices.
4. Copie a API: APiZEUS para o diretório: RMSServices;
   1. Conteúdo baixado na central de downloads;
5. 
6. Acesse a pasta que foi copiada;
7. Encontre o arquivo "appsettings.json";
8. 
9. Abra-o com o editor de texto de sua preferencia;
10. Edite o valor da propriedade "PathFileConfig" para a pasta "_data" localizada dentro do diretório raiz do RMSServices;
11.  
    1. O diretório "..\RMSServices\_data" será responsável por armazenar todos os arquivos de configurações e arquivos criptografados referentes a todas as nossas APis;
12. Abra o IIS;
13. Crie um pool de aplicação para a API.
    1. 
    2. Clique em OK;
    3. Selecione o pool criado, clique com o botão direito do mouse e clique em "Advanced Settings" (Opções avançadas);
    4. Em "Identity" altere a opção para "LocalSystem";
    5. 
       1. Este passo é necessário para que a API consiga manipular arquivos com permissões do sistema operacional.
14. Localize na arvore da esquerda, o diretório RMS>RMSServices;
    1. Identifique a pasta APiZEUS;
15. Converta-o para aplicação vinculando o pool de aplicação criado no passo 13;
    1. Clique com o botão direito em "APiZEUS" em seguida Clique em "Convert to Application" (Converter para aplicação);
16. Para testar, selecione e clique com o botão direito do mouse em "APiZEUS" > Manage Application > Browse;
    1. Quando o navegador abrir, adicione uma "barra"( / ) no final da url.
       1. Feito para acessar a documentação da API.
17. O resultado esperado é esta tela:
    1. 
18. Com isso finalizamos a implantação e configuração da API.

04. INSTALAÇÃO - Implantação Aplicação Web:

1. Dentro da pasta recebida para implantação identifique o seguinte diretório: RMS > Aplicações;
2. Mova a pasta Aplicações para dentro do diretório do IIS;
   1. Caso já tenha o diretório criado na estrutura do IIS ("...\inetpub\wwwroot\RMS\Aplicacoes"), basta apenas copiar a pasta(API-Manager);
3. Volte até o IIS;
4. Dentro da árvore à esquerda, identifique o diretório que acabamos de criar;
   1. Caso não apareça, atualize a árvore. (F5 ou clique com o botão direito > Refresh);
5. Da mesma forma como convertemos para aplicação as pastas do RMSServices, vamos repetir o processo para a aplicação web;
6. Selecione a pasta RMS > Aplicacoes > API-Manager;
   1. Pode ser vinculado ao pool de aplicação criado para API.
7. Clique com o botão direito do mouse > "Convert to Application";  
8. Selecione o pool de aplicação que foi criado anteriormente;
9. Clique em "OK" para finalizar a conversão.
10. Pronto, finalizamos a conversão;
11. Para acessar a aplicação, selecione o RMS > Aplicacoes > API-Manager;
    1. Clique com o botão direito do mouse > Manage Application > Browse;
12. Como resultado, o navegador exibirá a nossa aplicação web:
    1. 
13. Com isso finalizamos a implantação de nossa aplicação web.

05. Encryptor- Criptografando informações para acesso ao banco de dados(Oracle):

1. Para realizar a criptografia das informações de acesso ao banco clique em "Encryptor"
   1. 
2. Um modal irá abrir para informar os dados de acesso:
   1. 
3. Após informar todos os dados descritos acima, clique em "Criptografar".
4. Será criado um arquivo dentro do diretório ".\RMSServices\_data".
   1. Arquivo chamado: dbConnInfo.tcrpt.
      1. Este arquivo contém as informações de banco de dados criptografadas.
      2. Todas as novas versões das APIs fará a leitura das informações de acesso ao banco neste arquivo, com isso não será mais necessário fazer a configuração individualmente em cada API/Web Service.
      3. Nas configurações das APIs e Web Services será necessário informar o diretório da pasta "_data", isso estará nas documentações de cada projeto.
5. Para verificar o status da conexão com o banco de dados, basta clicar em "Conexão BD";
   1. 
6. 
7. Com isso finalizamos a configuração do arquivo de criptografia.