Configurar os plug-ins do Moodle LMS

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

Pré-requisitos

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

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

1. Instale os plug-ins do Microsoft 365 Moodle

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

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 Moodle existente, acesse o repositório Moodle no Azure e implante rapidamente uma instância do Moodle e personalize-a de acordo com suas necessidades.

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

   Observação

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

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

Instale plug-ins

1. Baixe os plug-ins, extraia-os e carregue-os em suas pastas correspondentes.
   • Extraia o plug-in OpenID Connect (auth_oidc) para uma pasta chamada oidc e carregue na pasta auth da raiz do documento Moodle.
   • Extraia o plug-in de integração do Microsoft 365 (local_o365) para uma pasta chamada o365 e carregue na pasta local da raiz do documento do Moodle.
2. Faça login no site Moodle como administrador e selecione Administração do site.
3. Após a detecção de novos plug-ins a serem instalados, o Moodle deve redirecioná-lo para a página de instalação de novos plug-ins. Se isso não acontecer, na página Administração do site , selecione Notificações na guia Geral , essa ação deve acionar 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 esta 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ção deplug-ins>de administração> do site e selecione Gerenciar autenticação.

2. Encontre 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 verificar os pontos de extremidade de 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. Grave o URI de redirecionamento para uso posterior.

   Observação

   Não é necessário que todos os usuários do Moodle tenham o plug-in de autenticação OpenID Connect como método de autenticação; no entanto, se eles usarem outros métodos de autenticação, suas contas do Moodle precisarão ser conectadas às contas da Microsoft correspondentes 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.

Criar aplicativo do Azure

1. Navegue até Plug-ins de administração> do sitePlug-ins>locais e selecione Integração do Microsoft 365. Isso abrirá a página de configuração de integração do Microsoft 365.

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 seu computador local.

   Observação

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

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

4. Prepare o script do PowerShell a partir 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 Moodle-AzureAD-Script.ps1 mouse no arquivo e selecione Propriedades.
   4. Na guia Geral da janela Propriedades, marque a Unblock caixa de seleção ao lado do 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 mouse no Windows PowerShell.
   4. Selecione Executar como administrador.

6. Navegue até o diretório descompactado digitando cd .../.../Moodle-AzureAD-Powershell onde .../... está 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, digite o nome do aplicativo Microsoft Entra, por exemplo, Moodle ou plug-ins do Moodle.
   4. Quando solicitado, digite o URL do seu servidor Moodle.
   5. Quando solicitado, insira a URL de resposta copiada da página de configuração do plug-in de autenticação do OpenID Connect. Este é essencialmente o URL do seu site Moodle, seguido 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 consentimento do administrador para as 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 do 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 plug-ins da Microsoft e 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. Depois que a página for atualizada, você poderá ver outra nova seção Administração consentimento & informações adicionais.
   1. Selecione Fornecer link de consentimento de Administração, insira suas credenciais de Administrador Global do Microsoft 365 e Aceite para conceder as permissões.
   2. Ao lado do campo de locatário do Microsoft Entra, selecione o botão Detectar.
   3. Ao lado da URL do OneDrive for Business, selecione o botão Detectar.
   4. Após o preenchimento dos campos, selecione novamente o botão Save changes .
4. Selecione o botão Atualizar para verificar a instalação. Se nenhum erro for relatado neste estágio, isso significa que os plug-ins da Microsoft podem se comunicar com o servidor da Microsoft por meio de APIs do Microsoft Graph.

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

1. Sincronize usuários entre seu servidor Moodle e o Microsoft Entra ID. Dependendo do seu ambiente, você pode selecionar diferentes opções durante esta 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 o Microsoft Entra ID, marque 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 no Microsoft Entra ID. ✔ Atualize todas as contas no Moodle para usuários no Microsoft Entra ID.

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

   Observação

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

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

2. Na seção Sincronização do curso , você 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 executando os cursos do Sync Moodle com 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é Tarefas doServidor>de administração> do siteTarefas>agendadas.

   1. Role para baixo e localize a tarefa Sincronizar usuários com o Microsoft Entra ID e selecione Executar agora.
      1. Isso sincronizará os usuários do Microsoft Entra com o seu site Moodle de acordo com as opções de sincronização do usuário.
   2. Em seguida, localize a tarefa Sincronizar cursos do Moodle com o Microsoft Teams e selecione Executar agora.
      1. Esta 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 do Team puder ser encontrado no curso.
      2. A tarefa também sincronizará os usuários do Moodle inscritos no curso com o Teams como proprietários ou membros.
         1. Um proprietário de equipe é um usuário do Moodle que
            1. está conectado a uma conta do Microsoft 365 E
            2. está inscrito no curso, E
            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 E
            2. está inscrito no curso, E
            3. tem a local/o365:teamember capacidade no contexto do curso.
         3. A função padrão de Professor tem a local/o365:teamowner funcionalidade e a função padrão de Aluno tem a local/o365:teammember funcionalidade.

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

• Implantar o bot do Moodle Assistant no Azure.
• Adicione guias do Moodle às classes do Teams.
• Adicione classes e reuniões do Teams ao Moodle LMS.

Documentação extra do plugin Moodle

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

• Documentação de integração do Microsoft 365 no Moodle Docs.