Documentação
CyberPanel
O CyberPanel é um painel de controlo de código aberto para alojamento web. O Provibr fala com a API dele através das credenciais do administrador principal e gere os sites que lá estão: criá-los, suspendê-los e reativá-los, mudá-los para outro pacote e removê-los.
Ligar o acesso à API
Num CyberPanel acabado de instalar, a API está desligada, e isso vale também para o administrador principal. Liga-se no painel, em Users, API Access, para o utilizador admin. Não é preciso mais nada: o Provibr entra com as credenciais que já existem.
O administrador principal tem de se chamar admin
Uma parte da API do CyberPanel recusa qualquer nome que não seja admin, e é justamente a parte que enumera os sites do painel e indica em que ponto está um site novo. O Provibr precisa das duas coisas, por isso a conta preenchida abaixo é a que se chama admin.
O que o Provibr pede
Quatro campos. O agente guarda-os no cofre dele, no seu anfitrião; o Provibr não os consegue voltar a ler.
- O endereço do painel com a porta, por exemplo https://panel.example.com:8090. Sem porta, o Provibr acrescenta a 8090. O http simples é recusado: essa porta só fala TLS.
- O nome do administrador principal, que é admin.
- A palavra-passe desse administrador.
- A impressão digital SHA-256 do certificado, enquanto o painel usar o autoassinado.
O certificado
Todo o CyberPanel acabado de instalar apresenta o mesmo certificado autoassinado, emitido para www.example.com e assinado pelo próprio CyberPanel. Por isso um navegador chama-lhe incorreto em vez de autoassinado, e a cadeia nunca é validada. Ao preencher a impressão digital, o agente confia exatamente nesse certificado em vez de desligar a verificação. Lê-se a partir de qualquer máquina que alcance o painel:
openssl s_client -connect <host>:8090 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Se for colocado um certificado próprio no nome do painel, a cadeia valida-se sozinha e o campo pode ficar vazio. Aí essa é a melhor escolha, porque um certificado desses é substituído de vez em quando e um fixado teria de ser escrito aqui de cada vez.
Pacotes
O CyberPanel descreve num pacote aquilo que um site pode usar. O Provibr lê essa lista e refere-se a um pacote pelo nome; os pacotes em si criam-se e alteram-se no CyberPanel, não aqui.
Um plano de alojamento web no Provibr aponta para um pacote de uma integração. É isso que o cliente encomenda, e o preço é definido por quem vende.
O que um pedido envia
Um site no CyberPanel é indicado pelo domínio, e essa é também a identidade dele no Provibr. Um pedido leva quatro coisas:
- O domínio. Tem de estar livre no painel, e tudo o que o Provibr fizer depois com este servidor aponta para ele.
- Um endereço de contacto para o site.
- O pacote em que o site fica.
- Uma palavra-passe para o acesso ao painel que o CyberPanel cria por baixo do site.
Suspender e reativar
As duas coisas fazem efeito de imediato: o painel devolve o novo estado e a lista dele mostra-o logo. O Provibr suspende um site quando isso lhe é pedido e quando a capacidade é ultrapassada.
Espaço em disco e tráfego
O CyberPanel é o único painel de controlo no Provibr sem gráficos de consumo, e não é a integração que os deixa de fora: o painel não o mede. O tráfego é calculado e depois deitado fora, e o consumo de disco vem de uma cache que num site novo ficou vazia, por isso o zero que sai dali não se distingue de não ter sido usado nada.
Sites que já existem
Os sites criados fora do Provibr podem ser importados na página da integração: o agente enumera o que está no painel e escolhe-se quais passam a ser um servidor no Provibr.
O que isto não faz
O Provibr gere sites, não o painel: não instala o CyberPanel, não o atualiza e não muda definições do servidor. Não há consola, e o DNS, as caixas de correio e as bases de dados ficam intactos. O CyberPanel sabe fazer tudo isso sozinho, e o Provibr não o comanda.