학습 관리 시스템을 GitHub 클래스룸에 등록

GitHub Classroom으로 LTI 규격 LMS(학습 관리 시스템)을 구성할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

Organization owners who are admins for a classroom can connect learning management systems to GitHub Classroom.

이 문서의 내용

교실에 LMS 등록하기 관련 정보

LMS를 교실에 연결하려면 LMS 인스턴스의 관리자가 GitHub Classroom을(를) 허용하도록 LMS를 구성한 다음GitHub Classroom에 LMS를 등록하여 OAuth 핸드셰이크를 시작해야 합니다. 관리자가 이 등록 프로세스를 한 번만 수행하면 LMS 인스턴스를 사용하는 모든 교사가 LMS 과정을 교실과 동기화할 수 있습니다. LMS 과정을 교실에 연결하는 방법에 대한 자세한 내용은 학습 관리 시스템 과정을 클래스룸에 연결을(를) 참조하세요.

참고 항목

Google Classroom은 LTI 프로토콜을 사용하지 않으므로 명단을 가져오기 전에 GitHub Classroom에 연결할 필요가 없습니다. 자세한 내용은 학습 관리 시스템 과정을 클래스룸에 연결을(를) 참조하세요.

지원되는 LMS

GitHub Classroom에서는 학습 도구 상호 운용성(LTI) 표준을 구현하는 LMS에 연결할 수 있습니다.

  • LTI 버전 1.3
  • LTI 이점

LTI를 사용하면 정보를 안전하게 유지할 수 있습니다. LTI는 업계 표준 프로토콜이며 GitHub 클래스룸의 LTI 사용은 IMS(교육 관리 시스템) 글로벌 학습 컨소시엄에 의해 인증됩니다. 자세한 내용은 IMS 글로벌 학습 컨소시엄 웹 사이트에서 학습 도구 상호 운용성 및 IMS 글로벌 학습 컨소시엄 정보를 참조하세요.

GitHub는 다음 LMS에서 GitHub Classroom으로 명단 데이터의 등록, 연결, 가져오기를 테스트하여 확인했습니다.

  • Blackboard(커뮤니티 지원 옵션)
  • 캔버스
  • Moodle
  • Sakai
  • Google 클래스룸

참고 항목

LTI 1.3을 구현하는 다른 LMS도 GitHub Classroom에서 작동할 수 있지만 아직 확인되지 않았습니다. LMS 관리자는 개인 정보 및 단추 배치에 대한 사용자 지정 설정을 구성해야 할 수 있으며, LMS에서 GitHub Classroom로 시작하는 방법에 대한 문서를 교사에게 제공해야 할 수 있습니다.

Google Classroom은 LTI 프로토콜을 사용하지 않으므로 명단을 가져오기 전에 GitHub Classroom에 연결할 필요가 없습니다. 자세한 내용은 학습 관리 시스템 과정을 클래스룸에 연결을(를) 참조하세요.

GitHub Classroom용 Blackboard 구성

GitHub Classroom에 Blackboard 설치를 등록하면 교사가 수업에 명단 데이터를 가져올 수 있습니다. Blackboard에 대한 자세한 내용은 Blackboard 웹 사이트를 참조하세요.

1단계. Anthology Developer Portal에서 GitHub Classroom 개발자 키 등록

  1. Anthology Developer Portal에 로그인하세요.

  2. My Application 페이지에서 plus sign을 클릭하세요.

  3. 드롭다운 메뉴에서 Manual Registration을 클릭하세요.

  4. "Register a new application" 구성 화면에서 필드를 다음 값으로 설정합니다.

    새 앱 구성 필드값 또는 설정
    애플리케이션 이름GitHub Classroom

    어떤 이름이든 사용할 수 있으며, 관리자에게만 표시됩니다.
    설명Sync Blackboard course roster to GitHub Classroom (또는 유사한 항목)
    Domain(s)classroom.github.com
    그룹기본값을 그대로 두거나 기관의 필요에 따라 변경합니다.
    My Integration supports LTI 1.3플래그를 활성화합니다.
    Login Initiation URLhttps://classroom.github.com/lti1p3/openid-connect/auth
    Tool Redirect URL(s)https://classroom.github.com/lti1p3/openid-connect/redirect,https://classroom.github.com/context-link
    Tool JWKS URLhttps://classroom.github.com/.well-known/jwks.json
    Signing Algorithm 드롭다운RS256
    사용자 지정 매개 변수비워 둡니다.

  5. Register Application을 클릭합니다.

  6. 개발자 포털에는 Blackboard 인스턴스와 아래의 GitHub Classroom에 인스턴스를 등록하는 다음 단계에서 입력해야 하는 중요한 정보가 포함된 화면이 표시됩니다. 이 정보를 안전한 곳에 보관하고 Done을 클릭하세요.

  7. "My Applications" 페이지의 표에서 GitHub Classroom 애플리케이션 행의 오른쪽에 있는 세 개의 점을 클릭한 다음, 드롭다운 메뉴에서 Manage Placements를 클릭하세요.

  8. plus sign을 클릭합니다.

  9. "Register a new placement" 구성 화면에서 필드를 다음 값으로 설정합니다.

    새 배치 구성 필드값 또는 설정
    Placement NameGitHub Classroom

    어떤 이름도 사용할 수 있지만 다른 이름으로 설정하면 교사에게 전달되어야 합니다.
    설명Sync Blackboard course roster to GitHub Classroom (또는 유사한 항목)
    Type 드롭다운과정 도구
    Allow students access이 플래그는 활성화하지 마세요.
    Launch in new window해당 사용자 환경을 제공하고 싶지 않다면 이 플래그를 활성화하지 마세요.
    Target link URIhttps://classroom.github.com/context-link
    Icon URL비워 두거나 아이콘에 대한 정적 URL을 제공합니다. 필요한 경우 나중에 Blackboard에서 수동으로 업로드할 수 있습니다.
    사용자 지정 매개 변수비워 둡니다.

  10. Register Placement를 클릭하세요.

2단계. Blackboard에서 GitHub Classroom 개발자 키 등록

  1. Blackboard 인스턴스에 로그인합니다.
  2. 홈페이지의 왼쪽 사이드바에서 Admin, LTI Tool Providers를 차례로 클릭합니다.
  3. "LTI Tool Providers" 페이지에서 Register LTI 1.3/Advantage Tool을 클릭합니다.
  4. 개발자 포털에서 가져온 Client ID / Application ID를 삽입하고 Submit을 클릭합니다.
  5. Blackboard는 모든 애플리케이션 데이터를 표시합니다. 이 페이지에서 다음을 확인하세요.
    1. Tool Status가 Approved 상태인지 확인합니다.
    2. "Role in Course", "Name", "Email Address"에 User Fields to be Sent 플래그가 활성화되어 있는지 확인하세요.
    3. Allow mark service access 라디오 단추가 "No"로 설정되어 있는지 확인합니다. 이 옵션을 사용하려면 Admin Panel에서 LTI Tool Providers로 이동합니다.
      • Manage Global Properties 선택
      • Creation of Tool Provider Links에서 “Allow links to any tool provider, but require approval for each new provider” 라디오 단추 선택
    4. Allow Membership Service Access 라디오 단추가 "Yes"로 설정되어 있는지 확인합니다.
  6. 제출을 클릭합니다.

3단계 GitHub Classroom에 개발자 키 등록

  1. https://classroom.github.com/register-lms(으)로 이동합니다.

  2. 다음 정보를 입력합니다.

    • "LMS Type"의 드롭다운 메뉴에서 "Other" 선택
    • "발급사 식별자": https://blackboard.com
    • "Domain": Blackboard 인스턴스의 기본 URL
    • "Client ID": Anthology Developer Portal에서 등록한 앱의 "Client ID" / "Application ID"
    • "OIDC Initiation URL": Anthology Developer Portal에서 등록한 앱의 "OIDC auth request endpoint"
    • "OAuth 2.0 Token Retrieval URL": Anthology Developer Portal에서 등록한 앱의 "Auth token endpoint"
    • "Key Set URL": Anthology Developer Portal에서 등록한 앱의 "Public keyset URL"

  3. 등록을 클릭합니다.

  4. 화면 맨 위에 "성공적으로 등록된 LMS" 배너가 표시되어야 합니다. 즉, LMS 인스턴스를 등록했으며 교사는 이제 교실을 연결할 수 있습니다.

GitHub Classroom용 Canvas 구성

GitHub Classroom에 Canvas 설치를 등록하여 교사가 수업에 명단 데이터를 가져올 수 있습니다. Canvas에 대한 자세한 내용은 Canvas 웹 사이트를 참조하세요.

1. Canvas에서 GitHub Classroom 개발자 키 등록

  1. Canvas에 로그인합니다.

  2. 홈페이지의 왼쪽 사이드바에서 관리자를 클릭한 다음 사이트 관리자를 클릭합니다.

  3. 개발자 키를 클릭합니다.

  4. "개발자 키"에서 + 개발자 키 단추를 클릭한 다음 드롭다운 메뉴에서 + LTI 키를 선택합니다.

  5. "키 설정" 구성 화면에서 필드를 다음 값으로 설정합니다.

    Canvas 앱 구성의 필드값 또는 설정
    방법Manual Entry
    제목GitHub Classroom

    참고: 어떤 이름도 사용할 수 있지만 다른 이름으로 설정하면 교사에게 전달되어야 합니다.
    설명Sync Canvas course rosters to GitHub Classroom (또는 유사한 항목)
    대상 링크 URIhttps://classroom.github.com/context-link
    OpenID Connect 초기화 URLhttps://classroom.github.com/lti1p3/openid-connect/auth
    JWK 메서드Public JWK URL
    공개 JWK URLhttps://classroom.github.com/.well-known/jwks.json
    리디렉션 URIhttps://classroom.github.com/lti1p3/openid-connect/redirect
    LTI Advantage Services 드롭다운"도구가 설치된 컨텍스트와 연결된 사용자 데이터를 검색할 수 있음" 확인란을 선택합니다.
    추가 설정 드롭다운"개인 정보 수준"에서,Public(을)를 선택합니다.
    배치Course Settings Sub Navigation(을)를 선택합니다.

    참고: 배치를 다른 항목으로 설정하는 경우 교사에게 전달되어야 합니다. 이 설명서에서는 해당 설정을 단추의 배치로 예상합니다.

  6. 저장을 클릭합니다.

  7. "개발자 키" 페이지의 표에서 GitHub 클래스룸 개발자 키 행의 "세부 정보" 열에 있는 클라이언트 ID 값을 기록해 둡니다. 설치를 완료하려면 교사에게 전달되어야 합니다.

  8. "개발자 키" 페이지의 테이블에서 "상태" 열 아래에서 키의 상태를 "켜기"로 전환합니다.

2. GitHub Classroom에 개발자 키 등록

  1. https://classroom.github.com/register-lms(으)로 이동합니다.

  2. 다음 정보를 입력합니다.

    • "LMS 유형"의 드롭다운 메뉴에서 "캔버스"를 선택합니다.
    • "발급사 식별자": https://canvas.instructure.com
    • "도메인": Canvas 인스턴스의 기준 URL
    • "클라이언트 ID": 만든 개발자 키의 "세부 정보"에 있는 "클라이언트 ID"
    • "OIDC 권한 부여 엔드포인트": 마지막에 /api/lti/authorize_redirect(이)가 추가된 Canvas 인스턴스의 기준 URL입니다.
    • "OAuth 2.0 토큰 검색 URL": 마지막에 /login/oauth2/token(이)가 추가된 Canvas 인스턴스의 기준 URL입니다.
    • "키 집합 URL": 마지막에 /api/lti/security/jwks(이)가 추가된 Canvas 인스턴스의 기준 URL입니다.

  3. 등록을 클릭합니다.

  4. 화면 맨 위에 "성공적으로 등록된 LMS" 배너가 표시되어야 합니다. 즉, LMS 인스턴스를 등록했으며 교사는 이제 교실을 연결할 수 있습니다.

GitHub Classroom용 Moodle 구성

GitHub Classroom에 Moodle 설치를 등록하여 교사가 수업에 명단 데이터를 가져올 수 있습니다. Moodle에 대한 자세한 내용은 Moodle 웹 사이트를 참조하세요.

Moodle 버전 3.0 이상을 사용해야 합니다.

1. Moodle에서 LTI 도구로 게시 사용

  1. Moodle에 로그인합니다.
  2. 최상위 메뉴에서 "사이트 관리" 탭을 클릭합니다.
  3. "사이트 관리" 페이지에서 "플러그인" 탭을 클릭한 다음, "인증" 섹션까지 아래로 스크롤하여 인증 관리를 클릭합니다.
  4. "LTI" 필드 옆에 있는 토글 단추를 클릭하여 LTI를 사용하도록 설정합니다.
  5. "플러그인" 탭을 다시 클릭한 다음 아래로 스크롤하여 "등록"을 찾아 등록 플러그인 관리를 클릭합니다.
  6. "LTI 도구로 게시" 필드 옆에 있는 토글 단추를 클릭하여 LTI 도구로 게시를 사용하도록 설정합니다.
  7. 최상위 메뉴의 "사이트 관리" 탭을 클릭하여 "사이트 관리" 페이지로 돌아가서 "보안" 섹션을 찾아 아래로 스크롤하고 HTTP 보안을 클릭합니다.
  8. "프레임 임베드 허용" 옆에 있는 확인란을 선택하여 프레임 임베드를 사용하도록 설정한 다음, 변경 내용 저장을 클릭합니다.

2. GitHub Classroom을(를) 외부 도구로 등록

  1. 최상위 메뉴의 "사이트 관리" 탭을 클릭하여 Moodle의 "사이트 관리" 페이지로 돌아갑니다.

  2. "플러그인" 탭을 클릭한 다음 "활동 모듈" 섹션 옆에 있는 "외부 도구"에서 도구 관리를 클릭합니다.

  3. 수동으로 도구 구성을 클릭합니다.

  4. 필드에 다음 값을 입력합니다.

    Moodle 앱 구성의 필드값 또는 설정
    도구 이름GitHub Classroom

    참고: 어떤 이름도 사용할 수 있지만 다른 이름으로 설정하면 교사에게 전달되어야 합니다.
    도구 URLhttps://classroom.github.com
    LTI 버전LTI 1.3
    공개 키 토큰Keyset URL
    공개 키 집합https://classroom.github.com/.well-known/jwks.json
    로그인 URL 초기화https://classroom.github.com/lti1p3/openid-connect/auth
    리디렉션 URIhttps://classroom.github.com/lti1p3/openid-connect/redirect
    기본 시작 컨테이너New window

  5. 딥 링크 설정 지원(콘텐츠 항목 메시지) 확인란을 선택합니다.

  6. "IMS LTI 이름 및 역할 프로비전" 옆의 "서비스" 드롭다운을 선택하고, 이 드롭다운 메뉴에서 "이 서비스를 사용하여 멤버의 정보를 개인 정보 설정에 따라 검색"을 클릭합니다.

  7. "프라이버시" 드롭다운에서 "도구로 시작 관리자 이름 공유"를 "항상"으로 설정하고 "도구와 시작 관리자의 이메일 공유"를 "항상"으로 설정합니다.

  8. 변경 내용 저장을 클릭합니다.

  9. 이제 GitHub 클래스룸이 외부 도구로 등록되었습니다. "도구"의 "GitHub 클래스룸" 상자에서 메뉴 아이콘을 클릭하여 "도구 구성 세부 정보" 화면을 확인합니다. 해당 화면에는 아래 GitHub Classroom에 인스턴스를 등록하는 마지막 단계에서 입력해야 하는 중요한 정보가 포함되어 있습니다.

