Manual de cadastro de clientes para acesso a API

CONTEÚDO

1. Visão Geral
2. Requisitos
3. Exemplo de utilização
4. Tela Novo Cliente
   1. Outras Ações / Ações relacionadas
      
5. Demonstração

01. VISÃO GERAL

Passo-a-passo para cadastro de clientes para ter acesso às APIs de integração do RMS.

02.  REQUISITOS

       Instalar o API Manager utilizando este link.

       Baixar o pacote da aplicação API-Manager e das APIs Auth7 e APIZeus.

       Os mesmo do projeto RMSMenu Web, contudo requer a versão do .NET Core 3.1 ou superior. 

       Observação: no caso de ambiente 64bits, devem ser instaladas as versões x64, x86.

       Observação: O hosting bundle também dever ser instalado independente da versão do Windows.

       Observação: O item WebDavModule deve ser removido do item abaixo

03. INSTALAÇÃO DA SOLUÇÃO

       Devem ser instalados os pré-requisitos listados acima e seguir com os passos abaixo. Alguns dos passos abaixo já podem ter sido executados com a instalação do API-Manager.

1. Criar os pools de aplicação no IIS conforme abaixo.
   1. 
2. Entrar nas configurações avançadas de cada um dos três pools listados acima.
   1. 
3. Alterar os campos de compatibilidade para 32bits para "True" e a identidade para "LocalSystem".
   1. 
4. Copiar o conteúdo das APIs Auth7 e APIZeus para a pasta C:\inetpub\wwwroot\RMS\RMSServices
   1. 
   2. 
5. Copiar o conteúdo do API-Manager para a pasta C:\inetpub\wwwroot\RMS\Aplicacoes
   1. 
   2. 
6. Converter a aplicação API-Manager para aplicação e selecionar o pool criado para a API-Manager.
   1. 
   2. 
   3. 
7. Converter as APIs APIZeus e Auth7 para aplicação e selecionar o pool criado para as APIs.
   1. 
   2. 
   3. 

04. EXEMPLO DE UTILIZAÇÃO

       1. Na tela de listagem de clientes cadastrados, clicar no botão "Novo Cliente":

2. Preencher com a Razão Social e CNPJ do cliente, em seguida clicar em "Salvar":

3. A senha gerada nesta etapa é utilizada para recuperar um token durante as requisições. A senha será exibida apenas neste momento não podendo ser recuperada. Em caso de perda será necessário criar um novo cadastro:

4. Realizar requisição em "dominio/rms/rmsservices/auth7/api/v1/Credentials/company/Signin" para retornar um token:

5. Exemplo de requisição com token válido:

6. Exemplo de requisição com token inválido, nesse a expressão "invalid token" é exibida no response:

7. Exemplo de requisição sem token, neste caso é recepcionado o erro 401:

Obs.: O token por padrão possui validade de 8 horas. Para ajustar é necessário altera o seguinte arquivo appsettings.json no parâmetro TokenExpireTimeInHours e reiniciar o pool da aplicação

05. TELA NOVO CLIENTE

Outras Ações / Ações relacionadas

06. DEMONSTRAÇÃO