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:
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.
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
- 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.
- Inicie sessão no seu site do Moodle como administrador e selecione Administração de sites.
- 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.
- 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.
Navegue paraPlug-ins> de Administração> do SiteAutenticação e, em seguida, selecione Gerir Autenticação.
Localize o plug-in de autenticação openID Connect e selecione o ícone de olho para o ativar.
Selecione Definições do plug-in para verificar os pontos finais de Autorização e Token .
- Os valores predefinidos devem ser:
- Ponto final de autorização:
https://login.microsoftonline.com/common/oauth2/authorize
. - Ponto final de token:
https://login.microsoftonline.com/common/oauth2/token
.
- Ponto final de autorização:
- Os valores predefinidos devem ser:
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
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.
Na página Configuração da integração do Microsoft 365, selecione o separador Configuração .
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
AppID
Key
.O script do PowerShell só funciona em sistemas operativos Windows.
Prepare o script do PowerShell a partir do ficheiro ZIP da seguinte forma:
- Transfira e extraia o
Moodle-AzureAD-Powershell.zip
ficheiro. - Abra a pasta extraída.
- Clique com o botão direito do rato no
Moodle-AzureAD-Script.ps1
ficheiro e selecione Propriedades. - No separador Geral do janela Propriedades, selecione a
Unblock
caixa de verificação junto ao atributo Segurança localizado na parte inferior da janela. - Selecione OK.
- Copie o caminho do diretório para a pasta extraída.
- Transfira e extraia o
Execute o PowerShell como administrador:
- No Windows, selecione Iniciar.
- Digitar
PowerShell
. - Clique com o botão direito do rato em Windows PowerShell.
- Selecione Executar como Administrador.
Navegue para o diretório deszipado ao escrever
cd .../.../Moodle-AzureAD-Powershell
onde.../...
é o caminho para o diretório.Execute o script do PowerShell:
- Digite
./Moodle-AzureAD-Script.ps1
. - Quando lhe for pedido, inicie sessão na sua conta de administrador do Microsoft 365 na janela de pop-up.
- Quando lhe for pedido, introduza o nome da Aplicação Microsoft Entra, por exemplo, plug-ins Moodle ou Moodle.
- Quando lhe for pedido, introduza o URL do servidor Moodle.
- 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\
. - 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.
- 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.
- Digite
Definir detalhes da aplicação do Azure no Moodle
- Regresse à página de configuração do plug-in de autenticação do OpenID Connect.
- Cole o
AppID
valor na caixa ID da Aplicação e oKey
valor na caixa Chave e, em seguida, selecione Guardar alterações.
Configurar a ligação entre plug-ins da Microsoft e serviços Microsoft
- Na página Configuração da integração do Microsoft 365, selecione o separador Configuração .
- Em Escolher método de ligação, selecione Acesso à aplicação e, em seguida, selecione Guardar alterações novamente.
- Após a atualização da página, pode ver outra nova secção Administração consentimento & informações adicionais.
- 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.
- Junto ao campo Microsoft Entra inquilino, selecione o botão Detetar.
- Junto ao URL do OneDrive for Business, selecione o botão Detetar.
- Depois de os campos preencherem, selecione novamente o botão Guardar alterações .
- 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
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:
Na página Configuração da integração do Microsoft 365, selecione o separador Definições de Sincronização .
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.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.
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.
Salvar alterações.
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.
- Desloque-se para baixo e localize a tarefa Sincronizar utilizadores com Microsoft Entra ID e selecione Executar agora.
- Isto irá sincronizar Microsoft Entra utilizadores com o seu site moodle de acordo com as opções de sincronização do utilizador.
- Em seguida, localize a tarefa Sincronizar cursos do Moodle com o Microsoft Teams e selecione Executar agora.
- 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.
- A tarefa também sincronizará os utilizadores do Moodle inscritos no curso com o Teams como proprietários ou membros.
- Um proprietário da Equipa é um utilizador do Moodle que
- está ligado a uma conta do Microsoft 365, AND
- está inscrito no curso E
- tem a
local/o365:teamowner
capacidade no contexto do curso.
- Da mesma forma, um membro da Equipa é um utilizador do Moodle que
- está ligado a uma conta do Microsoft 365, AND
- está inscrito no curso E
- tem a
local/o365:teamember
capacidade no contexto do curso.
- A função predefinida Professor tem a
local/o365:teamowner
capacidade e a função Predefinida Estudante tem alocal/o365:teammember
capacidade .
- Um proprietário da Equipa é um utilizador do Moodle que
- Desloque-se para baixo e localize a tarefa Sincronizar utilizadores com Microsoft Entra ID e selecione Executar agora.
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:
- Implementar o Bot assistente do Moodle no Azure.
- Adicione separadores moodle às aulas do Teams.
- Adicione turmas e reuniões do Teams ao Moodle LMS.
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: