Konfigurowanie wtyczek usługi Moodle LMS

W tym artykule dowiesz się, jak zainstalować i skonfigurować wtyczki Moodle LMS w celu włączenia aplikacji Microsoft Teams do środowiska Moodle.

Wymagania wstępne

Poniżej przedstawiono wymagania wstępne dotyczące konfigurowania zainstalowanego rozwiązania Moodle do pracy z usługą Microsoft Teams:

• Poświadczenia administratora moodle.
• Microsoft Entra poświadczenia administratora.
• Subskrypcja platformy Azure, w której można tworzyć nowe zasoby.

1. Instalowanie wtyczek Microsoft 365 Moodle

Integracja aplikacji Moodle z usługą Microsoft Teams jest obsługiwana przez zestaw wtyczek Microsoft 365 Moodle open source.

Wymagane aplikacje i wtyczki

Pobierz i zainstaluj następujące elementy:

1. Bieżąca stabilna wersja moodle.

   Ważna

   Jeśli nie masz istniejącej witryny Moodle, przejdź do repozytorium Moodle na platformie Azure i szybko wdróż wystąpienie moodle i dostosuj je do swoich potrzeb.

2. Pobierz i zapisz na komputerze lokalnym wtyczki Moodle OpenID Connect i Integracja platformy Microsoft 365 .

   Uwaga

   Instalowanie wtyczek OpenID Connect i Microsoft 365 Integration jest wymagane do integracji z usługą Teams.

   Zalecamy również zainstalowanie wtyczki motywu usługi Microsoft 365 Teams .

Instalowanie wtyczek

1. Pobierz wtyczki, wyodrębnij je i przekaż do odpowiednich folderów.
   • Wyodrębnij wtyczkę OpenID Connect (auth_oidc) do folderu o nazwie oidc i przekaż do folderu uwierzytelniania katalogu głównego dokumentu Moodle.
   • Wyodrębnij wtyczkę integracji platformy Microsoft 365 (local_o365) do folderu o nazwie o365 i przekaż do folderu lokalnego katalogu głównego dokumentu Moodle.
2. Zaloguj się do witryny Moodle jako administrator i wybierz pozycję Administracja witryną.
3. Po wykryciu nowych wtyczek, które mają zostać zainstalowane, usługa Moodle powinna przekierować Cię do strony instalowania nowych wtyczek. Jeśli tak się nie stanie, na stronie Administracja witryną wybierz pozycję Powiadomienia na karcie Ogólne , ta akcja powinna wyzwolić instalację wtyczek.
4. Po zainstalowaniu nowych wtyczek aplikacja Moodle wyświetli stronę ze wszystkimi nowymi konfiguracjami z zainstalowanych wtyczek. Tę stronę można bezpiecznie pominąć, stosując ustawienia domyślne. Wtyczki zostaną skonfigurowane w następujących krokach.

2. Włącz wtyczkę uwierzytelniania openid connect

Aby wtyczki Moodle komunikowały się z usługami firmy Microsoft, należy włączyć i skonfigurować wtyczkę uwierzytelniania OpenID Connect.

1. Przejdź do pozycjiUwierzytelnianie wtyczekadministracji lokacji>>, a następnie wybierz pozycję Zarządzaj uwierzytelnianiem.

2. Znajdź wtyczkę uwierzytelniania OpenID Connect i wybierz ikonę oka , aby ją włączyć.

3. Wybierz pozycję Ustawienia dla wtyczki, aby zweryfikować punkty końcowe autoryzacji i tokenu .

   1. Wartości domyślne powinny być następujące:
      1. Punkt końcowy autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize.
      2. Punkt końcowy tokenu: https://login.microsoftonline.com/common/oauth2/token.

4. Zarejestruj identyfikator URI przekierowania do późniejszego użycia.

   Uwaga

   Nie jest to wymagane dla wszystkich użytkowników moodle do wtyczki uwierzytelniania OpenID Connect jako metody uwierzytelniania; Jeśli jednak korzystają z innych metod uwierzytelniania, ich konta Moodle muszą być połączone z odpowiednimi kontami Microsoft, zanim będą mogły korzystać z pewnych funkcji integracji z usługą Teams, takich jak synchronizowanie własności i członkostwa w usłudze Teams.

3. Konfigurowanie połączenia między wtyczkami platformy Microsoft 365 i usługami firmy Microsoft

Aby można było współpracować, należy skonfigurować połączenie między wtyczkami platformy Microsoft 365 i usługami firmy Microsoft.

Uwaga

Podczas konfigurowania integracji pozostaw otwartą stronę konfiguracji integracji rozwiązania Microsoft 365 Moodle na osobnej karcie przeglądarki, ponieważ musisz powrócić do tego zestawu stron w całym procesie.

