Documentação
Webmin e Virtualmin
O Webmin é a integração de painel de controlo para servidores que executam o Virtualmin. Cria e gere contas de alojamento web numa máquina que já está em funcionamento. Não há sistema operativo para instalar nem máquina para arrancar: cria-se uma conta, atribui-se-lhe um plano e, mais tarde, suspende-se, muda-se de plano ou remove-se.
O Webmin é o painel; o Virtualmin faz o alojamento
O produto é conhecido como Webmin, e é assim que esta página se chama. O que o Provibr comanda na realidade é o Virtualmin: o módulo que conhece domínios, planos e quotas. O Webmin isolado administra uma máquina Linux e desconhece por completo o conceito de conta de alojamento.
O que é preciso
A API remota do Webmin fala HTTP Basic, pelo que o segredo aqui é uma palavra-passe e não um token. É uma característica do Webmin e não uma decisão nossa, e é a razão pela qual as duas regras abaixo são mais rigorosas do que nos restantes painéis de controlo.
- Anfitrião: o endereço do painel. Tem de ser https, e a porta 10000 é acrescentada se for omitida.
- Utilizador do Webmin: o root funciona, mas é melhor um utilizador que tenha apenas o módulo Virtualmin.
- Palavra-passe: a desse utilizador. Não há nada a restringir, por isso convém escolher o utilizador com cuidado.
- Impressão digital TLS: obrigatória, porque o instalador do Webmin deixa um certificado autoassinado.
https e impressão digital são ambos obrigatórios
As outras integrações de painel de controlo aceitam um endereço http sem cifra e avisam do que isso custa. Esta não, e a diferença está no segredo: uma chave de acesso do DirectAdmin pode ser limitada a um punhado de comandos; uma palavra-passe do Webmin não pode ser limitada de todo.
A impressão digital lê-se a partir de qualquer máquina que alcance o painel e cola-se tal como veio, com ou sem dois pontos, e o prefixo que a ferramenta imprime pode ficar.
openssl s_client -connect <host>:10000 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256A API remota
O Provibr não usa a interface web do Webmin. Chama a API remota do módulo Virtualmin, que devolve respostas legíveis por máquina em vez de páginas. Em algumas instalações esse caminho está desativado; volta a ligar-se em Webmin, Webmin Configuration, Advanced Options.
Definições
Não há nenhuma. Um servidor Webmin decide por si onde vive uma conta e que endereço recebe, pelo que não sobra nada para escolher. O separador de definições continua a existir, porque é também aí que se reenviam as credenciais.
Planos
Um plano do Virtualmin é a descrição que o próprio painel tem de uma conta: quota de disco, tráfego mensal, quantos domínios e caixas de correio, que funcionalidades estão ativas. Não é um plano do Provibr nem um sistema operativo. É um nome a que nos referimos, e o seu conteúdo pode mudar no servidor do cliente sem que demos por isso.
A página da integração consegue ler a lista de planos com o que cada um inclui, para se ver o que se está a escolher em vez de escrever um nome de cor.
Um plano web fixa um plano do Virtualmin numa integração e dá-lhe um nome próprio. Encomendar com um plano prevalece sobre escolher um plano solto, e essa escolha solta continua disponível para os casos que um plano não cobre.
Como é uma conta no Provibr
Uma conta de alojamento é uma linha de servidor comum, do tipo servidor web. O seu identificador é o número interno que o Virtualmin dá ao domínio, e o domínio, o utilizador, o plano e as funcionalidades chegam em cada leitura.
- Criar uma conta exige um domínio, um endereço de e-mail, um plano e uma palavra-passe.
- O utilizador unix é derivado do domínio, por isso os hífenes são normais aqui, ao contrário do DirectAdmin, que tem uma regra de nomes própria.
- A palavra-passe não fica registada em lado nenhum. Fica apenas o facto de ter sido fornecida uma; o valor viaja em separado.
- Depois é possível suspender, retomar, mudar de plano e eliminar. Não há consola: uma conta de alojamento não a tem.
Quotas e utilização
A quota de disco e o tráfego seguem na leitura habitual, pelo que uma conta ganha um gráfico de utilização sem ser preciso ligar mais nada, desde que o servidor os consiga medir.
Adotar contas que já existem
O separador de importação lista as contas do painel e permite trazer para o Provibr as que se quiser. As contas já conhecidas aparecem, mas não podem voltar a ser selecionadas, para se ver o quadro completo e não um quadro filtrado.