Compartilhar via


Configurar os plug-ins do Moodle LMS

Neste artigo, irá aprender a instalar e configurar os plug-ins do Moodle LMS para incorporar o Microsoft Teams com a sua experiência moodle.

Pré-requisitos

Eis os pré-requisitos para configurar um Moodle instalado para trabalhar com o Microsoft Teams:

  • Credenciais de administrador do Moodle.
  • Microsoft Entra credenciais de administrador.
  • Uma subscrição do Azure onde pode criar novos recursos.

1. Instalar os Plug-ins do Microsoft 365 Moodle

A integração do Moodle com o Microsoft Teams é suportada pelo código aberto conjunto de plug-ins do Microsoft 365 Moodle.

Aplicações e plug-ins necessários

Transfira e instale os seguintes itens:

  1. Uma versão estável atual do Moodle.

    Importante

    Se não tiver um site do Moodle existente, aceda ao repositório Moodle no Azure e implemente rapidamente uma instância do Moodle e personalize-a de acordo com as suas necessidades.

  2. Transfira e guarde o Moodle OpenID Connect e os plug-ins de Integração do Microsoft 365 no seu computador local.

    Observação

    Para a integração do Teams, é necessário instalar os plug-ins openID Connect e Microsoft 365 Integration.

    Além disso, recomendamos que instale o plug-in do Tema do Microsoft 365 Teams .

Instalar plug-ins

  1. Transfira os plug-ins, extraia-os e carregue-os para as respetivas pastas correspondentes.
    • Extraia o plug-in openID Connect (auth_oidc) para uma pasta chamada oidc e carregue para a pasta de autenticação da raiz do documento moodle.
    • Extraia o plug-in de Integração do Microsoft 365 (local_o365) para uma pasta denominada o365 e carregue-o para a pasta local da raiz do documento do Moodle.
  2. Inicie sessão no seu site do Moodle como administrador e selecione Administração de sites.
  3. Após a deteção de novos plug-ins a instalar, o Moodle deverá redirecioná-lo para a página instalar novos plug-ins. Se isto não acontecer, na página Administração do site , selecione Notificações no separador Geral , esta ação deve acionar a instalação dos plug-ins.
  4. Após a instalação dos novos plug-ins, o Moodle irá mostrar-lhe uma página com todas as novas configurações dos plug-ins instalados. Pode ignorar esta página com segurança ao aplicar as predefinições. Os plug-ins serão configurados nos passos seguintes.

2. Ativar o plug-in de autenticação do OpenID Connect

Para que os plug-ins do Moodle comuniquem com os serviços Microsoft, o plug-in de autenticação do OpenID Connect tem de estar ativado e configurado.

  1. Navegue paraPlug-ins> de Administração> do SiteAutenticação e, em seguida, selecione Gerir Autenticação.

  2. Localize o plug-in de autenticação openID Connect e selecione o ícone de olho para o ativar.

  3. Selecione Definições do plug-in para verificar os pontos finais de Autorização e Token .

    1. Os valores predefinidos devem ser:
      1. Ponto final de autorização: https://login.microsoftonline.com/common/oauth2/authorize.
      2. Ponto final de token: https://login.microsoftonline.com/common/oauth2/token.
  4. Registe o URI de Redirecionamento para utilização posterior.

    Observação

    Não é necessário para todos os utilizadores do Moodle para o plug-in de autenticação do OpenID Connect como método de autenticação; No entanto, se utilizarem outros métodos de autenticação, as respetivas contas Moodle têm de estar ligadas às contas Microsoft correspondentes antes de poderem utilizar determinadas funcionalidades na integração do Teams, como sincronizar a propriedade e a associação do Teams.

3. Configurar a ligação entre os plug-ins do Microsoft 365 e os serviços Microsoft

Tem de configurar a ligação entre os plug-ins do Microsoft 365 e os serviços Microsoft para que possam funcionar em conjunto.

Observação