3. GitHub Classroom에 Moodle 인스턴스 등록

  1. https://classroom.github.com/register-lms(으)로 이동합니다.

  2. 다음 정보를 입력합니다.

    • "LMS 유형"의 드롭다운 메뉴에서 "Moodle"을 선택합니다.
    • "발급사 식별자": Moodle에서 만든 외부 도구의 "도구 구성 세부 정보"에 있는 "플랫폼 ID"
    • "도메인": Moodle 인스턴스의 기준 URL
    • "클라이언트 ID": Moodle에서 만든 외부 도구의 "도구 구성 세부 정보"에 있는 "클라이언트 ID"
    • "인증 요청 URL": Moodle에서 만든 외부 도구의 "도구 구성 세부 정보"에 있는 "인증 요청 URL"
    • "액세스 토큰 URL": Moodle에서 만든 외부 도구의 "도구 구성 세부 정보"에 있는 "액세스 토큰 URL"
    • "키 집합 토큰 URL": Moodle에서 만든 외부 도구의 "도구 구성 세부 정보"에 있는 "공개 키 집합 URL"

  3. 등록을 클릭합니다.

  4. 화면 맨 위에 "성공적으로 등록된 LMS" 배너가 표시되어야 합니다. 즉, LMS 인스턴스를 등록했으며 교사는 이제 교실을 연결할 수 있습니다.

GitHub Classroom용 Sakai 구성

1. GitHub Classroom을(를) 외부 도구로 등록

  1. Sakai로 이동하여 로그인합니다.

  2. "관리자용 작업 영역"으로 이동하고 왼쪽 사이드바에서 외부 도구를 선택합니다.

  3. LTI 1.x 도구 설치를 클릭합니다.

  4. 필드에 다음 값을 입력합니다.

    Sakai 앱 구성의 필드값 또는 설정
    도구 이름GitHub 클래스룸 - [과정 이름]

    참고: 어떤 이름도 사용할 수 있지만 다른 이름으로 설정하면 교사에게 전달되어야 합니다.
    단추 텍스트 (도구 메뉴의 텍스트)GitHub Classroom을 시작하기 위해 단추에서 교사가 볼 수 있는 내용입니다. 예를 들어 값은 sync일 수 있습니다.
    URL 실행https://classroom.github.com/context-link
    외부 도구에 사용자 이름 보내기이 확인란을 선택합니다.
    외부 도구에 명단 제공이 확인란을 선택합니다.
    도구에서 LTI 1.3을 지원이 확인란을 선택합니다.
    LTI 1.3 도구 키 집합 URLhttps://classroom.github.com/.well-known/jwks.json
    LTI 1.3 도구 OpenID Connect/초기화 엔드포인트https://classroom.github.com/lti1p3/openid-connect/auth
    LTI 1.3 도구 리디렉션 엔드포인트https://classroom.github.com/lti1p3/openid-connect/redirect

  5. 제출 시 Sakai는 GitHub Classroom에 Sakai 인스턴스를 등록하는 데 필요한 정보를 표시합니다.

2. GitHub Classroom에 Sakai 인스턴스 등록

  1. https://classroom.github.com/register-lms(으)로 이동합니다.

  2. 다음 정보를 입력합니다.

    • "LMS 유형"의 드롭다운 메뉴에서 "Sakai"를 선택합니다.
    • "LTI 1.3 플랫폼 발급사": Sakai에서 제공하는 "LTI 1.3 플랫폼 발급사" 필드
    • "도메인": Sakai 인스턴스의 기준 URL
    • "LTI 1.3 클라이언트 ID": Sakai에서 제공하는 "LTI 1.3 클라이언트 ID" 필드
    • "LTI 1.3 플랫폼 OIDC 인증 URL": Sakai에서 제공하는 "LTI 1.3 플랫폼 OIDC 인증 URL" 필드
    • "LTI 1.3 플랫폼 OAuth2 전달자 토큰 검색 URL": Sakai에서 제공한 "LTI 1.3 플랫폼 OAuth2 전달자 토큰 검색 URL" 필드
    • "LTI 1.3 Platform OAuth2 잘 알려진/KeySet URL": Sakai에서 제공하는 "LTI 1.3 플랫폼 OAuth2 잘 알려진/KeySet URL" 필드

  3. 등록을 클릭합니다.

  4. 화면 맨 위에 "성공적으로 등록된 LMS" 배너가 표시되어야 합니다. 즉, LMS 인스턴스를 등록했으며 교사는 이제 교실을 연결할 수 있습니다.