Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Neste artigo, você aprenderá como instalar e configurar os plug-ins do Moodle LMS para integrar o Microsoft Teams à sua experiência no Open LMS.
Pré-requisitos
Para instalar e configurar um LMS aberto instalado para funcionar com o Microsoft Teams:
- Verifique se o Moodle, o OpenID Connect e os plug-ins de integração do Microsoft 365 estão ativos.
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 a página de configuração de integração do Microsoft 365 aberta em uma guia separada do navegador, pois você precisará retornar a essas páginas durante todo o processo.
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.
- Navegue atéAutenticação deplug-ins>de administração> do site e selecione Gerenciar autenticação.
- Encontre o plug-in de autenticação do OpenID Connect e selecione o ícone de olho para ativá-lo.
- Selecione Configurações para o plug-in verificar os pontos de extremidade de autorização e token .
- Os valores padrão devem ser:
- Ponto de extremidade de autorização:
https://login.microsoftonline.com/common/oauth2/authorize. - Ponto de extremidade do token:
https://login.microsoftonline.com/common/oauth2/token.
- Ponto de extremidade de autorização:
- Os valores padrão devem ser:
- Grave o URI de redirecionamento para uso posterior.
Observação
Não é necessário que todos os usuários do Open LMS usem 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 Open LMS precisarão ser conectadas às contas da Microsoft correspondentes antes que possam usar determinados recursos na integração do Teams, como sincronizar a propriedade e a associação do Teams.
Requisitos
Registre o Open LMS como um aplicativo no seu Microsoft Entra ID usando o script do PowerShell. O script provisiona os seguintes itens:
- Um novo aplicativo do Microsoft Entra para seu locatário do Microsoft 365, que é usado pelos plug-ins do Moodle do Microsoft 365.
- O aplicativo para seu locatário do Microsoft 365 configura as URLs de resposta e as permissões necessárias para o aplicativo provisionado e retorna o
AppIDeKey. - Em sistemas operacionais que não sejam Windows, você só deve seguir o processo manual para registrar sua instância do Open LMS no Azure. Confira a seção Alerta importante abaixo para obter detalhes.
Importante
Para obter mais informações sobre como registrar sua instância do Open LMS manualmente, consulte Registrar sua instância do Open LMS como um aplicativo.
Depois de registrar seu aplicativo, verifique se todas as permissões de aplicativo do Azure foram aplicadas. Para obter mais informações, consulte permissões de aplicativo do Azure.
Registrar aplicativo no Azure usando o PowerShell
Etapa 1: criar um aplicativo do Azure
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.
Na página Configuração de integração do Microsoft 365, selecione a guia Configuração .
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
AppIDeKey.O script não funciona no PowerShell em sistemas operacionais que não sejam Windows.
Prepare o script do PowerShell a partir do arquivo ZIP da seguinte maneira:
- Baixe e extraia o
Moodle-AzureAD-Powershell.ziparquivo. - Abra a pasta extraída.
- Clique com o botão direito do
Moodle-AzureAD-Script.ps1mouse no arquivo e selecione Propriedades. - Na guia Geral da janela Propriedades, marque a
Unblockcaixa de seleção ao lado do atributo Segurança localizado na parte inferior da janela. - Selecione OK.
- Copie o caminho do diretório para a pasta extraída.
- Baixe e extraia o
Execute o PowerShell como administrador:
- No Windows, abra o menu Iniciar.
- Digitar
PowerShell. - Clique com o botão direito do mouse no Windows PowerShell.
- Selecione Executar como administrador.
Navegue até o diretório descompactado digitando
cd .../.../Moodle-AzureAD-Powershellonde.../...está o caminho para o diretório.Execute o script do PowerShell:
- Digite
./Moodle-AzureAD-Script.ps1. - Quando solicitado, entre na sua conta de administrador do Microsoft 365 na janela pop-up.
- Quando solicitado, insira o nome do aplicativo do Microsoft Entra. Por exemplo, plug-ins Open LMS, Moodle ou Moodle.
- Quando solicitado, insira a URL do seu servidor Open LMS.
- Quando solicitado, insira a URL de resposta copiada da página de configuração do plug-in de autenticação do OpenID Connect. Essa é a URL do site do Open LMS seguido de
\auth\oidc\. - 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.
- 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.
- Digite
Etapa 2: definir detalhes do aplicativo do Azure no OpenID Connect
- Retorne à página de configuração do plug-in de autenticação do OpenID Connect.
- Cole o
AppIDvalor na caixa ID do aplicativo e oKeyvalor na caixa Chave e selecione Salvar alterações.
Etapa 3: Configurar a conexão entre plug-ins da Microsoft e serviços Microsoft
- Na página Configuração de integração do Microsoft 365, selecione a guia Configuração .
- Em Escolher método de conexão, selecione Acesso ao aplicativo e, em seguida, selecione Salvar alterações novamente.
- Depois que a página for atualizada, você poderá ver outra nova seção Administração consentimento & informações adicionais.
Selecione Fornecer link de consentimento de Administração, insira suas credenciais de Administrador Global do Microsoft 365 e Aceite para conceder as permissões.
Importante
O Administrador Global é uma função altamente privilegiada. Limite seu uso a cenários de emergência quando você não puder usar uma função existente. Para obter mais informações, veja Sobre funções de administrador no centro de administração do Microsoft 365.
Ao lado do campo de locatário do Microsoft Entra, selecione o botão Detectar.
Ao lado da URL do OneDrive for Business, selecione o botão Detectar.
Após o preenchimento dos campos, selecione novamente o botão Save changes .
- 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.
Etapa 4: Configure a sincronização do usuário e do curso
Sincronizar usuários entre seu servidor Open LMS e o Microsoft Entra ID. Dependendo do seu ambiente, você pode selecionar diferentes opções durante esta fase. Para começar:
Na página Configuração de integração do Microsoft 365, selecione a guia Configurações de sincronização .
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:
✔ Criar contas no Open LMS para usuários no Microsoft Entra ID.
✔ Atualizar todas as contas no Open LMS para usuários no Microsoft Entra ID.
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 são sincronizados com o Open LMS.
Observação
Não é absolutamente necessário para habilitar a sincronização do usuário; no entanto, facilitará muito a conexão de usuários do Open LMS com contas do Microsoft 365.
A sincronização do usuário é executada executando a tarefa agendada Sincronizar usuários com o Microsoft Entra ID.
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 Open LMS.
Observação
A sincronização do curso é realizada executando os cursos do Sync Moodle com a tarefa agendada do Microsoft Teams.
Salvar alterações.
Para validar a configuração de sincronização, você precisará executar as tarefas agendadas manualmente pela primeira vez. Navegue para Administração> do siteTarefas>do Servidor>Tarefas agendadas.
- Role para baixo e localize a tarefa Sincronizar usuários com o Microsoft Entra ID e selecione Executar agora.
- Isso sincronizará os usuários do Microsoft Entra com seu site Open LMS de acordo com as opções de sincronização do usuário.
- Em seguida, localize a tarefa Sincronizar cursos do Moodle com o Microsoft Teams e selecione Executar agora.
- Essa tarefa criará grupos para todos os cursos do Open LMS com a opção de sincronização ativada e também para o Teams, se um proprietário do Team puder ser encontrado no curso.
- Essa tarefa também sincronizará os usuários do Open LMS inscritos no curso com o Teams como proprietários ou membros.
- Um proprietário de equipe é um usuário do Open LMS que atende a todos os seguintes critérios:
- está conectado a uma conta do Microsoft 365.
- está matriculado no curso.
- tem a
local/o365:teamownercapacidade no contexto do curso.
- Da mesma forma, um membro da equipe é um usuário do Open LMS que atende a todos os seguintes critérios:
- está conectado a uma conta do Microsoft 365.
- está matriculado no curso.
- tem a
local/o365:teamembercapacidade no contexto do curso.
- A função padrão de Professor tem a
local/o365:teamownerfuncionalidade e a função padrão de Aluno tem alocal/o365:teammemberfuncionalidade.
- Um proprietário de equipe é um usuário do Open LMS que atende a todos os seguintes critérios:
- Role para baixo e localize a tarefa Sincronizar usuários com o Microsoft Entra ID e selecione Executar agora.
Observação
As tarefas agendadas são acionadas pelo Moodle Cron, que precisa ser configurado para ser executado com frequência. Cada tarefa agendada pode ter uma agenda padrão e pode ser personalizada.
- A programação padrão da tarefa Sincronizar usuários com o Microsoft Entra ID é a cada minuto.
- A programação padrão da tarefa Sincronizar cursos do Moodle com o Microsoft Teams é diariamente à 1h no fuso horário padrão do servidor Open LMS.
Depois que os plug-ins forem instalados e configurados, você poderá:
- Adicione classes e reuniões do Teams ao Open LMS.
- Implantar o bot do Moodle Assistant no Azure.
- Adicione guias do Moodle às classes do Teams.
Documentação extra do plugin Moodle
Se você quiser examinar os guias de integração e as notas de versão do Microsoft 365 do Open LMS, consulte estes recursos: