Funcionalidades do Portal

O portal STCP Gemini é uma aplicação que facilita a configuração do STCP Gemini Server por possuir funcionalidades que vão desde o gerenciamento de instâncias, usuários, agendamentos, etc, até a possibilidade de iniciar conexões entre usuários e checar relatórios de comunição.

Página do Portal

A instalação do portal pode ser consultada no Procedimento de Implantação do STCP Gemini Server. Após instalá-lo, acesse em seu navegador o Endereço/IP em que foi configurado.

Seleção do EntryPoint

Para realizar o login será necessário selecionar um EntryPoint na caixa de seleção como mostra a imagem:

Caso não haja nenhum Entrypoint cadastrado ou mais de uma opção, consulte o administrador da rede e verifique qual utilizar.

Login

Durante o primeiro login utilize o operador stcpadmin e a senha Admin.

Ao fazer isso a listagem dos módulos será exibida, sendo eles: Configurador STCP, Admin, e Painel de Controle.

Módulo Configurador STCP

O módulo Configurador STCP permite ao operador manipular: Configuração de instâncias, serviços de rede, usuários (caixas postais), agendamentos, tipos de arquivos para transferência.

Para estabelecer uma conexão são necessários ao menos:

• Uma instância
• Um usuário
• Um serviço de autenticação
• Uma rede de supervisão
• Um nó de supervisão

Instâncias

As instâncias são as entidades fundamentais para efetuar conexões pois à elas são associados Usuários, Serviços, Tipos de arquivos e Agendamentos.

A seguir encontram-se os passos necessários para criar uma Instância.

Todas as ações do tópico serão explicadas a partir da listagem de instâncias presente no canto esquerdo da tela.

Adicionar Instâncias

Durante o primeiro login no portal não haverá nenhuma instância cadastrada e por isso algumas mensagens de aviso serão apresentadas.

O cadastro de uma nova instância é realizado clicando em “+ Adicionar” no canto superior direito da tela.

Seção Geral

O primeiro passo para cadastrar uma instância é definir seus atributos de Identificação. Segue uma tabela contendo os campos presentes nesta seção e suas especificações:

Seção Diretórios

Diretórios de dados: O segundo passo é definir os atributos para os diretórios de envio e recepção de arquivos, e controles do sistema. Segue abaixo uma tabela explicativa dos campos e suas especificações:

Seção Controles

Controle de Agenda: O terceiro passo ao cadastrar uma instância é configurar alguns atributos do agendamento, entre eles:

• Habilitar ou desabilitar o controle dos agendamentos cadastrados para os usuários da instância.
• Definir o intervalo em que o controle da agenda entrará em ação. Este intervalo de tempo é dado em milissegundos.

Controle de Lock: O quarto passo é configurar atributos de reinicialização de conexões e transmissões de arquivos. Segue abaixo a tabela explicativa dos campos e suas especificações:

Controle de sessões simultâneas: Em seguida configura-se o numero máximo de sessões abertas simultaneamente para a instância.

Outros controles: A última configuração da seção Controles é a definição dos seguinte parâmetros:

Autenticação de Usuários

As configurações da seção de autenticação são responsáveis por definir qual banco de dados será utilizado pela instância e quais políticas de senha deverão ser seguidas.

Configurações Básicas: Inicialmente, deve-se configurar a biblioteca utilizada para o banco de dados e qual será o tipo de autenticação, como pode ser observado na tabela a seguir:

Base de Dados: Em seguida configura-se a Base de Dados, nela são inseridas informações do banco de dados utilizado. Veja seus campos e especificações na tabela a seguir:

Políticas de senhas: Também podem ser alteradas as Políticas de senha, sua utilização não é obrigatória, porém recomenda-se aplicá-las por questões de segurança. Segue uma tabela explicativa dos campos desta subseção e suas especificações:

Log

A sessão Log é responsável pelo gerenciamento das mensagens de eventos. Segue abaixo suas subseções:

Configurações Básicas: Inicialmente, deve-se configurar a biblioteca utilizada para o banco de dados e qual será o tipo de autenticação, como pode ser observado na tabela abaixo:

Base de dados: Nesta subseção configura-se o banco de dados que armazenará os logs da aplicação.

Nível de log das mensagens de eventos: No cadastro dos logs também há essa subseção, onde são definidos quais logs serão gravados no banco de dados, quais serão mostrados no próprio Console Log do sistema e os comandos externos a serem executados.

Filtros de mensagem de evento: Os últimos campos antes de concluir o cadastro da Instância são:

Finalmente, para adicionar a Instância e concluir o cadastro, clique em Salvar.

Editar Instâncias

Caso precise editar algum parâmetro de uma instância já criada, acesse a lista de Instâncias e clique no ícone de edição presente à direita.

Já na página de edição, altere os atributos desejados e salve as modificações ao final. Em caso de dúvidas leia a descrição dos campos novamente no tópico de Adicionar Instâncias

Copiar Instâncias

A cópia ou exibição das instâncias é realizada através do menu de opções indicado por uma seta ao lado direito da tela. Para executar uma dessas ações, clique neste ícone a função Copiar como mostrado na imagem a seguir:

Remover Instâncias

Para remover uma Instância existente, deve-se acessar as opções ao lado direito da Instância a ser removida e clicar em Excluir. Remover instâncias é um procedimento que deve ser realizado com cautela pois, como dito anteriormente, à elas estão associados Usuários, Tipos de arquivo e Agendamentos.

Adicionar tipos de arquivo

Os tipos de arquivo são utilizados tanto na transmissão quanto recepção de arquivos em uma conexão. Sua função é realizar tratativas como conversões de nome, formato, etc.

Para criar um novo tipo de arquivo acesse o menu de opções indicado pela seta.

Em seguida, clique em + Adicionar.

Identificação

As primeiras informações a serem cadastradas na criação dos Tipos de Arquivo são seu nome, descrição e Tags que serão adicionadas ao nome dos arquivos tratados.

Informações

Nesta seção serão descritas as Informações do tipo de arquivo criado, entre elas se o tipo de arquivo fará tratativas Padrão ou através de uma Expressão Regular.

• Tratativas Padrão: Apesar de constar tal campo como possível seleção, ao criar uma instância o sistema atribuirá a ela um tipo de arquivo com tratativas padrão automaticamente. Por não ser possível existir 2 padrões, esta seleção se encontrará sempre bloqueada.

• Tratativas por Expressão Regular: Este tipo de tratativa será feita baseando-se no nome do arquivo transmitido, incluindo seu formato. Por exemplo, caso deseje que arquivos no formato TXT crie uma tratativa que busque pela expressão “txt” no campo Regex.

• Tipo de Arquivo Expressão Regular (Regex).

Transmissão: Nesta subseção configuram-se os parâmetros dos arquivos verificados pela tratativa durante o envio. Segue abaixo uma tabela explicativa contento tais parâmetros e suas especificidades:

OFTP2: Nesta subseção configuram-se os parâmetros dos arquivos que utilizam o protocolo OFTP 2 na comunicação com foco na segurança dos arquivos que serão transmitidos. Segue a tabela com os parâmetros e suas funcionalidades:

Recepção: Nesta subseção configuram-se os parâmetros dos arquivos verificados pela tratativa durante a recepção. Segue abaixo uma tabela explicativa contendo suas especificidades:

Execução de comando externo de validação

Nesta seção, informa-se sobre a execução de comandos externos após a validação dos arquivos.

Período de transferência

A última seção define os períodos de transferência de arquivos na instância. Segue uma tabela contendo os campos que devem ser configurados:

Finalmente, para adicionar o novo Tipo de Arquivo à Instância e concluir o cadastro, clique em Salvar.

Editar Tipos de Arquivo

Para editar um tipo de arquivo de uma instância, clique no ícone de edição como mostrado abaixo.

Após acessar a edição, altere os atributos desejados e salve as alterações.

Copiar Tipos de Arquivo

Para copiar um tipo de arquivo de uma instância, acesse o menu de seleção clicando na seta e selecione o campo desejado

Remover Tipos de Arquivo

Para remover um tipo de arquivo acesse o menu de seleção clicando na seta e selecionando a opção Excluir

Clique em Sim ao ser questionado.

Configurações de Redes

Redes são utilizadas nos processos de transferência em diversos âmbitos. Para configurá-las utilize o módulo STCP, nele será possível Adicionar, Editar, Copiar, Exibir e Remover Redes.

Adicionar Rede OFTP

Para adicionar um serviço clique em +Adicionar.

Ao fazer isso, será apresentada a tela para criar uma nova:

Aba Geral

Identificação da nova Rede

A primeira subseção a ser preenchida é a Identificação.

Siga a tabela abaixo para facilitar a inserção de dados:

Aba Comunicação

Na aba de Comunicação as subseções a serem preenchidas são: Interface local, Opções e TLS.

TLS - Chave Privativa

TLS- Certificados CA (Autoridades)

TLS- Opções

A terceira seção a ser preenchida varia a depender do tipo de Rede escolhida, segue abaixo tabelas explicativas para facilitar o preenchimento das informações em ambos os casos.

Rede OFTP

Para concluir o processo de cadastro da Rede, clique em Salvar como mostrado na imagem a seguir.

Editar Redes

Para editar uma Rede, acesse a lista de Redes em: Redes e depois Editar, como mostra a imagem.

Após acessar a edição, altere os campos desejados e salve as alterações.

Copiar Redes

A cópia ou exibição das Redes é realizada através do menu de opções ao lado da Rede desejada na lista de Redes. Para executar uma dessas ações, clique no ícone de opções ao lado de uma Rede e escolha a função Copiar como mostrado na imagem a seguir:

Remover Redes

Para remover uma Rede, siga os passos:

• Acesse a lista de Redes;

• Acesse os menus de seleção em uma Rede desejada clicando na seta e selecionando a opção Excluir

  

• Clique em Sim ao ser questionado por Tem certeza que deseja remover a rede [Nome_da_rede]?

Configurações de Usuários

Adicionar Usuário

O STCP Gemini Portal permite criar novos Usuários acessando o menu lateral em Usuários e clicando em +Adicionar.

Seção Geral

Identificação do Usuário

A primeira seção a ser preenchida é a de identificação. Segue uma tabela descrevendo quais informações do usuário devem ser inseridas e suas especificidades:

Seção Características

Protocolo para conexão de saída

A segunda seção a ser cadastrada é a de características. Segue abaixo uma tabela explicativa dos campos que devem ser preenchidos:

Seção Controles

A terceira seção a ser preenchido é a de Controle de Conexão, que possibilita a utilização de filtros de conexão, execução de comandos antes, ao iniciar e ao finalizar conexões e requisição de espera por parte do sistema até o términode execução de um comando.

Período de Conexão

A próxima subseção a ser preenchida é a de Período de Conexão, ela permite definir um período de tempo em que a conexão pode ser realizada pelo Usuário. Segue abaixo uma tabela explicativa contendo os campos e suas especificidades.

As últimas subseções de cadastro dos Usuários são responsáveis pelas configurações dos arquivos transmitidos e recebidos pelo Usuário. Segue as tabelas das subseções contendo os campos e suas especificidades:

Controle de arquivos na transmissão

• Exemplos de Configurações dos Arquivos:

Controle de arquivos na recepção

Controle de Hash da Máquina

Nesta seção, pode-se habilitar a funcionalidade de verificaçãodos Usuários através do Hash de Máquina. Esta funcionalidade impõe que um usuário possa se conectar ao Server apenas através de uma máquina. Segue abaixo uma tabela explicativa:

Seção OFTP

A próxima seção caso a opção OFTP seja habilitada é a OFTP, dividida nas subseções Identificação da comunicação, Opções, Comunicação, Interface Primária/Secundária e por fim, TLS.

TLS-Chave Privativa

Certificados CA (Autoridades)

TLS - Opções

Seção SFTP

A quinta seção caso a opção SFTP seja habilitada teremos as seguintes subseções Identificação da Comunicação, Autenticação de chave pública, Opções, Interface Primária/Secundária, Autenticação de servidor e Controle de Download/Upload.

Abaixo temos cada uma e suas respectivas tabelas explicativas:

Identificação da Comunicação

Autenticação de chave pública

A próxima subseção a ser cadastrada é a Autenticação de Chave Pública que é o local onde pode-se inserir uma Chave de Autenticação fornecida pelo Servidor SFTP para realizar a conexão corretamente e uma Senha, caso a Chave possua uma Senha definida.

Opções

Interface Primária/Secundária

• Interface primária: Representa o usuário com quem deseja-se fazer a transmissão.

• Interface secundária: A interface secundária tem o propósito de ser uma precaução caso a conexão seja interrompida com a interface primária. Ela só se ativará no caso descrito e os campos de cadastro são podem ser os mesmos da interface primária ou outro configurado.

Autenticação de servidor

Controle de Download/Upload

• Controle de Download: Nesta seção, são preenchidos os campos relacionados aos arquivos que serão baixados do Servidor SFTP para o Usuário ao realizar a conexão.

• Controle de Upload: Nesta seção, são preenchidos os campos relacionados aos arquivos que serão enviados do Usuário do Gemini para o Servidor SFTP ao realizar a conexão.

Editar Usuário

