Ir para o conteúdo

Documentação

ISPConfig

O Provibr gere as contas de alojamento ISPConfig através da API remota do painel. O agente liga para fora à sua instalação ISPConfig, por isso não há portas de entrada nem VPN. Esta página descreve o que tem de diferente o ISPConfig e o que faz a integração.

Uma conta é um site

O ISPConfig separa o cliente (o cliente final, com um acesso e um conjunto de limites) do web_domain (o site). Uma conta de alojamento do Provibr é um site, identificado pelo domínio. Para criar um site é preciso um proprietário, por isso o Provibr cria um cliente novo e um site por baixo, e remove ambos de novo quando a conta é eliminada. O agente deduz o acesso do cliente a partir do domínio, de modo que encontra sempre o proprietário.

O que o agente precisa

Quatro campos, indicados uma só vez ao ligar a integração:

  • O endereço do painel: o URL https completo, incluindo a porta (8080 por omissão).
  • Um utilizador remoto: criado em System → Remote Users, limitado às funções de cliente e de sites.
  • A palavra-passe desse utilizador remoto.
  • A impressão digital TLS do painel: recomendada, porque uma instalação nova é autoassinada.
O utilizador remoto é uma conta à parte, não o administrador do painel. O ISPConfig permite limitá-lo exatamente às funções que o Provibr usa, de modo que a credencial no cofre do agente pode cingir-se às chamadas de cliente e de sites e a mais nada.

O certificado

O ISPConfig escuta na porta 8080 sobre TLS, e uma instalação nova apresenta um certificado autoassinado. Ao fixar a impressão digital dele, o agente pode ter a certeza de que chega ao painel. Lê-se com um comando de shell a partir de qualquer máquina que alcance o painel:

shell
openssl s_client -connect <host>:8080 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Os comandos e a saída do terminal estão em inglês em todo o lado, no painel e nestas páginas. Um só texto, uma só verdade: o que aqui se lê é literalmente o que o seu host vai devolver.

Se puser um certificado próprio no nome de anfitrião do painel, por exemplo com Let's Encrypt, a cadeia dele valida-se e pode deixar a impressão digital vazia. Aí essa é a melhor escolha, porque um certificado desses renova-se com regularidade e um fixado teria de ser substituído de cada vez.

Pacotes

Um pacote ISPConfig é um modelo de cliente, a mesma coisa a que se refere um plano do Provibr. Fixa os limites que um cliente recebe: quantos sites, quanto disco e tráfego, que serviços.

Escolhe-se um pacote pelo nome no formulário de pedido, e muda-se depois sem tempo de inatividade. Mudá-lo desloca os limites do cliente de uma vez.

A API remota não consegue criar um modelo de cliente, por isso os pacotes são construídos no próprio painel ISPConfig. O Provibr apenas se refere a eles pelo nome; um nome que não reconhece é recusado antes de se criar seja o que for.

O ciclo de vida da conta

Criar uma conta são dois passos por trás de um só comando: um cliente e um site por baixo. A partir daí, a conta comporta-se como qualquer outra conta de alojamento:

  • Criar: um cliente com o pacote escolhido, e um site com o domínio e a quota dele.
  • Suspender e reativar: o site fica fora de linha e volta, de forma reversível.
  • Mudar de pacote: atribuir outro modelo de cliente.
  • Remover: o cliente e o site dele, limpos em conjunto.

Suspender

Suspender inverte o indicador de ativo do site. O site fica fora de linha; o acesso do cliente permanece. O Provibr lê o mesmo indicador que escreve, de modo que o painel e o que se vê nunca se afastam.

O indicador na base de dados inverte-se de imediato, mas a configuração do servidor web é reescrita pela tarefa ao minuto do painel. O que o Provibr mostra é o indicador de ativo, e esse é coerente de imediato.

Consumo

O ISPConfig informa o consumo: disco por site face à quota dele, e tráfego do mês em curso. Ambos aparecem nos gráficos como para uma máquina virtual.

O consumo de disco é preenchido depois de a tarefa de monitorização do painel ter corrido, por isso num site novo ainda não há leitura, o que não é o mesmo que zero. O tráfego vem de uma chamada para todos os sites; o disco, de uma chamada por cliente.

Importar

As contas criadas em ISPConfig fora do Provibr podem ser importadas: a integração enumera os sites que o painel conhece, e escolhe-se quais retomar. As contas que não foram criadas através do Provibr ficam intactas até que o seja.