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 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:
openssl s_client -connect <host>:8080 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Se 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.
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.
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.
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.