Ir para o conteúdo

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.

Se ficar desligada, cada chamada volta como API Access Disabled, seja qual for o que se tenha preenchido. O CyberPanel verifica esse interruptor antes da palavra-passe, por isso uma palavra-passe certa dá exatamente a mesma resposta que uma errada. Tudo aponta para as credenciais enquanto o problema está uma caixa mais à frente.

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.

Isto não é uma definição mas uma condição, e vem do CyberPanel e não de nós: um administrador com outro nome não serve para esta integração. O teste de ligação di-lo, para que se saiba antes de o primeiro pedido dar por isso.

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 CyberPanel não tem nenhum token de API que cubra estes comandos: dentro da sua própria API a via do token está ligada ou desligada consoante o ponto de acesso, e são precisamente os quatro que criam, suspendem, mudam de pacote e removem um site que pedem a palavra-passe. Está aqui, portanto, a palavra-passe completa do administrador principal, a mesma situação que no Webmin.

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:

shell
openssl s_client -connect <host>:8090 </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 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.

Mudar um site para outro pacote altera o registo e mais nada. Medido a partir de dentro do servidor com um pacote que trazia outros limites: a quota de disco ficou como estava e a configuração do servidor web manteve os valores antigos. O painel mostra o nome novo, por isso esse nome lê-se como registo e não como um limite que tenha mudado com ele.

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.
Criar um site demora no CyberPanel cerca de cinquenta segundos, dos quais uns vinte e oito se vão numa tentativa de SSL que o painel faz de qualquer maneira. O Provibr espera pelo resultado verdadeiro em vez de acreditar na primeira resposta: essa chega ao fim de uns três segundos e não diz nada, nem sequer se o domínio ainda estava livre.

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.

No CyberPanel, suspender é um truque do servidor web e não um bloqueio da conta. O site deixa de estar acessível, mas o FTP, o correio e as bases de dados continuam a funcionar e o utilizador unix não fica bloqueado. Isso difere do DirectAdmin, e conta assim que a suspensão é usada para fazer cumprir alguma coisa.

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.

Um gráfico que fica em zero para sempre parece uma medição, e é por isso que não existe. O que um site pode usar está no pacote dele, e aquilo que o CyberPanel sabe fica no próprio painel.

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.

Um site importado conta para a capacidade a partir desse momento, como qualquer outro servidor web.

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.