Tworzenie aplikacji platformy Azure

1. Przejdź do pozycjiWtyczkiadministracji lokacji>>Lokalne wtyczki, a następnie wybierz pozycję Integracja platformy Microsoft 365. Spowoduje to otwarcie strony konfiguracji integracji platformy Microsoft 365.

2. Na stronie Konfiguracja integracji platformy Microsoft 365 wybierz kartę Konfiguracja .

3. Wybierz przycisk Pobierz skrypt programu PowerShell i zapisz go jako folder ZIP na komputerze lokalnym.

   Uwaga

   Uruchomienie skryptu powoduje utworzenie nowej aplikacji Microsoft Entra w dzierżawie usługi Microsoft 365, która konfiguruje wymagane adresy URL odpowiedzi i uprawnienia, daje wymagane uprawnienia i zwraca AppID wartości i Key.

   Skrypt programu PowerShell działa tylko w systemach operacyjnych Windows.

4. Przygotuj skrypt programu PowerShell z pliku ZIP w następujący sposób:

   1. Pobierz i wyodrębnij Moodle-AzureAD-Powershell.zip plik.
   2. Otwórz wyodrębniony folder.
   3. Kliknij prawym przyciskiem Moodle-AzureAD-Script.ps1 myszy plik i wybierz pozycję Właściwości.
   4. Na karcie Ogólne okno Właściwości zaznacz Unblock pole wyboru obok atrybutu Zabezpieczenia znajdującego się w dolnej części okna.
   5. Wybierz przycisk OK.
   6. Skopiuj ścieżkę katalogu do wyodrębnionych folderów.

5. Uruchom program PowerShell jako administrator:

   1. W systemie Windows wybierz pozycję Uruchom.
   2. Typ: PowerShell.
   3. Kliknij prawym przyciskiem myszy Windows PowerShell.
   4. Wybierz pozycję Uruchom jako administrator.

6. Przejdź do rozpakowanego katalogu, wpisując cd .../.../Moodle-AzureAD-Powershell , gdzie .../... jest ścieżka do katalogu.

7. Wykonaj skrypt programu PowerShell:

   1. Wprowadź wartość ./Moodle-AzureAD-Script.ps1.
   2. Po wyświetleniu monitu zaloguj się do konta administratora platformy Microsoft 365 w oknie podręcznym.
   3. Po wyświetleniu monitu wprowadź nazwę aplikacji Microsoft Entra, na przykład wtyczki Moodle lub Moodle.
   4. Po wyświetleniu monitu wprowadź adres URL serwera Moodle.
   5. Po wyświetleniu monitu wprowadź adres URL odpowiedzi skopiowany ze strony konfiguracji wtyczki uwierzytelniania OpenID Connect. Jest to zasadniczo adres URL witryny Moodle, a następnie \auth\oidc\.
   6. Może zostać wyświetlony monit o ponowne zalogowanie się do konta platformy Microsoft 365 w oknie podręcznym w tym procesie. Ma to na celu wyrażenie zgody administratora na uprawnienia dodane do aplikacji dla twojej organizacji.
   7. Po zakończeniu wykonywania skryptu skopiuj identyfikator aplikacji (AppID) i klucz aplikacji(Key) wygenerowany przez skrypt i zapisz je.

Ustawianie szczegółów aplikacji platformy Azure w aplikacji Moodle

1. Wróć do strony konfiguracji wtyczki uwierzytelniania OpenID Connect.
2. Wklej AppID wartość w polu Identyfikator aplikacji i Key wartość w polu Klucz , a następnie wybierz pozycję Zapisz zmiany.

Konfigurowanie połączenia między wtyczkami firmy Microsoft a usługami firmy Microsoft

1. Na stronie Konfiguracja integracji platformy Microsoft 365 wybierz kartę Konfiguracja .
2. W obszarze Wybierz metodę połączenia wybierz pozycję Dostęp do aplikacji, a następnie ponownie wybierz pozycję Zapisz zmiany .
3. Po odświeżeniu strony zobaczysz kolejną nową sekcję Administracja zgody & dodatkowych informacji.
   1. Wybierz pozycję Podaj link Administracja Zgoda, wprowadź poświadczenia administratora globalnego platformy Microsoft 365, a następnie pozycję Zaakceptuj, aby udzielić uprawnień.
   2. Obok pola dzierżawy Microsoft Entra wybierz przycisk Wykryj.
   3. Obok adresu URL OneDrive dla Firm wybierz przycisk Wykryj.
   4. Po wypełnieniu pól ponownie wybierz przycisk Zapisz zmiany .
4. Wybierz przycisk Aktualizuj , aby zweryfikować instalację. Jeśli na tym etapie nie zostanie zgłoszony żaden błąd, oznacza to, że wtyczki firmy Microsoft mogą komunikować się z serwerem firmy Microsoft za pośrednictwem interfejsów API programu Microsoft Graph.

Konfigurowanie synchronizacji użytkowników i kursów

1. Synchronizuj użytkowników między serwerem Moodle i Tożsamość Microsoft Entra. W zależności od środowiska na tym etapie można wybrać różne opcje. Aby rozpocząć:

   1. Na stronie Konfiguracja integracji platformy Microsoft 365 wybierz kartę Ustawienia synchronizacji .

   2. W ustawieniu Synchronizuj użytkowników z Tożsamość Microsoft Entra zaznacz pola wyboru, które mają zastosowanie do twojego środowiska. Musisz wybrać następujące opcje:
      ✔ Tworzenie kont w aplikacji Moodle dla użytkowników w Tożsamość Microsoft Entra. ✔ Zaktualizuj wszystkie konta w aplikacji Moodle dla użytkowników w Tożsamość Microsoft Entra.

   3. W sekcji Ograniczenie tworzenia użytkownika możesz skonfigurować filtr, aby ograniczyć Microsoft Entra użytkowników, którzy są synchronizowani z usługą Moodle.

   Uwaga

   Włączenie synchronizacji użytkownika nie jest wymagane. Jednak znacznie ułatwi to łączenie użytkowników moodle z kontami platformy Microsoft 365.

   Synchronizacja użytkownika jest wykonywana przez uruchomienie synchronizacji użytkowników z Tożsamość Microsoft Entra zaplanowanego zadania.

2. W sekcji Synchronizacja kursów możesz wybrać opcję dostosowywania synchronizacji kursów , aby włączyć automatyczne tworzenie aplikacji Teams dla niektórych lub wszystkich istniejących kursów Moodle.

   Uwaga

   Synchronizacja kursu jest wykonywana przez uruchomienie kursów Sync Moodle do zaplanowanego zadania usługi Microsoft Teams .

3. Zapisywanie zmian.

4. Aby zweryfikować konfigurację synchronizacji, musisz uruchomić zaplanowane zadania ręcznie po raz pierwszy, przejdź do obszaruZadania>serwera>administracji lokacji>Zaplanowane zadania.

   1. Przewiń w dół i znajdź zadanie Synchronizuj użytkowników z Tożsamość Microsoft Entra i wybierz pozycję Uruchom teraz.
      1. Spowoduje to zsynchronizowanie Microsoft Entra użytkowników z witryną Moodle zgodnie z opcjami synchronizacji użytkownika.
   2. Następnie znajdź zadanie Synchronizuj kursy Moodle z usługą Microsoft Teams i wybierz pozycję Uruchom teraz.
      1. To zadanie spowoduje utworzenie grup dla wszystkich kursów Moodle z włączoną opcją synchronizacji, a także usługi Teams, jeśli w kursie znajdziesz właściciela zespołu .
      2. Zadanie zsynchronizuje również użytkowników Moodle zarejestrowanych w kursie z aplikacją Teams jako właścicielami lub członkami.
         1. Właściciel zespołu jest użytkownikiem moodle, który
            1. jest połączony z kontem platformy Microsoft 365 ORAZ
            2. jest zarejestrowany w kursie, AND
            3. local/o365:teamowner ma możliwość w kontekście kursu.
         2. Podobnie członek zespołu jest użytkownikiem Moodle, który
            1. jest połączony z kontem platformy Microsoft 365 ORAZ
            2. jest zarejestrowany w kursie, AND
            3. local/o365:teamember ma możliwość w kontekście kursu.
         3. Domyślna rola Nauczyciel ma tę funkcję local/o365:teamowner , a domyślna rola Ucznia ma local/o365:teammember tę możliwość.

Uwaga

Zaplanowane zadania są wyzwalane przez narzędzie Moodle Cron, które należy skonfigurować do częstego uruchamiania. Każde zaplanowane zadanie może mieć domyślny harmonogram, który można dostosować.

• Domyślny harmonogram zadania Synchronizuj użytkowników z Tożsamość Microsoft Entra wynosi co minutę.
• Domyślny harmonogram zadań Sync Moodle courses to Microsoft Teams jest codziennie o 1 w nocy w domyślnej strefie czasowej serwera Moodle.

Po zainstalowaniu i skonfigurowaniu wtyczek można:

• Wdróż bota Moodle Assistant na platformie Azure.
• Dodaj karty Moodle do klas teams.
• Dodaj klasy i spotkania usługi Teams do usługi Moodle LMS.

Dokumentacja dodatku Moodle

Jeśli chcesz zapoznać się z przewodnikami integracji platformy Microsoft 365 i informacjami o wersji rozwiązania Moodle, zobacz następujące zasoby:

• Dokumentacja integracji platformy Microsoft 365 w witrynie Moodle Docs.