Ao configurar a integração, mantenha a sua página de configuração da Integração do Microsoft 365 Moodle aberta num separador do browser separado, uma vez que tem de regressar a este conjunto de páginas ao longo do processo.

Criar aplicação do Azure

  1. Navegue paraPlug-insde Administração> de SitesPlug-ins> Locais e, em seguida, selecione Integração do Microsoft 365. Esta ação irá abrir a página configuração da Integração do Microsoft 365.

  2. Na página Configuração da integração do Microsoft 365, selecione o separador Configuração .

  3. Selecione o botão Transferir Script do PowerShell e guarde-o como uma pasta ZIP no seu computador local.

    Observação

    A execução do script cria uma nova aplicação Microsoft Entra no inquilino do Microsoft 365, que configura os URLs e permissões de resposta necessários, dá as permissões necessárias e devolve e AppIDKey.

    O script do PowerShell só funciona em sistemas operativos Windows.

  4. Prepare o script do PowerShell a partir do ficheiro ZIP da seguinte forma:

    1. Transfira e extraia o Moodle-AzureAD-Powershell.zip ficheiro.
    2. Abra a pasta extraída.
    3. Clique com o botão direito do rato no Moodle-AzureAD-Script.ps1 ficheiro e selecione Propriedades.
    4. No separador Geral do janela Propriedades, selecione a Unblock caixa de verificação junto ao atributo Segurança localizado na parte inferior da janela.
    5. Selecione OK.
    6. Copie o caminho do diretório para a pasta extraída.
  5. Execute o PowerShell como administrador:

    1. No Windows, selecione Iniciar.
    2. Digitar PowerShell.
    3. Clique com o botão direito do rato em Windows PowerShell.
    4. Selecione Executar como Administrador.
  6. Navegue para o diretório deszipado ao escrever cd .../.../Moodle-AzureAD-Powershell onde .../... é o caminho para o diretório.

  7. Execute o script do PowerShell:

    1. Digite ./Moodle-AzureAD-Script.ps1.
    2. Quando lhe for pedido, inicie sessão na sua conta de administrador do Microsoft 365 na janela de pop-up.
    3. Quando lhe for pedido, introduza o nome da Aplicação Microsoft Entra, por exemplo, plug-ins Moodle ou Moodle.
    4. Quando lhe for pedido, introduza o URL do servidor Moodle.
    5. Quando lhe for pedido, introduza o URL de resposta copiado da página de configuração do plug-in de autenticação do OpenID Connect. Este é essencialmente o URL do seu site moodle, seguido de \auth\oidc\.
    6. Poderá ser-lhe pedido para iniciar sessão novamente na sua conta do Microsoft 365 numa janela de pop-up no processo. Isto é para dar consentimento do administrador às permissões adicionadas à aplicação para a sua organização.
    7. Quando o script terminar a execução, copie o ID da Aplicação (AppID) e a Chave da Aplicação(Key) gerados pelo script e guarde-os.

Definir detalhes da aplicação do Azure no Moodle

  1. Regresse à página de configuração do plug-in de autenticação do OpenID Connect.
  2. Cole o AppID valor na caixa ID da Aplicação e o Key valor na caixa Chave e, em seguida, selecione Guardar alterações.

Configurar a ligação entre plug-ins da Microsoft e serviços Microsoft

  1. Na página Configuração da integração do Microsoft 365, selecione o separador Configuração .
  2. Em Escolher método de ligação, selecione Acesso à aplicação e, em seguida, selecione Guardar alterações novamente.
  3. Após a atualização da página, pode ver outra nova secção Administração consentimento & informações adicionais.
    1. Selecione Fornecer Administração ligação Consentimento, introduza as suas credenciais de Administrador Global do Microsoft 365 e, em seguida, Aceite para conceder as permissões.
    2. Junto ao campo Microsoft Entra inquilino, selecione o botão Detetar.
    3. Junto ao URL do OneDrive for Business, selecione o botão Detetar.
    4. Depois de os campos preencherem, selecione novamente o botão Guardar alterações .
  4. Selecione o botão Atualizar para verificar a instalação. Se não for comunicado nenhum erro nesta fase, significa que os plug-ins da Microsoft podem comunicar com o servidor da Microsoft através das APIs do Microsoft Graph.