Para editar um Usuário, acesse a lista de Usuários em Usuários -> Editar

Após acessar a edição, altere os campos desejados e salve as alterações.

Copiar Usuário

A cópia ou exibição dos Usuários é realizada através do menu de opções ao lado esquerdo da lista de Usuários.

Para executar uma dessas ações, clique no ícone de opções e escolha a função Copiar como mostrado na imagem a seguir:

Remover Usuário

Por fim, para remover um Usuário existente, deve-se acessar as opções, clicar em Excluir e quando a mensagem de aviso for mostrada clique em Sim para removê-lo.

Adicionar Tipos de Arquivo de Usuário

O processo de criação dos tipos de arquivo para um Usuário é idêntico ao cadastro de Tipos de arquivo das Instâncias. Para adicionar um tipo de arquivo de usuário, acesse Usuários-> Tipos de arquivo de usuário:

Ao acessar a tela de Tipos de Arquivo, clique em + Adicionar e cadastre os campos do Tipo de Arquivo da mesma forma que o cadastro do Tipo de Arquivo de Instâncias.

Seção Geral

Seção Informações

Seção Execução de comando externo de validação

Seção Período de transferência

Editar Tipos de Arquivo de Usuário

Para editar um tipo de arquivo de um Usuário, acesse a lista de Usuários em Usuários -> Tiposde Arquivo -> Editar

Após acessar a edição, altere os atributos desejados e salve as alterações.

Copiar Tipos de Arquivo

A cópia ou exibição dos Tipos de Arquivo é realizada através do menu de opções ao lado do Tipo de Arquivo desejado na respectiva listagem.

Para executar uma dessas ações, clique no ícone de opções ao lado de um Tipo de Arquivo e escolha a função Copiar como mostrado na imagem a seguir:

Remover Tipos de Arquivo

Porfim, para remover um Tipo de Arquivo existente, deve-se acessar as opções ao lado do Tipo de Arquivo desejado, clicar em Excluir e ao ser apresentada a mensagem de confirmação, clique em Sim.

Configurações de Agendamento

A funcionalidade de Agendamento é utilizada para que o sistema possa iniciar as conexões dos usuários sem a necessidade de iniciá-las manualmente.

É possível +Adicionar, Editar, Copiar e Remover os Agendamentos.

Os Agendamentos são atribuídos a Usuários específicos, e com as datas e horários definidos de acordo com o Usuário.

Adicionar Agendamentos

O cadastro de agendamentos é realizado dentro da seção Agendamentos no módulo STCP. Para cadastrar um novo agendamento, clique em +Adicionar e aguarde a abertura da tela de cadastro:

Seção Geral

A primeira seção de cadastro dos Agendamentos é a Geral, nela são definidos o estado do Agendamento em Habilitado, seu Nome: e Descrição:

Seção Agenda

O cadastro de datas e horários do Agendamento é realizado na seção Agenda, que é dividida nas subseções Tipo de agenda, Intervalo e Período.

Tipo de Agenda

Intervalo

A subseção Intervalo contém os campos necessários para definir qual o modo de Agendamento, ou seja, a forma que o mesmo será executado. Esta subseção contém os campos: Modo, Dias da Semana, e Período de Conexão.

Período

Nesta subseção são cadastrados os parâmetros para o início e término do Agendamento, ou seja, quando o Agendamento irá iniciar e parar a sua execução.

Seção Transmissão/Recepção

Identificação

Temos agora as configurações dos arquivos transmitidos e recebidos no agendamento. Segue as tabelas das subseções contendo os campos e suas especificidades:

Controle de arquivos na transmissão

Controle de arquivos na recepção

Opções

Seção Executar comando externo

Esta seção é dividida nas subseções Executar comando externo e Aguardar término da execução do comando.

Editar Agendamentos

Para editar um Agendamento , acesse a lista de Agendamentos em Agendamentos -> Editar.

Após acessar a edição, altere os atributos desejados e salve as alterações.

Copiar Agendamentos

A cópia dos Agendamentos é realizada através do menu de opções ao lado do Agendamento desejado na lista de Agendamentos. Para executar uma dessas ações, clique no ícone de opções ao lado de um Agendamento e escolha a função Copiar como mostrado na imagem a seguir:

Excluir Agendamentos

Porfim, para remover um Agendamento existente, deve-se acessar as opções ao lado do Agendamento desejado, clicar em Excluir e ao aparecer a mensagem de aviso (Imagem abaixo) clique em Sim para removê-lo.