Microsoft Teams와 Moodle 통합 설치
전 세계에서 가장 인기 있는 오픈 소스 LMS(학습 관리 시스템)인 Moodle은 이제 Microsoft Teams와 통합되었습니다! 이 통합은 교사와 학생이 Moodle 과정을 중심으로 공동 작업하고, 성적 및 과제에 대해 질문하고, Teams 내에서 알림으로 업데이트된 상태를 유지하는 데 도움이 됩니다!
IT 관리자가 이 통합을 쉽게 설정할 수 있도록 오픈 소스 Moodle 플러그 인을 다음 기능으로 업데이트했습니다.
- Microsoft Entra ID를 사용하여 Moodle 서버의 자동 등록
- Azure에 Moodle Assistant 봇을 원클릭으로 배포합니다.
- 팀의 자동 프로비전 및 모든 팀 등록의 자동 동기화 또는 Moodle 과정을 선택합니다.
- 각 동기화된 팀에 Moodle 탭 및 Moodle Assistant 봇을 자동으로 설치합니다. (출시 예정)
- Moodle 앱을 프라이빗 Teams 앱 스토어에 원클릭으로 게시합니다. (출시 예정)
통합에서 제공하는 기능에 대한 자세한 내용은 Microsoft Teams와 Moodle 통합 설치를 참조하세요.
필수 구성 요소
이 애플리케이션을 설치하고 구성하려면 다음이 필요합니다.
- Moodle 관리자 자격 증명
- Microsoft Entra 관리자 자격 증명
- 에서 새 리소스를 만들 수 있는 Azure 구독
1단계: Moodle 플러그 인 설치
Microsoft Teams의 Moodle 통합은 오픈 소스 Moodle 플러그 인 집합에 의해 구동됩니다. Moodle 서버에 플러그 인을 설치하려면 다음을 수행합니다.
- 먼저 Moodle 플러그 인 집합 을 다운로드하여 로컬 컴퓨터에 저장합니다. 버전 3.5 이상을 사용해야 합니다.
- local_o365 플러그 인을 설치하면 auth_oidc 및 boost_o365Teams 플러그 인도 설치됩니다.
- Moodle 서버에 관리자 권한으로 로그인하고 왼쪽 탐색 패널에서 사이트 관리를 선택합니다.
- 플러그 인 탭을 선택한 다음 플러그 인 설치를 선택합니다.
- ZIP 파일에서 플러그 인 설치 섹션에서 파일 선택 단추를 선택합니다 .
- 왼쪽 탐색 영역에서 파일 업로드 옵션을 선택하고 위에서 다운로드한 파일을 찾아 이 파일 업로드를 선택합니다.
- 왼쪽 탐색 패널에서 사이트 관리 옵션을 다시 선택하여 관리 대시보드로 돌아갑니다. 로컬 플러그 인까지 아래로 스크롤하여 Microsoft Office 365 통합 링크를 선택합니다. 이 구성 페이지는 이 프로세스의 나머지 부분 전체에서 사용할 수 있으므로 별도의 브라우저 탭에서 열어 두세요.
Moodle 플러그 인을 설치하는 방법에 대한 자세한 내용은 Moodle 설명서에서 확인할 수 있습니다.
중요 참고 사항: Microsoft 365 또는 Office 365 Moodle 플러그 인 구성 페이지를 별도의 브라우저 탭에서 열어 두면 이 프로세스 전체에서 이 페이지 세트로 돌아갑니다.
Moodle 사이트가 아직 없나요? Azure에서 Moodle 인스턴스를 신속하게 배포하고 필요에 맞게 사용자 지정할 수 있는 Azure의 Moodle 리포지토리 를 확인해 볼 수 있습니다.
2단계: Microsoft 365 또는 Office 365 플러그 인과 Microsoft Entra ID 간의 연결 구성
다음으로 Microsoft Entra ID에 Moodle을 애플리케이션으로 등록해야 합니다. 이 프로세스를 완료하는 데 도움이 되는 PowerShell 스크립트를 제공했습니다. PowerShell 스크립트는 Moodle 플러그 인에서 사용할 Microsoft 365 또는 Office 365 조직에 대한 새 Microsoft Entra 애플리케이션을 프로비전합니다. 스크립트는 Microsoft 365 또는 Office 365 테넌트용 앱을 프로비전하고, 프로비전된 앱에 필요한 모든 회신 URL 및 권한을 설정하고, AppID 및 키를 반환합니다. Moodle 플러그 인 설정 페이지에서 생성된 AppID 및 키를 사용하여 Microsoft Entra ID로 Moodle 서버를 구성할 수 있습니다. PowerShell 스크립트가 자동화하는 자세한 수동 단계를 보려면 플러그 인에 대한 전체 설명서에서 찾을 수 있습니다.
Microsoft Teams 정보 흐름에 대한 Moodle 탭
- Microsoft 365 또는 Office 365 통합 플러그 인 페이지에서 설정 탭을 선택합니다.
- PowerShell 스크립트 다운로드 단추를 선택하고 로컬 컴퓨터에 저장합니다.
- ZIP 파일에서 PowerShell 스크립트를 준비해야 합니다. 이렇게 하려면 다음을 수행합니다.
- 파일을 다운로드하고 추출합니다
Moodle-AzureAD-Powershell.zip
. - 추출된 폴더를 엽니다.
- 파일을 마우스 오른쪽 단추로
Moodle-AzureAD-Script.ps1
클릭하고 속성을 선택합니다. - 속성 창의 일반 탭 아래에서 아래쪽의
Unblock
보안 특성 옆에 있는 확인란을 선택합니다. - 확인을 선택합니다.
- 추출된 폴더의 디렉터리 경로를 복사합니다.
- 파일을 다운로드하고 추출합니다
- 다음으로 관리자 권한으로 PowerShell을 실행합니다.
- 시작을 선택합니다.
- PowerShell을 입력합니다.
- Windows PowerShell을 마우스 오른쪽 단추로 클릭합니다.
- "관리자 권한으로 실행"을 선택합니다.
- 디렉터리에 대한 경로는 어디에 있는지
...\...
를 입력하여cd ...\...\Moodle-AzureAD-Powershell
압축되지 않은 디렉터리로 이동합니다. - 다음을 통해 PowerShell 스크립트를 실행합니다.
- 를 입력합니다
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
. - 를 입력합니다
.\Moodle-AzureAD-Script.ps1
. - 팝업 창에서 Microsoft 365 또는 Office 365 관리자 계정에 로그인합니다.
- Microsoft Entra 애플리케이션의 이름(예: Moodle/Moodle 플러그 인)을 입력합니다.
- Moodle 서버의 URL을 입력합니다.
- 스크립트에서 생성된 애플리케이션 ID 및 애플리케이션 키를 복사하고 저장합니다.
- 를 입력합니다
- 다음으로 Moodle 플러그 인에 ID 및 키를 추가해야 합니다. 플러그 인 관리 페이지로 돌아갑니다(사이트 관리 > 플러그 인 > Microsoft 365 통합).
- 설정 탭에서 이전에 복사한 애플리케이션 ID 및 애플리케이션 키를 추가한 다음 변경 내용 저장을 선택합니다.
- 페이지가 새로 고쳐지면 이제 연결 방법 선택 섹션이 표시됩니다. 기본값으로 레이블이 지정된 확인란을 선택한 다음 변경 내용 저장을 다시 선택합니다.
- 페이지가 새로 고쳐지면 추가 정보를 & 다른 새 섹션 관리자 동의가 표시됩니다.
- 관리자 동의 제공 링크를 선택하고 Microsoft 365 또는 Office 365 전역 관리자 자격 증명을 입력한 다음 수락을 선택하여 사용 권한을 부여합니다.
- Microsoft Entra 테넌트 필드 옆에 있는 검색 단추를 선택합니다.
- 비즈니스용 OneDrive URL 옆에 있는 검색 단추를 선택합니다.
- 필드가 채워지면 변경 내용 저장 단추를 다시 선택합니다.
- 업데이트 단추를 선택하여 설치를 확인한 다음 변경 내용을 저장합니다.
- 다음으로 Moodle 서버와 Microsoft Entra ID 간에 사용자를 동기화해야 합니다. 환경에 따라 이 단계에서 다른 옵션을 선택할 수 있습니다. 여기에서 설정한 구성은 모든 항목을 동기화 상태로 유지하기 위해 각 Moodle cron 실행(일반적으로 하루에 한 번)으로 실행됩니다. 시작하려면 다음을 수행합니다.
- 동기화 설정 탭으로 전환
-
사용자와 Microsoft Entra ID 동기화 섹션에서 환경에 적용되는 확인란을 선택합니다. 일반적으로 다음 이상을 선택합니다.
- Microsoft Entra ID의 사용자에 대한 Moodle에서 계정 만들기
- Microsoft Entra ID의 사용자에 대한 Moodle의 모든 계정 업데이트
- 사용자 만들기 제한 섹션에서 Moodle에 동기화될 Microsoft Entra 사용자를 제한하는 필터를 설정할 수 있습니다.
- 사용자 필드 매핑 섹션에서는 Microsoft Entra ID를 Moodle 사용자 프로필 필드 매핑으로 사용자 지정할 수 있습니다.
- Teams 동기화 섹션에서 기존 Moodle 과정의 일부 또는 전부에 대한 그룹(즉, Teams)을 자동으로 만들도록 선택할 수 있습니다.
- cron 작업의 유효성을 검사하고 첫 번째 실행을 원하는 경우 수동으로 실행하려면 사용자와 Microsoft Entra ID 동기화 섹션에서 예약된 작업 관리 페이지 링크를 선택합니다. 그러면 예약된 작업 페이지로 이동합니다.
- 아래로 스크롤하여 Microsoft Entra ID 작업으로 사용자 동기화 작업을 찾아 지금 실행을 선택합니다.
- 기존 과정을 기반으로 그룹을 만들기로 선택한 경우 Office 365에서 사용자 그룹 만들기 작업을 실행할 수도 있습니다.
- 플러그 인 관리 페이지(사이트 관리 > 플러그 인 > Microsoft 365 통합)로 돌아가 서 Teams 설정 페이지를 선택합니다. Teams 앱 통합을 사용하도록 몇 가지 보안 설정을 구성해야 합니다.
- OpenID Connect를 사용하도록 설정하려면 인증 관리 링크를 클릭하고, 회색으로 표시된 경우 OpenId Connect 줄에서 눈 아이콘을 클릭합니다.
- 다음으로 프레임 포함을 사용하도록 설정해야 합니다. HTTP 보안 링크를 선택한 다음 프레임 포함 허용 옆의 확인란을 선택합니다.
- 다음 단계는 Moodle API 기능을 사용하도록 설정하는 웹 서비스를 사용하도록 설정하는 것입니다. 고급 기능 링크를 클릭한 다음 웹 서비스 사용 옆의 확인란이 선택되어 있는지 확인합니다.
- 마지막으로 Microsoft 365 또는 Office 365에 대한 외부 서비스를 사용하도록 설정해야 합니다.
외부 서비스 링크를 클릭한 다음 다음을 수행합니다.
- Moodle Office 365 웹 서비스 행에서 편집을 클릭합니다.
- 사용 옆에 있는 확인란을 표시한 다음 변경 내용 저장을 클릭합니다.
- 다음으로 인증된 사용자 권한을 편집하여 웹 서비스 토큰을 만들 수 있도록 해야 합니다. 편집 역할 '인증된 사용자' 링크를 클릭합니다. 아래로 스크롤하여 웹 서비스 토큰 만들기 기능을 찾고 허용 확인란을 표시합니다.
3단계: Azure에 Moodle Assistant 봇 배포
Microsoft Teams용 무료 Moodle Assistant 봇을 사용하면 교사와 학생이 Moodle의 과정, 과제, 성적 및 기타 정보에 대한 질문에 답변할 수 있습니다. 또한 봇은 Teams 내에서 학생과 교사에게 Moodle 알림을 보냅니다. 이 봇은 Microsoft에서 유지 관리하는 오픈 소스 프로젝트이며 GitHub에서 사용할 수 있습니다.
참고
이 섹션에서는 Azure 구독에 리소스를 배포하고 모든 리소스는 무료 계층을 사용하여 구성됩니다. 봇의 사용량에 따라 이러한 리소스의 크기를 조정해야 할 수 있습니다. 봇 없이 Moodle 탭만 사용하려면 4단계로 건너뜁니다.
Moodle 봇 정보 흐름
봇을 설치하려면 먼저 Microsoft ID 플랫폼에 등록해야 합니다. 이렇게 하면 봇이 Microsoft 엔드포인트에 대해 인증할 수 있습니다. 봇을 등록하려면 다음을 수행합니다.
- 플러그 인 관리 페이지(사이트 관리 > 플러그 인 > Microsoft 365 통합)로 돌아가 서 Teams 설정 탭을 선택합니다.
- Microsoft 애플리케이션 등록 포털 링크를 클릭하고 Microsoft ID로 로그인합니다.
- 앱의 이름(예: MoodleBot)을 입력하고 만들기 단추를 클릭합니다.
- 애플리케이션 ID를 복사하여 팀 설정 페이지의 봇 애플리케이션 ID 필드에 붙여넣습니다.
- 새 암호 생성 단추를 클릭합니다. 생성된 암호를 복사하여 팀 설정 페이지의 봇 애플리케이션 암호 필드에 붙여넣습니다.
- 양식의 아래쪽으로 스크롤하고 변경 내용 저장을 클릭합니다.
이제 애플리케이션 ID 및 암호를 생성했으므로 이제 Azure에 봇을 배포해야 합니다. Azure에 배포 단추를 클릭하고 필요한 정보로 양식을 작성합니다(봇 애플리케이션 ID, 봇 애플리케이션 암호 및 Moodle 비밀은 팀 설정 페이지에 있고 Azure 정보는 설치 페이지에 있습니다). 양식을 작성했으면 확인란을 클릭하여 사용 약관에 동의한 다음 구매 단추를 클릭합니다(모든 Azure 리소스는 무료 계층에 배포됨).
리소스가 Azure에 배포가 완료되면 메시징 엔드포인트를 사용하여 Moodle 플러그 인을 구성해야 합니다. 먼저 Azure의 봇에서 엔드포인트를 가져와야 합니다. 이렇게 하려면 다음을 수행합니다.
- 아직 로그인하지 않은 경우 Azure Portal에 로그인합니다.
- 왼쪽 창에서 리소스 그룹을 선택합니다.
- 목록에서 봇을 배포하는 동안 방금 사용(또는 만든) 리소스 그룹을 선택합니다.
- 그룹의 리소스 목록에서 WebApp Bot 리소스를 선택합니다.
- 개요 섹션에서 메시징 엔드포인트를 복사합니다.
- Moodle에서 Moodle 플러그 인의 팀 설정 페이지를 엽니다.
-
봇 엔드포인트 필드에 방금 복사한 URL을 붙여넣고 메시지 단어를 웹후크로 변경합니다. 이제 URL이 다음과 같이 표시됩니다.
https://botname.azurewebsites.net/api/webhook
- 변경 내용 저장을 클릭합니다.
- 변경 내용이 저장되면 팀 설정 탭으로 돌아가 서 매니페스트 파일 다운로드 단추를 클릭하고 매니페스트 패키지를 컴퓨터에 저장합니다(다음 섹션에서 사용).
4단계: Microsoft Teams 앱 배포
이제 봇을 Azure에 배포하고 Moodle 서버와 통신하도록 구성했으므로 이제 Microsoft Teams 앱을 배포해야 합니다. 이렇게 하려면 이전 단계의 Moodle 플러그 인 팀 설정 페이지에서 다운로드한 매니페스트 파일을 로드합니다.
앱을 설치하려면 외부 앱 및 앱의 사이드로드가 사용하도록 설정되어 있는지 확인해야 합니다. 이렇게 하려면 다음 단계를 수행할 수 있습니다. 외부 앱을 사용하도록 설정했으면 아래 단계에 따라 앱을 배포할 수 있습니다.
- Microsoft Teams를 엽니다.
- 탐색 모음의 왼쪽 아래에 있는 스토어 아이콘을 클릭합니다.
- 옵션 목록에서 사용자 지정 앱 업로드 링크를 클릭합니다. 참고: 전역 관리로 로그인한 경우 조직의 앱 스토어에 앱을 업로드할 수 있는 옵션이 있습니다. 그렇지 않으면 소속된 Teams에 대해서만 앱을 로드할 수 있습니다("사이드로드").
-
manifest.zip
이전에 다운로드한 패키지를 선택하고 저장을 클릭합니다. 매니페스트 패키지를 아직 다운로드하지 않은 경우 Moodle의 플러그 인 구성 페이지의 팀 설정 탭에서 다운로드할 수 있습니다.
이제 앱이 설치되었으므로 액세스할 수 있는 모든 채널에 탭을 추가할 수 있습니다. 이렇게 하려면 채널로 이동하여 기호를 + 클릭하고 목록에서 앱을 선택합니다. 프롬프트에 따라 Moodle 과정 탭을 채널에 추가합니다.
그거에요! 이제 사용자와 팀이 Microsoft Teams에서 직접 Moodle 과정 작업을 시작할 수 있습니다.
기능 요청 또는 피드백을 공유하려면 피드백 포털을 방문하세요.
참고
Microsoft는 2021년에 제품별로 UserVoice에서 자체 고객 피드백 솔루션으로 전환할 예정입니다. 자세히 알아보기.