Configurar os plug-ins do Moodle LMS para Open LMS
Neste artigo, irá aprender a instalar e configurar os plug-ins do Moodle LMS para integrar o Microsoft Teams com a sua experiência Open LMS.
Pré-requisitos
Para configurar um Open LMS instalado para funcionar com o Microsoft Teams:
- Verifique se o Moodle OpenID Connect e os plug-ins de integração do Microsoft 365 estão ativos.
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
Durante a configuração da integração, mantenha a sua página de configuração de integração do Microsoft 365 aberta num separador separador do browser, uma vez que terá de regressar a estas páginas ao longo do processo.
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 que todos os utilizadores do Open LMS utilizem 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 Open LMS 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.
Requisitos
Registe o Open LMS como uma aplicação no seu Microsoft Entra ID com o script do PowerShell. O script aprovisiona os seguintes itens:
- Uma nova aplicação Microsoft Entra para o seu inquilino do Microsoft 365, que é utilizada pelos plug-ins do Microsoft 365 Moodle.
- A aplicação para o seu inquilino do Microsoft 365 configura os URLs e permissões de resposta necessários para a aplicação aprovisionada e devolve e
AppID
Key
. - Nos sistemas operativos que não são o Windows, só deve seguir o processo manual para registar a instância do Open LMS no Azure. Consulte a secção Alerta importante abaixo para obter detalhes.
Importante
Para obter mais informações sobre como registar manualmente a instância do Open LMS, veja Registar a instância open LMS como uma aplicação.
Depois de registar a sua aplicação, verifique se todas as permissões da aplicação do Azure são aplicadas. Para obter mais informações, veja Permissões de aplicações do Azure.
Registar aplicação no Azure com o PowerShell
Passo 1: Criar uma 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 não funciona no PowerShell em sistemas operativos que não são o 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, abra o menu 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, abra os plug-ins LMS, Moodle ou Moodle.
- Quando lhe for pedido, introduza o URL do servidor Open LMS.
- 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 é o URL do seu site Open LMS 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
Passo 2: definir os detalhes da aplicação do Azure no OpenID Connect
- 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.
Passo 3: 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.
Passo 4: Configurar a sincronização de utilizadores e cursos
Sincronize os utilizadores entre o servidor Open LMS 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 Open LMS para utilizadores no Microsoft Entra ID. ✔ Atualize todas as contas no Open LMS para utilizadores no Microsoft Entra ID.Na secção Restrição de Criação de Utilizadores, pode configurar um filtro para limitar o Microsoft Entra utilizadores sincronizados com o Open LMS.
Observação
Não é absolutamente necessário ativar a sincronização do utilizador; No entanto, tornará muito mais fácil ligar utilizadores do Open LMS com 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 Open LMS existentes.
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. Navegue 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 Open LMS 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 Open LMS 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.
- Esta tarefa também sincronizará os utilizadores do Open LMS inscritos no curso com o Teams como proprietários ou membros.
- Um proprietário da Equipa é um utilizador open LMS que cumpre todos os seguintes critérios:
- está ligado a uma conta do Microsoft 365.
- está inscrito no curso.
- tem a
local/o365:teamowner
capacidade no contexto do curso.
- Da mesma forma, um membro da Equipa é um utilizador open LMS que cumpre todos os seguintes critérios:
- está ligado a uma conta do Microsoft 365.
- está inscrito no curso.
- 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 open LMS que cumpre todos os seguintes critérios:
- 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 e pode ser personalizada.
- A agenda predefinida da tarefa Sincronizar utilizadores com Microsoft Entra ID é de cada minuto.
- A agenda predefinida dos cursos do Sync Moodle para a tarefa do Microsoft Teams é diária à 1:00 no fuso horário predefinido do servidor Open LMS.
Depois de os plug-ins estarem instalados e configurados, pode:
- Adicione turmas e reuniões do Teams ao Open LMS.
- Implementar o Bot assistente do Moodle no Azure.
- Adicione separadores moodle às aulas do Teams.
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 do Open LMS, veja estes recursos: