Compartilhar via

Configurar os plug-ins LMS do Moodle

  • Artigo

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

Pré-requisitos

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

  • Credenciais de administrador moodle.
  • Microsoft Entra credenciais de administrador.
  • Uma assinatura do Azure em que você pode criar novos recursos.

1. Instalar os Plug-ins do Microsoft 365 Moodle

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

Aplicativos e plug-ins necessários

Baixe e instale os seguintes itens:

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

    Importante

    Se você não tiver um site do Moodle existente, acesse o repositório Moodle no Azure e implante rapidamente uma instância do Moodle e personalize-a para suas necessidades.

  2. Baixe e salve o Moodle OpenID Connect e os plug-ins do Microsoft 365 Integration no computador local.

    Observação

    A instalação dos plug-ins OpenID Connect e Microsoft 365 Integration é necessária para a integração do Teams.

    Além disso, recomendamos instalar o plug-in tema do Microsoft 365 Teams .

Instalar plug-ins

  1. Baixe os plug-ins, extraia-os e carregue em suas pastas correspondentes.
    • Extraia o plug-in OpenID Connect (auth_oidc) para uma pasta chamada oidc e carregue na pasta de auth da raiz do documento moodle.
    • Extraia o plug-in integração do Microsoft 365 (local_o365) para uma pasta chamada o365 e carregue na pasta local da raiz do documento Moodle.
  2. Entre no site do Moodle como administrador e selecione Administração do site.
  3. Após a detecção de novos plug-ins a serem instalados, o Moodle deverá redirecioná-lo para a página instalar novos plug-ins. Se isso não acontecer, na página Administração do site , selecione Notificações na guia Geral , essa ação deverá disparar a instalação dos plug-ins.
  4. Depois que os novos plug-ins forem instalados, o Moodle mostrará uma página com todas as novas configurações dos plug-ins instalados. Você pode ignorar essa página com segurança aplicando as configurações padrão. Os plug-ins serão configurados nas etapas a seguir.

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

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

  1. Navegue atéAutenticaçãode Plug-ins>da Administração> do Site e selecione Gerenciar Autenticação.

  2. Localize o plug-in de autenticação do OpenID Connect e selecione o ícone de olho para ativá-lo.

  3. Selecione Configurações para o plug-in para verificar os pontos de extremidade Autorização e Token .

    1. Os valores padrão devem ser:
      1. Ponto de extremidade de autorização: https://login.microsoftonline.com/common/oauth2/authorize.
      2. Ponto de extremidade do token: https://login.microsoftonline.com/common/oauth2/token.

  4. Registre o URI de redirecionamento para uso posterior.

    Observação

    Não é necessário para todos os usuários do Moodle para o plug-in de autenticação do OpenID Connect como seu método de autenticação; no entanto, se eles usarem outros métodos de autenticação, suas contas moodle precisarão estar conectadas às respectivas contas da Microsoft antes de poderem usar determinados recursos na integração do Teams, como sincronizar a propriedade e a associação do Teams.

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

Você deve configurar a conexão entre os plug-ins do Microsoft 365 e os serviços da Microsoft antes que eles possam trabalhar juntos.

Observação

Ao configurar a integração, mantenha sua página de configuração do Microsoft 365 Moodle Integration aberta em uma guia de navegador separada, pois você precisa retornar a esse conjunto de páginas durante todo o processo.

Criar aplicativo do Azure

  1. Navegue atéPlug-ins>locais da Administração> de Sites e selecione Integração do Microsoft 365. Isso abrirá a página de configuração do Microsoft 365 Integration.

  2. Na página configuração de integração do Microsoft 365, selecione a guia Configuração .

  3. Selecione o botão Baixar Script do PowerShell e salve-o como uma pasta ZIP no computador local.

    Observação

    Executar o script cria um novo aplicativo Microsoft Entra no locatário do Microsoft 365, que configura as URLs e permissões de resposta necessárias, fornece as permissões necessárias e retorna o AppID e Key.

    O script do PowerShell só funciona em sistemas de operação do Windows.

  4. Prepare o script do PowerShell do arquivo ZIP da seguinte maneira:

    1. Baixe e extraia o Moodle-AzureAD-Powershell.zip arquivo.
    2. Abra a pasta extraída.
    3. Clique com o botão direito do mouse no Moodle-AzureAD-Script.ps1 arquivo e selecione Propriedades.
    4. Na guia Geral do janela Propriedades, selecione a caixa de seleção Unblock ao lado do atributo Segurança localizado na parte inferior da janela.
    5. Clique em 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 mouse no Windows PowerShell.
    4. Selecione Executar como Administrador.

  6. Navegue até o diretório descompactado digitando 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 solicitado, entre na sua conta de administrador do Microsoft 365 na janela pop-up.
    3. Quando solicitado, insira o nome do aplicativo Microsoft Entra, por exemplo, plug-ins Moodle ou Moodle.
    4. Quando solicitado, insira a URL do servidor Moodle.
    5. Quando solicitado, insira a URL de resposta copiada da página de configuração de plug-in de autenticação do OpenID Connect. Essa é essencialmente a URL do seu site do Moodle, seguida por \auth\oidc\.
    6. Você pode ser solicitado a entrar em sua conta do Microsoft 365 novamente em uma janela pop-up no processo. Isso é para fornecer o consentimento do administrador às permissões adicionadas ao aplicativo para sua organização.
    7. Quando o script terminar a execução, copie a ID do Aplicativo (AppID) e a Chave do Aplicativo(Key) geradas pelo script e salve-as.

Definir detalhes do aplicativo do Azure no Moodle

  1. Retorne à página de configuração de plug-in de autenticação do OpenID Connect.
  2. Cole o AppID valor na caixa ID do aplicativo e o Key valor na caixa Chave e selecione Salvar alterações.

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

  1. Na página configuração de integração do Microsoft 365, selecione a guia Configuração .
  2. Em Escolher método de conexão, selecione Acesso ao aplicativo e, em seguida, selecione Salvar alterações novamente.
  3. Após a atualização da página, você poderá ver outra nova seção Administração consentimento & informações adicionais.
    1. Selecione Fornecer Administração Link de Consentimento, insira suas credenciais de Administrador Global do Microsoft 365 e aceite conceder as permissões.
    2. Ao lado do campo Microsoft Entra locatário, selecione o botão Detectar.
    3. Ao lado da URL OneDrive for Business, selecione o botão Detectar.
    4. Depois que os campos forem preenchidos, selecione o botão Salvar alterações novamente.
  4. Selecione o botão Atualizar para verificar a instalação. Se nenhum erro for relatado nesta fase, significa que os plug-ins da Microsoft podem se comunicar com o servidor Microsoft por meio de APIs do Microsoft Graph.

Configurar a sincronização de usuário e curso

  1. Sincronizar usuários entre seu servidor Moodle e Microsoft Entra ID. Dependendo do seu ambiente, você pode selecionar opções diferentes durante essa fase. Para começar:

    1. Na página configuração de integração do Microsoft 365, selecione a guia Configurações de Sincronização .

    2. Na configuração Sincronizar usuários com Microsoft Entra ID, selecione as caixas de seleção que se aplicam ao seu ambiente. Você deve selecionar as seguintes opções:
      ✔ Crie contas no Moodle para usuários em Microsoft Entra ID. ✔ Atualize todas as contas no Moodle para usuários em Microsoft Entra ID.

    3. Na seção Restrição de Criação de Usuário, você pode configurar um filtro para limitar o Microsoft Entra usuários sincronizados com o Moodle.

    Observação

    Não é necessário ativar a sincronização do usuário; no entanto, facilitará muito a conexão dos usuários do Moodle com contas do Microsoft 365.

    A sincronização do usuário é executada executando os usuários de Sincronização com Microsoft Entra ID tarefa agendada.

  2. Na seção Sincronização de Cursos , você pode selecionar a opção sincronização de curso para ativar a criação automática do Teams para alguns ou todos os seus cursos moodle existentes.

    Observação

    A sincronização do curso é executada executando os cursos sincronizar moodle para a tarefa agendada do Microsoft Teams.

  3. Salvar alterações.

  4. Para validar a configuração de sincronização, você precisará executar as tarefas agendadas manualmente pela primeira vez, navegue até Tarefasagendadas da administração>>> do site.

    1. Role para baixo e localize a tarefa Sincronizar usuários com Microsoft Entra ID e selecione Executar agora.
      1. Isso sincronizará Microsoft Entra usuários com seu site do Moodle de acordo com as opções de sincronização do usuário.
    2. Em seguida, localize os cursos Sincronizar Moodle para a tarefa do Microsoft Teams e selecione Executar agora.
      1. Essa tarefa criará Grupos para todos os cursos do Moodle com a opção de sincronização ativada e também o Teams se um proprietário da Equipe puder ser encontrado no curso.
      2. A tarefa também sincronizará os usuários do Moodle registrados no curso com o Teams como proprietários ou membros.
        1. Um proprietário da equipe é um usuário do Moodle que
          1. está conectado a uma conta do Microsoft 365, AND
          2. está registrado no curso, AND
          3. tem a local/o365:teamowner capacidade no contexto do curso.
        2. Da mesma forma, um membro da equipe é um usuário do Moodle que
          1. está conectado a uma conta do Microsoft 365, AND
          2. está registrado no curso, AND
          3. tem a local/o365:teamember capacidade no contexto do curso.
        3. A função de Professor padrão tem a local/o365:teamowner funcionalidade e a função de Aluno padrão tem a local/o365:teammember funcionalidade.

Observação

As tarefas agendadas são disparadas pelo Moodle Cron, que precisa ser configurado para ser executado com frequência. Cada tarefa agendada pode ter um agendamento padrão, que pode ser personalizado.

  • O agendamento padrão dos usuários de Sincronização com Microsoft Entra ID tarefa é a cada minuto.
  • O agendamento padrão dos cursos de Sincronização moodle para a tarefa do Microsoft Teams é diário à 1h no fuso horário padrão do servidor Moodle.

Depois que os plug-ins forem instalados e configurados, você poderá:

Documentação extra do plug-in do Moodle

Se você quiser examinar os guias de integração e as notas de versão do Microsoft 365 do Moodle, confira estes recursos: