Ligar o seu site

Uma organização, um Moodle

Cada organização é dona de exatamente uma ligação ao Moodle. Como a ligação é 1:1 com uma instalação, se tiver vários Moodles (produção e testes, ou várias instituições) precisa de uma organização por instalação: cada uma com o seu ponto de acesso, as suas chaves e a sua utilização.

Registe o site

1. Abra Organização → Moodle e introduza o URL do seu Moodle. O HTTPS é obrigatório e o URL é validado contra intervalos de endereços privados, pelo que um site sem acesso público é recusado aqui.

2. O painel gera duas credenciais e mostra-as uma única vez:

   • a chave de licença, que identifica a sua instalação;
   • o segredo do painel, com o qual se assina cada pedido entre o plugin e o painel.

   Junto a elas verá também o seu subdomínio e o URL do seu ponto de acesso MCP — estes dois não são secretos e pode voltar a consultá-los nesta mesma página sempre que quiser.

3. Copie os valores e cole-os no plugin: veja o plugin do Moodle.

Ter apenas a chave de licença não dá nada: cada pedido tem também de levar uma assinatura válida calculada com o segredo, por isso o par só funciona em conjunto.

Verifique a ligação

O botão Validar licença do plugin confirma as credenciais e que o URL registado no painel corresponde ao site que está de facto a chamar. Depois de verificado, o painel guarda em cache o nome, a versão e o idioma do seu site a partir da informação do próprio Moodle, e mostra-os na página do Moodle.

Se a verificação falhar, a resolução de problemas cobre as causas habituais.

Renove as credenciais

Organização → Moodle → Renovar credenciais invalida de imediato a chave de licença e o segredo atuais e emite um novo par, mostrado uma única vez. Todos os proprietários e administradores recebem uma notificação de segurança.

Convém renovar quando:

• o segredo possa ter sido exposto (enviado por email, esquecido num repositório, visto por alguém que já saiu);
• migrar o site para outro servidor ou fornecedor de alojamento;
• tiver perdido os valores e precisar de um par funcional.

A ligação deixa de funcionar até colar o novo par no plugin, por isso conte com alguns minutos de interrupção para os assistentes.

Alterar o URL do site

Alterar o URL volta a correr a mesma validação. Se o seu Moodle mudar de domínio, atualize-o aqui primeiro e valide de novo a partir do plugin. As chaves continuam a funcionar: estão ligadas à ligação, não ao nome de anfitrião.

Desligar

Ao desligar são removidas as credenciais guardadas e os tokens cifrados do Moodle, e o ponto de acesso MCP deixa de resolver. As chaves existentes deixam de funcionar de imediato. Os tokens de serviço web permanecem no seu Moodle até os remover lá, por isso revogue também os utilizadores no plugin se estiver a desativar o site.