Compartilhar via


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:

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.

  1. Navegue paraPlug-ins> de Administração> do SiteAutenticação e, em seguida, selecione Gerir Autenticação.
  2. Localize o plug-in de autenticação openID Connect e selecione o ícone de olho para o ativar.
  3. Selecione Definições do plug-in para verificar os pontos finais de Autorização e Token .
    1. Os valores predefinidos devem ser:
      1. Ponto final de autorização: https://login.microsoftonline.com/common/oauth2/authorize.
      2. Ponto final de token: https://login.microsoftonline.com/common/oauth2/token.
  4. 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 AppIDKey.
  • 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

  1. 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.

  2. Na página Configuração da integração do Microsoft 365, selecione o separador Configuração .

  3. 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 AppIDKey.

    O script não funciona no PowerShell em sistemas operativos que não são o Windows.

  4. Prepare o script do PowerShell a partir do ficheiro ZIP da seguinte forma:

    1. Transfira e extraia o Moodle-AzureAD-Powershell.zip ficheiro.
    2. Abra a pasta extraída.
    3. Clique com o botão direito do rato no Moodle-AzureAD-Script.ps1 ficheiro e selecione Propriedades.
    4. No separador Geral do janela Propriedades, selecione a Unblock caixa de verificação junto ao 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, abra o menu Iniciar.
    2. Digitar PowerShell.
    3. Clique com o botão direito do rato em Windows PowerShell.
    4. Selecione Executar como Administrador.
  6. Navegue para o diretório deszipado ao escrever 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 lhe for pedido, inicie sessão na sua conta de administrador do Microsoft 365 na janela de pop-up.
    3. Quando lhe for pedido, introduza o nome da Aplicação Microsoft Entra. Por exemplo, abra os plug-ins LMS, Moodle ou Moodle.
    4. Quando lhe for pedido, introduza o URL do servidor Open LMS.
    5. 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\.
    6. 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.
    7. 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.

Passo 2: definir os detalhes da aplicação do Azure no OpenID Connect

  1. Regresse à página de configuração do plug-in de autenticação do OpenID Connect.
  2. Cole o AppID valor na caixa ID da Aplicação e o Key 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

  1. Na página Configuração da integração do Microsoft 365, selecione o separador Configuração .
  2. Em Escolher método de ligação, selecione Acesso à aplicação e, em seguida, selecione Guardar alterações novamente.
  3. Após a atualização da página, pode ver outra nova secção Administração consentimento & informações adicionais.
    1. 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.
    2. Junto ao campo Microsoft Entra inquilino, selecione o botão Detetar.
    3. Junto ao URL do OneDrive for Business, selecione o botão Detetar.
    4. Depois de os campos preencherem, selecione novamente o botão Guardar alterações .
  4. 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

  1. 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:

    1. Na página Configuração da integração do Microsoft 365, selecione o separador Definições de Sincronização .

    2. 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.

    3. 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.

  2. 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.

  3. Salvar alterações.

  4. 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.

    1. Desloque-se para baixo e localize a tarefa Sincronizar utilizadores com Microsoft Entra ID e selecione Executar agora.
      1. Isto irá sincronizar Microsoft Entra utilizadores com o seu site Open LMS de acordo com as opções de sincronização do utilizador.
    2. Em seguida, localize a tarefa Sincronizar cursos do Moodle com o Microsoft Teams e selecione Executar agora.
      1. 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.
      2. Esta tarefa também sincronizará os utilizadores do Open LMS inscritos no curso com o Teams como proprietários ou membros.
        1. Um proprietário da Equipa é um utilizador open LMS que cumpre todos os seguintes critérios:
          1. está ligado a uma conta do Microsoft 365.
          2. está inscrito no curso.
          3. tem a local/o365:teamowner capacidade no contexto do curso.
        2. Da mesma forma, um membro da Equipa é um utilizador open LMS que cumpre todos os seguintes critérios:
          1. está ligado a uma conta do Microsoft 365.
          2. está inscrito no curso.
          3. tem a local/o365:teamember capacidade no contexto do curso.
        3. A função predefinida Professor tem a local/o365:teamowner capacidade e a função Predefinida Estudante tem a local/o365:teammember capacidade .

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:

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: