Assistente de configuração

A plataforma Navixy oferece um assistente de configuração que os usuários podem utilizar para configurar a plataforma inicialmente ou modificar algumas configurações comuns. Embora todas as configurações descritas abaixo possam ser aplicadas diretamente às configurações do banco de dados e dos serviços, fazê-lo pode ser arriscado se não for realizado com cuidado. Para evitar quaisquer riscos potenciais, é fortemente recomendável usar o configurador.

O assistente de configuração só pode ser usado para instâncias Navixy implantadas com o script de instalação no Ubuntu. Este assistente não é aplicável a outros métodos de implantação.

Inicializando o assistente de configuração

Para executar o assistente, vá para o diretório /navixy-package e execute ./configure.sh

Você será recebido pelo menu principal:

On-Premise - assistente de configuração

Abaixo está a explicação de cada menu e submenu:

1. Configurações de nome de domínio e SSL

1.1. Nomes de domínio

A única opção aqui é alterar os nomes de domínio e o SSL.

Nomes de domínio e certificados SSL são especificados durante a instalação inicial. No entanto, pode haver situação em que você precise alterar alguns destes para uma plataforma existente.

O Assistente de Configuração permite executar a configuração com um único nome de domínio para toda a plataforma ou com três nomes de domínio - separados para API, para o painel administrativo e para a interface do usuário.

No caso de um nome de domínio único, você só precisa especificar o domínio para o seu serviço no primeiro passo, deixando os outros dois domínios em branco. Nesse caso, a API e o painel administrativo serão configurados como subdiretórios (isso é feito automaticamente). Exemplos:

• my.domain.com/api

• my.domain.com/panel

Se você estiver realizando uma configuração com três nomes de domínio você precisa especificar, sequencialmente:

• Domínio do serviço (usado para a interface do usuário e ativação de dispositivos). Ex.: meu.dominio.com

• Domínio da API (usado para todas as operações de API). Ex.: api.domain.com

• Domínio do painel administrativo (usado para acessar o painel Admin). Ex.: panel.domain.com

On-Premise - Configurações de domínio

On-Premise - Configurações da API

On-Premise - Configurações do painel

Uma vez que todos os domínios estejam especificados, o assistente mostrará os resultados da sua configuração. Se precisar alterar algo, execute o assistente mais uma vez

On-Premise - Finalizando a configuração

Você pode obter mais informações sobre nomes de domínio nesta página: Domínios

1.2. Certificados SSL

Após os nomes de domínio serem configurados, você verá um menu de instalação de certificado SSL.

On-Premise - Certificados SSL

Se você não pretende usar SSL, basta selecionar Não e o script terminará, salvando apenas a configuração do nome de domínio.

Se você selecionar Sim, sua plataforma será configurada para usar HTTPS.

Em seguida, o script perguntará se você pretende usar certificados SSL gratuitos do Let's Encrypt ou se deseja usar seus próprios certificados.

On-Premise - Renovação de certificados SSL

Certificado gratuito Let's Encrypt

Selecione Sim para instalar certificados SSL gratuitos do Let's Encrypt para seus domínios. Isso também configurará a renovação automática dos certificados para que você não precise renová-los manualmente.

O script instalará o software necessário para emitir o certificado (isso pode levar algum tempo).

Você será solicitado a informar seu endereço de e-mail. Isso não é necessário, mas é recomendado.

On-Premise - Let's Encrypt

O script reconhecerá automaticamente os nomes de domínio (obtendo-os das configurações), gerará e instalará os certificados. Após isso, o script terminará.

Agora você configurou os nomes de domínio e seu site está protegido por SSL.

Seu próprio certificado SSL

Selecionar a Não opção em resposta à pergunta sobre certificados SSL do Let's Encrypt o levará ao menu para instalar seus próprios certificados SSL. Para prosseguir, você deve possuir um certificado full-chain válido, bem como sua chave privada. Coloque-os em algum lugar no seu servidor. O local padrão é /etc/nginx/ssl.

Primeiro você precisa especificar o caminho para o arquivo do certificado:

On-Premise - Certificado próprio

Em seguida, especifique o caminho para o arquivo da chave privada do seu certificado SSL:

On-Premise - Chave do certificado próprio

Os caminhos para seus certificados serão inseridos na configuração do Nginx.

Os certificados agora estão instalados e seus domínios estão protegidos por SSL.

2. Configurações de SMS

Aqui você pode aplicar as configurações do seu gateway SMS e também especificar as credenciais do remetente de SMS do serviço.

On-Premise - Gateway SMS

2.1. Configurar gateway SMS

A primeira opção neste menu permite desativar o gateway SMS caso você já possua um configurado e não precise mais usá-lo.

As outras opções permitem aplicar configurações para um provedor específico de serviços de gateway SMS.

A última opção permite conectar o gateway SMS via protocolo SMPP. Essa opção também é adequada se o provedor do seu gateway não estiver na lista, mas oferecer suporte a SMPP do lado dele.

On-Premise - Configuração do gateway SMS

Você pode saber mais sobre gateways SMS na página Gateways de mensageria.

Configurar 'nome do remetente' e 'número de telefone do remetente'

