Moodle LMS 플러그 인 설정

아티클
10/21/2023

이 문서에서는 Moodle 환경에 Microsoft Teams를 통합하도록 Moodle LMS 플러그 인을 설치하고 구성하는 방법을 알아봅니다.

필수 구성 요소

Microsoft Teams와 함께 작동하도록 설치된 Moodle을 설정하기 위한 필수 구성 요소는 다음과 같습니다.

Moodle 관리자 자격 증명.
관리자 자격 증명을 Microsoft Entra.
새 리소스를 만들 수 있는 Azure 구독입니다.

1. Microsoft 365 Moodle 플러그 인 설치

Microsoft Teams와의 Moodle 통합은 오픈 소스 Microsoft 365 Moodle 플러그 인 집합에 의해 구동됩니다.

필수 애플리케이션 및 플러그 인

다음 항목을 다운로드하여 설치합니다.

Moodle의 현재 안정적인 버전입니다.

중요

기존 Moodle 사이트가 없는 경우 Azure의 Moodle 리포지토리로 이동하여 Moodle instance 신속하게 배포하고 필요에 맞게 사용자 지정합니다.
Moodle OpenID Connect 및 Microsoft 365 통합 플러그 인을 다운로드하여 로컬 컴퓨터에 저장합니다.

참고

Teams 통합을 위해서는 OpenID Connect 및 Microsoft 365 통합 플러그 인을 설치해야 합니다.

또한 Microsoft 365 Teams 테마 플러그 인을 설치하는 것이 좋습니다.

플러그 인 설치

플러그 인을 다운로드하고 추출한 다음 해당 폴더에 업로드합니다.
- OpenID Connect 플러그 인(auth_oidc)을 oidc라는 폴더에 추출하고 Moodle 문서 루트의 인증 폴더에 업로드합니다.
- Microsoft 365 통합 플러그 인(local_o365)을 o365라는 폴더에 추출하고 Moodle 문서 루트의 로컬 폴더에 업로드합니다.
Moodle 사이트에 관리자 권한으로 로그인하고 사이트 관리를 선택합니다.
설치할 새 플러그 인이 검색되면 Moodle에서 새 플러그 인 설치 페이지로 리디렉션해야 합니다. 이런 일이 발생하지 않으면 사이트 관리 페이지에서 일반 탭에서 알림을 선택합니다. 이 작업은 플러그 인 설치를 트리거해야 합니다.
새 플러그 인이 설치되면 Moodle은 설치된 플러그 인의 모든 새 구성이 포함된 페이지를 표시합니다. 기본 설정을 적용하여 이 페이지를 안전하게 건너뛸 수 있습니다. 플러그 인은 다음 단계에서 구성됩니다.

2. OpenID Connect 인증 플러그 인 사용

Moodle 플러그 인이 Microsoft 서비스와 통신하려면 OpenID Connect 인증 플러그 인을 켜고 구성해야 합니다.

사이트 관리>플러그 인>인증으로 이동한 다음 인증 관리를 선택합니다.
OpenID Connect 인증 플러그 인을 찾아 눈 아이콘을 선택하여 켭니다.
플러그 인에 대한 설정을 선택하여 권한 부여 및 토큰 엔드포인트를 확인합니다.
1. 기본값은 다음과 같습니다.
  1. 권한 부여 엔드포인트: https://login.microsoftonline.com/common/oauth2/authorize.
  2. 토큰 엔드포인트: https://login.microsoftonline.com/common/oauth2/token.
나중에 사용할 수 있도록 리디렉션 URI 를 기록합니다.

참고

모든 Moodle 사용자가 OpenID Connect 인증 플러그 인을 인증 방법으로 사용할 필요는 없습니다. 그러나 다른 인증 방법을 사용하는 경우 Teams 소유권 및 멤버 자격 동기화와 같은 Teams 통합의 특정 기능을 사용하려면 Moodle 계정을 해당 Microsoft 계정에 연결 해야 합니다.

3. Microsoft 365 플러그 인과 Microsoft 서비스 간의 연결 구성

Microsoft 365 플러그 인과 Microsoft 서비스 간의 연결을 구성해야 함께 작동할 수 있습니다.

참고

통합을 구성하는 동안 프로세스 전체에서 이 페이지 집합으로 돌아가야 하므로 Microsoft 365 Moodle Integration 구성 페이지를 별도의 브라우저 탭에서 열어 둡

Azure 앱 만들기

사이트 관리>플러그 인로컬 플러그 인>으로 이동한 다음 Microsoft 365 통합을 선택합니다. 그러면 Microsoft 365 통합 구성 페이지가 열립니다.
Microsoft 365 통합 구성 페이지에서 설정 탭을 선택합니다.
PowerShell 스크립트 다운로드 단추를 선택하고 로컬 컴퓨터에 ZIP 폴더로 저장합니다.

참고

스크립트를 실행하면 Microsoft 365 테넌트에서 새 Microsoft Entra 애플리케이션이 만들어집니다. 이 애플리케이션은 필요한 회신 URL 및 권한을 설정하고 필요한 권한을 부여하고 및 Key을 AppID 반환합니다.

PowerShell 스크립트는 Windows 운영 시스템에서만 작동합니다.
다음과 같이 ZIP 파일에서 PowerShell 스크립트를 준비합니다.
1. 파일을 다운로드하고 추출합니다 Moodle-AzureAD-Powershell.zip .
2. 추출된 폴더를 엽니다.
3. 파일을 마우스 오른쪽 단추로 Moodle-AzureAD-Script.ps1 클릭하고 속성을 선택합니다.
4. 속성 창 일반 탭에서 창 아래쪽에 있는 보안 특성 옆의 확인란을 선택합니다Unblock.
5. 확인을 선택합니다.
6. 디렉터리 경로를 추출된 폴더에 복사합니다.
관리자 권한으로 PowerShell을 실행합니다.
1. Windows에서 시작을 선택합니다.
2. PowerShell를 입력합니다.
3. Windows PowerShell 마우스 오른쪽 단추로 클릭합니다.
4. 관리자 권한으로 실행을 선택합니다.
디렉터리에 대한 경로는 어디에 있는지 .../... 를 입력하여 cd .../.../Moodle-AzureAD-Powershell 압축되지 않은 디렉터리로 이동합니다.
PowerShell 스크립트를 실행합니다.
1. 를 입력합니다 ./Moodle-AzureAD-Script.ps1.
2. 메시지가 표시되면 팝업 창에서 Microsoft 365 관리자 계정에 로그인합니다.
3. 메시지가 표시되면 Microsoft Entra 애플리케이션의 이름(예: Moodle 또는 Moodle 플러그 인)을 입력합니다.
4. 메시지가 표시되면 Moodle 서버의 URL을 입력합니다.
5. 메시지가 표시되면 OpenID Connect 인증 플러그 인 구성 페이지에서 복사한 회신 URL을 입력합니다. 이 URL은 기본적으로 Moodle 사이트의 URL이며 뒤에 가 잇습니다 \auth\oidc\.
6. 프로세스의 팝업 창에서 Microsoft 365 계정에 다시 로그인하라는 메시지가 표시될 수 있습니다. 이는 organization 대한 앱에 추가된 권한에 대한 관리자 동의를 제공하기 위한 것입니다.
7. 스크립트 실행이 완료되면 스크립트에서 생성된 애플리케이션 ID(AppID) 및 애플리케이션 키(Key) 를 복사하여 저장합니다.

Moodle에서 Azure 앱 세부 정보 설정

OpenID Connect 인증 플러그 인 구성 페이지로 돌아갑니다.
값을 애플리케이션 ID 상자에 붙여 AppID 넣고 Key키 상자에 값을 붙여넣은 다음 변경 내용 저장을 선택합니다.

Microsoft 플러그 인과 Microsoft 서비스 간의 연결 구성

Microsoft 365 통합 구성 페이지에서 설정 탭을 선택합니다.
연결 방법 선택에서 애플리케이션 액세스를 선택한 다음 변경 내용 저장을 다시 선택합니다.
페이지를 새로 고친 후 추가 정보를 & 동의를 관리 다른 새 섹션을 볼 수 있습니다.
1. 관리 동의 제공 링크를 선택하고 Microsoft 365 전역 관리자 자격 증명을 입력한 다음 수락을 선택하여 권한을 부여합니다.
2. Microsoft Entra 테넌트 필드 옆에 있는 검색 단추를 선택합니다.
3. 비즈니스용 OneDrive URL 옆에 있는 검색 단추를 선택합니다.
4. 필드가 채워지면 변경 내용 저장 단추를 다시 선택합니다.
업데이트 단추를 선택하여 설치를 확인합니다. 이 단계에서 오류가 보고되지 않으면 Microsoft 플러그 인이 Microsoft Graph API를 통해 Microsoft 서버와 통신할 수 있습니다.

사용자 및 과정 동기화 구성

Moodle 서버와 Microsoft Entra ID 간에 사용자를 동기화합니다. 환경에 따라 이 단계에서 다른 옵션을 선택할 수 있습니다. 시작하려면 다음을 수행합니다.
1. Microsoft 365 통합 구성 페이지에서 동기화 설정 탭을 선택합니다.
2. 사용자와 Microsoft Entra ID 동기화 설정에서 환경에 적용되는 확인란을 선택합니다. 다음 옵션을 선택해야 합니다.
  ✔ Microsoft Entra ID 사용자에 대한 Moodle에서 계정을 만듭니다. ✔ Microsoft Entra ID 사용자의 Moodle의 모든 계정을 업데이트합니다.
3. 사용자 만들기 제한 섹션에서 Moodle에 동기화된 Microsoft Entra 사용자를 제한하는 필터를 설정할 수 있습니다.
참고

사용자 동기화를 켤 필요는 없습니다. 그러나 Moodle 사용자를 Microsoft 365 계정과 훨씬 쉽게 연결할 수 있습니다.

사용자 동기화는 Microsoft Entra ID 예약된 작업으로 사용자 동기화를 실행하여 수행됩니다.
과정 동기화 섹션에서 과정 동기화 사용자 지정 옵션을 선택하여 기존 Moodle 과정의 일부 또는 전부에 대한 Teams 자동 생성을 켤 수 있습니다.

참고

과정 동기화는 Moodle 과정을 Microsoft Teams 예약 작업으로 동기화를 실행하여 수행됩니다.
변경 내용을 저장합니다.
동기화 구성의 유효성을 검사하려면 처음으로 예약된 작업을 수동으로 실행하고 사이트 관리>서버>작업예약된 작업>으로 이동해야 합니다.
1. 아래로 스크롤하여 Microsoft Entra ID 사용자 동기화 작업을 찾아 지금 실행을 선택합니다.
  1. 그러면 사용자 동기화 옵션에 따라 Microsoft Entra 사용자를 Moodle 사이트로 동기화합니다.
2. 다음으로 , Microsoft Teams에 Moodle 과정 동기화 작업을 찾아 지금 실행을 선택합니다.
  1. 이 작업은 동기화 옵션이 켜진 모든 Moodle 과정에 대한 그룹을 만들고, 팀 소유자 를 코스에서 찾을 수 있는 경우 Teams도 만듭니다.
  2. 또한 이 작업은 과정에 등록된 Moodle 사용자를 소유자 또는 구성원으로 Teams에 동기화합니다.
    1. 팀 소유자는 Moodle 사용자입니다.
      1. 은 Microsoft 365 계정 AND에 연결되어 있습니다.
      2. 이 과정에 등록되어 있고, AND
      3. 에는 local/o365:teamowner 과정 컨텍스트의 기능이 있습니다.
    2. 마찬가지로 팀 구성원 은 Moodle 사용자입니다.
      1. 은 Microsoft 365 계정 AND에 연결되어 있습니다.
      2. 이 과정에 등록되어 있고, AND
      3. 에는 local/o365:teamember 과정 컨텍스트의 기능이 있습니다.
    3. 기본 교사 역할에는 local/o365:teamowner 기능이 있고 기본 학생 역할에는 local/o365:teammember 기능이 있습니다.

참고

예약된 작업은 Moodle Cron에 의해 트리거되며, 자주 실행되도록 구성해야 합니다. 예약된 각 작업에는 사용자 지정할 수 있는 기본 일정이 있을 수 있습니다.

Microsoft Entra ID 작업으로 사용자 동기화의 기본 일정은 1분마다 수행됩니다.
Microsoft Teams에 Moodle 과정 동기화 작업의 기본 일정은 Moodle 서버 기본 표준 시간대의 매일 오전 1시에 수행됩니다.

플러그 인을 설치하고 구성한 후에는 다음을 수행할 수 있습니다.

추가 Moodle 플러그 인 설명서

Moodle의 Microsoft 365 통합 가이드 및 릴리스 정보를 검토하려면 다음 리소스를 참조하세요.

Moodle Docs에 대한 Microsoft 365 통합 설명서.

다음을 통해 공유