Plesk

Não use a palavra-passe de administrador. O Plesk tem chaves de API, e uma chave tem exatamente a forma certa para isto: está ligada à conta que a criou, pode ser limitada a um conjunto de endereços e pode ser revogada sem alterar a palavra-passe de ninguém.

• Host: o endereço do painel. A porta 8443 é preenchida automaticamente se for omitida, e o endereço tem de ser https.
• Chave de API: criada em Tools & Settings, com uma conta de administrador.
• Impressão digital TLS: opcional, e necessária sempre que o painel ainda tiver o certificado autoassinado.

openssl s_client -connect <host>:8443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

O Plesk tem uma API REST e uma API XML/RPC mais antiga, e nenhuma delas está completa por si só: a REST não tem subscrições nem planos de serviço, a XML tem tudo mas devolve XML. O Provibr usa as duas: cria e remove por REST, lê, suspende e muda de plano por XML. A mesma chave abre ambas, pelo que basta preencher um valor.

Ao contrário do DirectAdmin, aqui não há opção sem cifra: o Plesk redireciona o http nas portas 8880 e 8443 para https, por isso o Provibr recusa um endereço http em vez de fingir que poderia funcionar.

O que uma instalação nova tem, isso sim, é um certificado autoassinado. Preencha a respetiva impressão digital e o agente confia nesse único certificado em vez de desligar a verificação; se o certificado for substituído mais tarde, a impressão digital tem de o acompanhar.

Um plano de serviço do Plesk é a descrição que o próprio painel faz de uma subscrição: quota de disco, tráfego mensal, quantos domínios e caixas de correio, que serviços estão ativos. Não é um plano do Provibr nem um sistema operativo. É um nome a que nos referimos, e o seu conteúdo pode mudar no seu servidor sem darmos por isso.

A página da integração consegue ler a lista de planos de serviço a partir do painel, para que veja o que escolhe em vez de escrever um nome de memória.

Um plano web fixa um plano de serviço numa integração e dá-lhe um nome à sua escolha. Encomendar com um plano é melhor do que escolher um plano de serviço solto, e o seletor solto mantém-se disponível para os casos que um plano não cobre.

Uma subscrição é uma linha de servidor normal do tipo servidor web. O seu identificador é o nome da subscrição, que no Plesk é o domínio principal, e o plano de serviço, a quota e o tráfego vêm em cada sondagem.

• Criar uma subscrição precisa de um domínio principal, um endereço de e-mail, um plano de serviço e uma palavra-passe. Não há um nome de conta separado para inventar.
• O domínio é a identidade: é o que o painel mostra, aquilo por que a sua API filtra e o que o Provibr guarda. Não pode ser alterado depois.
• A palavra-passe não fica registada em lado nenhum. Só fica o facto de ter sido fornecida uma; o valor viaja em separado e passa a ser tanto a palavra-passe do cliente como a de FTP.
• Depois, pode suspender, retomar, mudar de plano de serviço e eliminar. Não há consola, porque uma conta de alojamento não tem nenhuma.

O separador de importação lista as subscrições no painel e permite levar para o Provibr as que quiser. As subscrições já conhecidas são mostradas mas não podem ser selecionadas outra vez, para que veja o quadro completo e não um filtrado.

A quota e o tráfego vêm com a sondagem habitual, por isso uma subscrição ganha um gráfico de utilização sem que seja preciso ativar mais nada. O tráfego mensal é uma propriedade da subscrição e não uma taxa, por isso é mostrado como um número na conta e não como uma linha no gráfico.