Ir para o conteúdo

Configurar o Drovio Server

Pode configurar o Drovio Server a partir do painel de administração ou a partir dos ficheiros de configuração. Nos dois casos, as alterações são tidas em conta enquanto o servidor está a correr: o ficheiro de configuração é vigiado e uma modificação produz efeito em poucos segundos, sem interromper as sessões em curso.

Três exceções exigem um reinício

  • Os plugins. A secção plugin_management é lida no arranque e não é recarregada a quente. Adicionar, retirar ou reconfigurar um plugin só produz, portanto, efeito após um reinício. As integrações como a integração Slack enquadram-se neste caso.
  • O escutador HTTP. tls, http_port e https_port são lidos uma única vez, quando o servidor começa a escutar. Alterá-los depois fica sem efeito até ao reinício. Em Linux, keystore e keystore_password são reaplicados no escutador em curso quando o servidor recebe SIGUSR2. Ver Ativar HTTPS.
  • O SSO. Os clientes SAML e OIDC são construídos no arranque. Ativar ou desativar o SSO produz efeito imediato, mas alterar as definições de um fornecedor exige um reinício. Ver SSO.

Todo o resto se aplica com o servidor em funcionamento. Ver Iniciar e parar o serviço para a sua plataforma.

A partir do painel de administração

O painel de administração está situado localmente no endereço:

http://localhost:8090/admin

Substitua localhost pelo seu endereço IP real se lhe aceder a partir de outra máquina. Se não o conseguir, consulte Resolução de problemas.

Painel de administração do Drovio Server: início de sessão

Criar o primeiro administrador

Uma instância de servidor nova não tem nenhum administrador. No primeiro arranque, escreve um token de instalação junto ao seu ficheiro de configuração, onde só o administrador do sistema o pode ler:

/etc/drovio-server/admin-setup.token

C:\ProgramData\Drovio\Drovio Server\admin-setup.token

config/admin-setup.token, junto a docker-compose.yml.

Abra o painel de administração. Enquanto não existir nenhum administrador, cada página do painel leva a Create the first administrator. Introduza o token e depois o seu endereço de e-mail, o nome apresentado aos outros administradores e uma palavra-passe. A palavra-passe precisa de pelo menos 12 caracteres, e uma palavra-passe comum é recusada.

O servidor elimina o token assim que o administrador é criado: deixa de poder ser usado.

Num cluster

Só um nó escreve o token. O seu registo indica qual, numa linha que começa por There is no administrator yet.

Administradores

Os administradores iniciam sessão com o seu endereço de e-mail. Pode adicionar outros administradores na página Administrators, que também permite alterar as suas palavras-passe ou removê-los. Cada administrador pode alterar o seu nome apresentado e a sua palavra-passe em Profile, diretamente a partir do menu do avatar.

Quando o correio está ativado, um administrador pode verificar o seu endereço com um código enviado por e-mail, logo após iniciar sessão.

O servidor envia notificações aos administradores cujo endereço está verificado: poucas licenças livres para associar, um número invulgarmente elevado de códigos enviados por e-mail, um certificado de início de sessão único prestes a expirar, e as das integrações e plugins.

Cada administrador pode escolher as notificações que pretende receber em Notifications, diretamente a partir do menu do avatar.

Atualizar a partir de uma versão anterior à 3.7.0

As versões anteriores declaravam os administradores em admin.properties, junto ao ficheiro de configuração. No primeiro arranque após a atualização, o Drovio Server transfere-os para a base de dados e depois muda o nome do ficheiro para admin.properties.migrated. Pode eliminá-lo em segurança assim que todos os administradores tiverem migrado.

Estes administradores ainda não têm endereço de e-mail, e terão de seguir estas instruções:

  1. Na página de início de sessão, siga Migrating from admin.properties?. A ligação aparece enquanto restar um administrador por migrar.
  2. Inicie sessão com o nome de utilizador e a palavra-passe de admin.properties.
  3. Introduza o seu endereço de e-mail e o nome apresentado aos outros administradores.
  4. Quando o correio está ativado, introduza o código enviado para esse endereço de e-mail.
  5. Substitua a palavra-passe se esta não cumprir as regras acima, como o antigo admin / admin predefinido.

A partir daí, inicie sessão com o seu endereço de e-mail.

Uma vez com sessão iniciada, vá à página Settings como abaixo para alcançar o painel de configuração.

Painel de administração do Drovio Server: definições

A partir daí, pode alterar qualquer definição utilizada pelo Drovio Server. Consulte a referência de configuração para o detalhe de cada campo.

Uma definição a mudar sem demora

O URL que designa este servidor: HTTP server → URL, necessário às notificações e aos convites de utilizadores.

A partir dos ficheiros de configuração

O Drovio Server configura-se através de um ficheiro JSON:

Abra /etc/drovio-server/settings.conf.

Abra C:\ProgramData\Drovio\Drovio Server\settings.conf.

A configuração está em formato JSON. Cada campo é descrito na referência de configuração.

O seu segredo JWT

O http.jwt_secret assina as sessões dos utilizadores e os tokens na API. Desde a versão 3.6.7, qualquer instalação, através dos instaladores Windows e Linux ou das imagens Docker, gera um segredo no primeiro arranque. Não tem nada a fazer.

As instalações implementadas na versão 3.6.6 ou anterior tinham o valor fornecido no pacote. Substitua-o por uma cadeia aleatória sua, por exemplo a saída de openssl rand -base64 32. Ao fazê-lo, os utilizadores com sessão iniciada são desligados.

Para ir mais longe