Índice:

Introdução

Após        Após a instalação do Smart View Agent, deve-se efetuar os passos de configuração inicial do Smart View (por padrão através do endereço

• Informação de dados do Provedor de Segurança, para integração com ERP TOTVS e gerenciador de identidade;
• Dados de integração como License Server;
• Dados do SGDB à ser usado para armazenar os metadados do Smart View como Armazenamento de Dados (Provedor de Dados até a V2.2.2)   
• Na etapa de 'Configurações da Integração' devem ser informados os dados de conexão ao ERP responsável por gerir a segurança do Smart View e realizar configurações avançadas (definição da porta e habilitar SSL). As etapas de Provedor de Segurança e License Server foram integradas à essa a partir da versão 3.6.
•     

Provedor de Segurança

      Nesta etapa é configurado o Provedor de Segurança de autenticação dos usuários para acesso ao Smart View. Deve primeiramente ser dado um nome ao provedor e em seguida devem ser informados, conforme detalhado na documentação do Provedor de Segurança do ERP TOTVS utilizado. Atualmente, o Agent possui duas formas de configuração, sendo:

• Descoberta Automática - apenas uma URL precisa ser informada;
• Descoberta Manual - necessário o preenchimento das URLs de criação de token, JWKS e base de API.

Verifique na documentação do seu ERP qual o modelo de descoberta de Provedor de Segurança é suportada.

       Após feito o login do usuário administrador, os campos Nome do usuário administrador e Nome do emissor serão automaticamente preenchidos, concluindo a configuração do Provedor de Segurança. Deve-se então avançar para a próxima etapa.

Servidor de Licença

• IP do Servidor: Informe o IP do servidor utilizado como License Server.
• Porta: Informe a porta cadastrada no seu License Server.
• CNPJ:  Informe o CNPJ da sua empresa.

       Depois que a configuração estiver concluída, verifique a disponibilidade do seu servidor clicando no botão.

Image Added

Armazenamento de Dados

Na      Na etapa de configuração do Armazenamento de Dados será definido qual banco de dados será utilizado para armazenar os metadados do Smart View, sendo possível escolher entre os tipos SQLite, PostgreSQL, SQL Server e Oracle (a partir da versão 3.5).Image Removed

Quando    Quando selecionado o provedor SQLite, não é necessário realizar nenhum tipo de configuração ou instalação adicional, por se tratar de um banco embarcado ao Smart View. Para realizar um backup, é necessário copiar os arquivos da pasta "db" na raiz da pasta onde o Smart View foi instalado "{pasta-de-instalação}\db\".

Para        Para os provedores do tipo PostgreSQL e SQL Server, deve ser configurada a conexão a um servidor de banco de dados, preenchendo as seguintes informações:

• Data Source - endereço do SGBD;
• Initial Catalog - nome da base a ser utilizada;
• User ID - Id do usuário;
• Password - senha do usuário.

Já        Já para o provedor Oracle, deve ser realizado o preenchimento das seguintes informações:

• Data Source - endereço do SGBD com porta, além do nome do serviço (Ex: dbserver:1521/XEPDB1);
• User ID - Id do usuário;
• Password - senha do usuário.

É possível, caso necessário, incluir mais parâmetros na string de conexão através do botão "Adicionar parâmetro".

Assim que todas as informações forem preenchidas, deve-se validar a conexão através do botão "Testar conexão". Nessa validação é exibido um relatório que exibe se:

• Foi possível conectar ao SGBD com o usuário/senha informado;
• A base de dados informada existe. Caso não exista, é verificado se o usuário possui permissão para criar;
• O usuário pode criar , alterar e excluir as editar tabelas da base informada;

Exemplo:

Image Removed

Image Added

Caso alguma das verificações falhe, o item verificado é exibido em vermelho e não será possível concluir a configuração.

Em alguns casos os itens são exibidos em amarelo, como forma de alerta, indicando que o Agent não pode verificar a permissão. Nesse cenário será possível concluir a configuração.

Exemplo:

Image RemovedImage Added

Assim que a conexão for validada, clique em "Concluir". 

Configurações da Integração

Nesta etapa você informará os dados de conexão ao ERP responsável por gerir a segurança do Smart View e realizar configurações avançadas (definição da porta e habilitar SSL).
Image Removed

A primeira configuração dessa etapa é o Provedor de Segurança de autenticação dos usuários para acesso ao Smart View. Deve ser dado um nome ao provedor e informado o endereço de descoberta, conforme detalhado na documentação do Provedor de Segurança do ERP TOTVS utilizado.

URL de descoberta automática do ERP

• RM
• PROTHEUS
• DATASUL
• TOTVS Agro Multicultivo 

Verifique na documentação do seu ERP qual o modelo de descoberta de Provedor de Segurança é suportada.

Em Conectar ao ERP deve ser preenchido um usuário e senha cadastrado no ERP que servirá como administrador do Smart View.
Image Removed

Com a conexão ao ERP concluída, podemos prosseguir para as configurações avançadas, que incluem as telas de Configurações de Rede e Servidor de Licença.
Image Removed

Na tela de Configurações de Rede existem os seguintes campos:
Image Removed

Caminho onde o arquivo de certificação está localizado. (Ex: "C:\Totvs\smart-view\certificados\pem_encrypted.crt")

Caminho onde a chave privada está localizada. (Ex: "C:\Totvs\smart-view\certificados\pem_encrypted_private.key")

A senha deve ser preenchida quando exigida pelo tipo de certificação.

Endereço utilizado pelo ERP para se conectar ao Smart View. Este campo é disponibilizado apenas quando o ERP suporta a instalação facilitada.

Fim da configuração

       Após

Na tela de Servidor de Licença existem os seguintes campos:
Image Removed

Porta cadastrada no Servidor de Licença.

CNPJ da empresa. (Obs: Item não obrigatório)

Ao realizar a conexão ao ERP, todos os campos disponibilizados pelo ERP serão preenchidos automaticamente no Servidor de Licença.

Quando não for realizada a configuração do Servidor de Licença, o Agent emitirá um alerta ao clicar em "Concluir" as configurações.
Image Removed

Se o usuário desejar realizar a configuração, basta clicar em 'Confirmar' para ser direcionado à tela do Servidor de Licença. Caso contrário, basta clicar em 'Cancelar' e concluir a configuração do Agent.

Servidor de Licença

• IP do Servidor: Informe o IP do servidor utilizado como License Server.
• Porta: Informe a porta cadastrada no seu License Server.
• CNPJ:  Informe o CNPJ da sua empresa.

Depois que a configuração estiver concluída, verifique a disponibilidade do seu servidor clicando no botão.

Image Removed

Geração de Certificado

O Totvs Certificates é um aplicativo que permite que o cliente possa gerar o seu próprio certificado, baseado nos seus nomes e IPs de acesso.

Exemplo: TOTVS02 www.totvs.com.br 192.7.32.33

Uso:
totvs_certificates [-cert file] [-key file] [-passwd password] [-issuer name] [[-host HostName] ...] [-h|-help]

-cert: Nome do arquivo de certificado (padrão: totvs_certificate.crt);
-key: Nome do arquivo de chave de certificado (padrão: totvs_certificate_key.pem);
-passwd: Palavra chave do certificado (senha);
-issuer: Nome do emissor do certificado (*1);
-host: Permite o registro de 'N' nomes ou IPs para o servidor no certificado (*2);
 HostName: Nome da máquina ou IP;
-h|-help: Mostra um descritivo de ajuda.

Observações:
Se o emissor não for definido, será usado o primeiro nome de máquina fornecido. Caso contrário, o primeiro IP será utilizado como nome do emissor;
Além disso, se nenhum "HostName" for definido, serão automaticamente incluídos o nome padrão da máquina acrescido dos sufixos de Domínio (DNS Suffix), bem como os endereços de acesso local (localhost e 127.0.0.1).

ou

totvs_certificates -host TOTVS02 -host www.totvs.com.br -host 192.7.32.33

O totvs_certificates está disponível para download em Windows e Linux.

Fim da configuração

Após configurar o Armazenamento de Dados, será apresentado a tela final de configuração será exibida. Clique em ', clique em "Abrir o Smart View' " para iniciar o uso do Smart View ou em ' "Ir ao Diagnóstico' " para verificar as configurações de instalação do Smart View.
Fim de configurações com todas as etapas configuradas:Image Removed

Fim de configurações sem conector e sem a URL para a integração entre o Smart View e o ERP:
Image Removed

Image Added