Neste menu você pode especificar o número e o nome do remetente das mensagens SMS de serviço, se necessário.

On-Premise - Número de telefone do Gateway SMS

On-Premise - Identificador do Gateway SMS

3. Configurações do gateway de e-mail

Aqui você pode configurar apenas as configurações de e-mail de feedback. Por favor, note: As configurações principais do gateway de e-mail são configuradas a partir do painel administrativo (Gateways de mensageria).

O script solicitará que você especifique o endereço de e-mail para receber feedbacks de usuários a partir da seção de ajuda (endereço de e-mail PARA).

On-Premise - Gateway de e-mail

Em seguida, você será perguntado sobre a substituição do e-mail do usuário.

On-Premise - Configuração do Gateway de e-mail

Selecione SIM para usar o endereço de e-mail do usuário para enviar solicitações de feedback.

Selecione NÃO para substituir o endereço de e-mail do remetente por um endereço específico. Nesse caso, o script solicitará que você especifique esse endereço de e-mail (endereço de e-mail DE).

On-Premise - Feedback do Gateway de e-mail

4. Configurações da API do Google Maps

Aqui você pode especificar a chave da API do Google Maps se você não comprou o pacote GIS Premium da Navixy, mas preferiu usar a chave que adquiriu por conta própria (GIS)

On-Premise - Chaves da API do Google Maps

Primeiro, você precisa especificar a chave JavaScript da API do Google (necessária para a disponibilidade dos mapas).

On-Premise - Chaves da API do Google Maps chave JavaScript

Em seguida, aplique a chave de servidor da API do Google (necessária para operações de geocodificação).

On-Premise - Chaves da API do Google Maps

5. Chave de licença Navixy

Esta seção contém duas opções.

On-Premise - Chave de licença Navixy

5.1. Alterar chave de licença

Aqui você pode especificar a chave de licença para sua instância On-premise. A chave de licença é aplicada durante a instalação inicial da plataforma, ou se for perdida ou corrompida por algum motivo (geralmente consequência de manipulação no banco de dados). A chave de licença é emitida e fornecida pelo suporte técnico.

Após selecionar esta opção, você verá um aviso de que alterar a chave de licença descuidadamente pode tornar a plataforma inoperante.

On-Premise - Alterar chave de licença

Depois disso, você precisa aplicar a chave de licença que recebeu. Esta é uma combinação de caracteres bastante longa, portanto pode ser bastante difícil digitá-la manualmente. Você pode colar a chave da área de transferência usando a combinação Shift+Insert Alternativamente, você pode segurar Shift e usar o clique direito do mouse.

On-Premise - Inserir chave de licença

A chave será inserida no banco de dados e sua instância terá uma licença válida.

5.2. Solicitar chave de avaliação

Esta opção só pode ser usada para obter uma chave de avaliação única. A chave é válida por 30 dias. Não utilize esta opção se você já possui uma chave válida.

On-Premise - Solicitar chave de avaliação

• Você não pode reemitir ou renovar a chave de avaliação desta forma.

• Você não pode restaurar uma chave perdida desta forma.

• Você não pode restaurar uma licença desabilitada desta forma.

Após seu período de avaliação expirar e você quiser continuar usando sua instância On-premise, por favor entre em contato com nossa equipe de sucesso do cliente para obter a chave de licença comercial.

6. Configurações de plugins

Plugins permitem modificar ou habilitar várias funções da plataforma. Como o configurador é projetado para configuração básica da plataforma, você só encontrará três plugins neste menu.

On-Premise - Configurações de plugins

6.1. Configurações do código de ativação

Aqui você pode habilitar ou desabilitar o uso de códigos de ativação obrigatórios para o registro de dispositivos. Se a opção "Obrigatório" estiver habilitada, os usuários não poderão registrar um dispositivo sem um código de ativação.

On-Premise - Configurações de códigos de ativação

6.2. Configurações de logotipo personalizado

Aqui você pode configurar um logotipo especial para um usuário individual.

Por favor, note: o logotipo para toda a plataforma é personalizado no painel administrativo.

O assistente de configuração solicitará que você especifique o ID do usuário (ele pode ser encontrado no painel administrativo ou na interface do usuário)

On-Premise - Configurações de logotipo

Em seguida, você precisa especificar um link para o logotipo do usuário. Ele pode estar localizado em um recurso externo ou localmente no servidor em um diretório do site. O logotipo deve estar em formato PNG, tamanho recomendado 400x400.

On-Premise - Logotipo

O logotipo será aplicado à interface do usuário e aos relatórios.

6.3. Configurações da seção de ajuda

Aqui você pode escolher se deseja ocultar ou mostrar a seção de ajuda na interface do usuário (ela é exibida por padrão). A seção de ajuda leva ao site da Navixy, portanto sua desativação pode ser útil para white labeling.

On-Premise - Configurações da seção de ajuda

7. Configurações de armazenamento de arquivos

Esta seção permite habilitar e desabilitar o armazenamento de arquivos.

On-Premise - Configurações de armazenamento de arquivos

É usado para armazenar anexos de arquivos e imagens aos formulários de tarefas e trabalhos de manutenção. O diretório padrão para armazenar arquivos é /home/java/api-server/files.