Configurar a sincronização de utilizadores e cursos

  1. Sincronize os utilizadores entre o servidor Moodle e o Microsoft Entra ID. Consoante o seu ambiente, pode selecionar opções diferentes durante esta fase. Para começar:

    1. Na página Configuração da integração do Microsoft 365, selecione o separador Definições de Sincronização .

    2. Na definição Sincronizar utilizadores com Microsoft Entra ID, selecione as caixas de verificação que se aplicam ao seu ambiente. Tem de selecionar as seguintes opções:
      ✔ Crie contas no Moodle para utilizadores no Microsoft Entra ID. ✔ Atualize todas as contas no Moodle para utilizadores no Microsoft Entra ID.

    3. Na secção Restrição de Criação de Utilizadores, pode configurar um filtro para limitar a Microsoft Entra utilizadores sincronizados com o Moodle.

    Observação

    Não é necessário ativar a sincronização do utilizador; no entanto, tornará muito mais fácil ligar os utilizadores do Moodle às contas do Microsoft 365.

    A sincronização de utilizadores é efetuada ao executar a tarefa Sincronizar utilizadores com Microsoft Entra ID agendada.

  2. Na secção Sincronização de Cursos , pode selecionar a opção Personalização da sincronização do curso para ativar a criação automática do Teams para alguns ou todos os seus cursos existentes do Moodle.

    Observação

    A sincronização do curso é realizada ao executar os cursos do Sync Moodle para a tarefa agendada do Microsoft Teams.

  3. Salvar alterações.

  4. Para validar a configuração de sincronização, terá de executar as tarefas agendadas manualmente pela primeira vez e navegar paraTarefas Agendadas> doServidor> de Administração> deSites.

    1. Desloque-se para baixo e localize a tarefa Sincronizar utilizadores com Microsoft Entra ID e selecione Executar agora.
      1. Isto irá sincronizar Microsoft Entra utilizadores com o seu site moodle de acordo com as opções de sincronização do utilizador.
    2. Em seguida, localize a tarefa Sincronizar cursos do Moodle com o Microsoft Teams e selecione Executar agora.
      1. Esta tarefa irá criar Grupos para todos os cursos do Moodle com a opção de sincronização ativada e também o Teams se for possível encontrar um proprietário da Equipa no curso.
      2. A tarefa também sincronizará os utilizadores do Moodle inscritos no curso com o Teams como proprietários ou membros.
        1. Um proprietário da Equipa é um utilizador do Moodle que
          1. está ligado a uma conta do Microsoft 365, AND
          2. está inscrito no curso E
          3. tem a local/o365:teamowner capacidade no contexto do curso.
        2. Da mesma forma, um membro da Equipa é um utilizador do Moodle que
          1. está ligado a uma conta do Microsoft 365, AND
          2. está inscrito no curso E
          3. tem a local/o365:teamember capacidade no contexto do curso.
        3. A função predefinida Professor tem a local/o365:teamowner capacidade e a função Predefinida Estudante tem a local/o365:teammember capacidade .

Observação

As tarefas agendadas são acionadas pelo Moodle Cron, que tem de ser configurado para ser executado com frequência. Cada tarefa agendada pode ter uma agenda predefinida, que pode ser personalizada.

  • A agenda predefinida da tarefa Sincronizar utilizadores com Microsoft Entra ID é de cada minuto.
  • A agenda predefinida dos cursos de Sincronização do Moodle para a tarefa do Microsoft Teams é diária à uma da manhã no fuso horário predefinido do servidor Moodle.

Depois de os plug-ins estarem instalados e configurados, pode:

Documentação do plug-in do Moodle extra

Se quiser rever os guias de integração e as notas de versão do Microsoft 365 da Moodle, veja estes recursos: