IMS 학습 도구 상호운용성 회원 서비스

발행일	2016년 5월 24일 (한국어 번역 2016년 12월 30일)
이전버전	http//www.imsglobal.org/specs/ltimemv1p0

지적재산권 및 배포 관련 공지

이 표준의 사용자는 표준을 실행하면서 알게 되는 관련 특허 혹은 지적재산권 침해 가능성, 코멘트와 함께 문서로 제공해야 합니다. IMS는 이 문서에 서술된 기술의 적용 혹은 사용과 관련 있을 수 있는 지적재산권이나 기타 권리의 유효성, 범위 혹은 그러한 권리 아래에서 유효 또는 무효할 수 있는 라이선스의 한도 범위에 대하여 어떤 관점도 취하지 않으며, 그러한 권리를 파악하려고 노력했다는 사실 또한 표현하지 않습니다. IMS 표준 상의 권리에 대한 IMS의 절차 관련 정보는 IMS 지적재산권 웹 페이지에 나와 있습니다: /imsipr_policyFinal.pdf.

이 표준을 제품 혹은 서비스 개발에 이용하려면 IMS 웹사이트: /license.html상의 IMS 라이선스 규정에 따라야 합니다. 제안요청서(RFP, Request For Proposals) 제작 시누구나 필요에 따라 이 문서의 일부를 발췌하여 사용할 수 있습니다. 위의 제한적 사용 허가는 영구적이며 IMS나 그 상속인 혹은 양수인 등에 의해 취소되지 않습니다.

본 표준은 어떠한 보증도 하지 않으며, 특히 침해행위 없음에 대한 그 어떤 명시적 보증도 하지 않습니다. 이 표준의 사용은 전적으로 실행자 자신의 책임으로 이루어져야 하며, 컨소시엄 및 그 회원이나 제출자 등은 실행자 또는 제 3자가 이 설명서 사용으로 인해 직접 혹은 간접적으로 받는 그 어떤 성격의 피해에 대해서도 책임지지 않습니다.

상표 정보: /copyright.html

문서 명: IMS Global 학습 도구 상호운용성 회원 서비스 v1.0 최종 배포

배포일: 2016년 5월 24일

1 서론

1.1 개요

회원 서비스는 IMS 학습 정보 서비스(LIS) [LIS, 11]와 W3C 조직 온톨로지[W3C, 14 ORG]를 기반으로 합니다. 조직 내에서 사용자의 역할에 대한 데이터에 대한 액세스를 제공하는 것과 관련이 있으며, 코스는 조직의 한 예입니다. 따라서 이 서비스의 가장 공통적인 목적은 코스 명단 (등록 목록)을 제공하는 것입니다.

1.2 이름 명

1.2.1 조직

조직은 공통된 목적이나 특정 이유로 그룹으로 조직된 사람들의 모임입니다. 조직은 계층적 구조의 일부일 수 있습니다.

1.2.2 역할

한 사람이 조직 내에서 갖는 참여 유형입니다. 코스의 경우 일반적인 역할은 강사, 교수 보조 및 학습자입니다.

1.2.3 회원

하나 이상의 역할을 포함하는 개인과 조직 간의 관계이며, 역할을 할당 받지 않은 사람은 조직의 구성원이 될 수 없습니다.

1.3참조

[LIS, 11] IMS Global Learning Information Services v2.0, L. Feng, W. Lee and C. Smythe, IMS Global Learning Consortium, June 2011. /lis/.

[LTI, 12] Greg McFall, Mark McKell, Lance Neumann, Charles Severance, IMS Global Learning Tools Interoperability Implementation Guide v1.1 Final, IMS Global Learning Consortium, January 2014. /lti/

[LTI, 14, IMG] G.McFall, L.Neumann, S Vickers, IMS Global Learning Tools Interoperability Implementation Guide v2.0 Final, IMS Global Learning Consortium, January 2014. /lti/

[LTI, 14 SEC] G.McFall, L.Neumann, S.Vickers, IMS Global Learning Tools Interoperability Security v2.0 Final, IMS Global Learning Consortium, January 2014. /lti/

[OAuth, 10] The OAuth 1.0 Protocol, E. Hammer-Lahav. Retrieved 24 May 2016 from http://tools.ietf.org/html/rfc5849

[OBH, 11] OAuth Request Body Hash, B. Eaton, E. Hammer-Lahav. Retrieved 24 May 2016 from http://oauth.googlecode.com/svn/spec/ext/body_hash/1.0/oauth-bodyhash.html

[W3C, 14 ORG] Dave Reynolds, The Organization Ontology, W3C Recommendation, January 2014 Retrieved 24 May 2016 from http://www.w3.org/TR/vocab-org/

2 행동 모델

이 설명서에서 정의하고 있는 서비스를 통해 툴 제공자는 특정 문맥 속에서 역할을 수행하는 사용자 명단을 요청할 수 있다 (특정 리소스 링크를 포함합니다).

그림 2.1 회원 모델

3 정보 모델

모든 서비스 요청은 보안 문서 [LTI 14, SEC]에 설명된 대로 lti_oauth_body_hash_ws_security 웹 서비스 보안 프로파일을 사용하여 서명하는 방식으로 보안이 이루어져야 합니다.

3.1 LIS 회원 서비스

다음 기능은 이 서비스에 관한 것입니다:

ToolProxyBinding.memberships.url - 현재 문맥의 멤버 컨테이너에 접속하기 위한 엔드포인트 URL.

툴이 회원 서비스를 사용할 수 있으려면 툴 소비자는 툴 공급자에게 제공한 프로필에 툴 사용 가능 여부를 알리고, LTI 2의 경우 툴은 툴 소비자와 합의한 툴 프록시에서 해당 서비스 사용 의사를 밝혀야 합니다. ToolProxyBinding.memberships.url 기능 또한 툴 소비자 및 툴 공급자가 제공하고 수락해야 합니다.

그림 3.1. 툴 소비자 프로파일에 광고된 회원 서비스 설명서 LTI 1에서, 툴 소비자는 custom_context_memberships_url이라는 이름을 가진 사용자 지정 매개 변수로 엔드포인트를 전달해야 합니다.

그림 3.2. 툴 제공자는 회원 서비스 사용 의사를 밝혀야 함

3.2 회원 컨테이너 미디어 유형

첨부한 HTML문서는 회원 서비스에서 사용한 다음 미디어 유형에 대해 설명하고 있습니다:

application/vnd.ims.lis.v2.membershipcontainer+json

그림 3.3. application/vnd.ims.lis.v2.membershipcontainer+json 미디어 유형의 예시

이 기본 문맥은 항상 http://purl.imsglobal.org/ctx/lis/v2/MembershipContainer 여야 합니다. http://purl.imsglobal.org/vocab/lis/v2/status 및 http://purl.imsglobal.org/vocab/lis/v2/membership 문맥 중 하나를 사용하는 경우 접두사 liss 및 lism로 각각 정의해야 합니다. 회원 요소는 문맥에 관계없이 사용자에게 고유한 속성만을 포함합니다. 기본 LTI 실행과 같이 LTI 메시지에서 사용자에 대해 전달한 속성만 포함해야 합니다. 즉, 툴 제공자에게 전달되지 않은 사용자에 대한 속성은 생략해야 합니다. 이 서비스는 사용자에 대한 더 많은 정보를 얻기 위한 메커니즘이 아니며, 툴 제공자가 사용자 데이터에 대한 접근 권한을 획득하는 시점을 변경하기 위해 설계된 것입니다.

특정 리소스 링크 (아래 참조)에 접속할 수 있는 사용자를 반영하기 위해 회원 명단을 필터링하는 경우, 각 회원에 대해 basic-lti-launch-requestmessage 유형의 요소가 포함된 메시지 배열을 포함해야 합니다. 이 요소에는 지정된 리소스 링크의 실행 메시지에 포함되고 회원에 대한 특정 데이터를 포함하는 모든 확장자 (ext_ 접두사가 붙는다) 또는 사용자 지정 (custom_ 접두사가 붙는다) 매개 변수를 포함하여 문맥 또는 리소스 링크 별 메시지 매개 변수가 포함되어야 합니다. 메시지에서 전달되는 매개 변수의 이름 (예를 들어, lis_result_sourcedid)은 상응하는 값과 함께 사용되어야 합니다. 예를 들어, $ User 또는 $ Person 대체 변수를 값으로 사용하는 모든 사용자 지정 매개 변수가 포함되어야 합니다. 확장자 및 사용자 지정 매개 변수는 각각 ext 및 custom으로 명명된 요소에 포함되어야 하며, 이름에서 접두사는 생략합니다.

3.2.1 회원 상태

각 회원의 상태는 활성 또는 비활성으로 표시됩니다. 상태가 지정되지 않는 경우에는 활성 상태로 가정합니다. 차이점을 보고할 때는 회원 자격 (아래 참조)은 해당 회원이 더 이상 존재하지 않음을 의미하는 ‘삭제’ 상태로 표시될 수 있습니다. 일반적인 회원 명단 요청의 경우에는 현재의 회원만 반환하므로 ‘삭제’ 상태 회원은 없습니다.

3.3 서비스 이용

이 서비스를 위한 유일한 방안은 HTTP GET 요청입니다. 이 값은 제공된 엔드포인트로 보내지고, application / vnd.ims.lis.v2.membershipcontainer + json값과 승인 헤더 [LTI, 14 SEC]에 서명이 있는 Accept 헤더를 포함해야 합니다.

3.3.1 역할 쿼리 매개 변수

기본적으로, 모든 현재 회원자격은 이 서비스에 대한 요청에 의해 반환됩니다. 그러나 이것은 쿼리 매개 변수로 지정된 역할에 URI를 전달하여 지정된 역할이 있는 회원에게만 제한됩니다. 예를 들어, role = http % 3A % 2 % 2Fpurl.imsglobal.org % 2Fvocab % 2Flis % 2Fv2 % 2Fmembership % 23Learner의 쿼리 매개 변수는 학습자 역할을 가진 회원만 필터링합니다. 이것은 문맥 수준에 따른 역할이기 때문에, basic-lti-launch-request 메시지의 역할 매개 변수에 적용되는 동일한 규칙에 따라 매개 변수를 role = Learner로 단순화할 수 있습니다.

3.3.2 리소스 링크 ID 쿼리 매개 변수

요청된 회원 명단은 해당 문맥에서만 적용됩니다. 이 명단은 지정된 리소스 링크에 대한 접속 권한이 있는 사람에게만 제한하여 추가로 수정할 수 있습니다. 이 경우, 각 회원의 메시지 요소에는 해당 사용자 및 리소스 링크에 국한된 매개 변수가 포함됩니다. 리소스 링크와 관련된 활동과 관련하여 사용자의 기록부 셀에 접속하기 위해 사용되는 lis_result_sourcedid 매개 변수가 그 예입니다 - 기본 결과 서비스 [LTI, 12]를 참조합니다. 예를 들어, rlid = 49566-rkk96 쿼리 매개 변수는 ID 49566-rkk96 인 리소스 링크에 접속할 수 있는 회원만 필터링합니다.

3.3.3 쿼리 매개 변수 제한

툴 공급자는 툴 소비자의 응답에서 반환되는 최대 회원 수를 지정할 수 있습니다. 툴 소비자는 이것을 반환하는 번호에 대한 지침으로 사용할 수 있지만 제공된 값보다 많거나 적을 수 있습니다. Tool Consumer의 응답이 모든 회원을 포함하지 않는 경우, 다음 회원들을 요청하는 방법을 표시하기 위해nextPage 요소가 포함됩니다. nextPage 요소가 없는 경우에는 더 이상 불러올 회원이 없다는 의미입니다.

3.3.4 회원 자격 차이

회원 서비스의 응답에는 차이에 관한 요소가 포함될 수 있습니다. 이러한 것이 존재할 경우, 현재 회원과 이 응답에서 보고된 회원 사이의 모든 차이점에 대한 보고서를 얻기 위해 사용할 수 있는 URL을 지정합니다. 중간에 회원 자격이 삭제될 경우, 회원 자격은 “삭제”상태로 포함됩니다. 응답의 다른 모든 항목은 추가되거나 변경된 회원 자격을 나타냅니다. 후자의 경우에는 현재의 회원 상태가 기재됩니다. 이 옵션은 모든 변경 사항에 관한 기록을 제공하기 위한 것이 아니며, 단지 현재 상태와 URL이 제공되던 시점의 상태 사이의 차이점을 보고하기 위한 것입니다. 툴 소비자는 적어도 URL이 사용되거나 또는 전체 회원 명단에 대한 후속 요청 (또는 역할 매개 변수에 대해 동일한 값을 사용하는 요청)이 있을 때까지 URL을 지원해야 합니다. 즉, 툴 소비자는 언제든지 각 요청 양식에 대해 하나의 차이 (difference) URL을 유지해야 합니다. 일단 동일한 회원 자격에 대해 새로운 차이 URL이 발행되면, 이전의 URL은 모두 삭제됩니다.

문서 정보

Title: IMS Global
Editors: Stephen Vickers (IMS Global)
Version: 1.0
Version Date: 24 May 2016
Status: Final
Purpose: This document is made available for adoption by the public community at large.
Document Location: http://www.imsglobal.org/specs/lticiv1p0

기고자 목록

이름	기관
Viktor Haag,	D2L
Charles Severance	IMS Global
Greg McFall	Pearson
John Tibbetts	VitalSource
Mark McKell,	IMS Global
Claude Vervoort,	Cengage Learning
Stephen Vickers,	IMS Global
Lance Neumann	Blackboard
Padraig O'hiceadha	HMH

변경 이력

버전 번호	발표 일자	설명
공공 초안 1.0	2015년 2월 16일
후보 최종 초안 1.0	2016년 4월 30일
	2016년 5월 4일	리소스 링크 특정 회원 목록에 대한 요청이 쿼리 필터로 변경됨
최종 v1.0	2016년 5월 24일

IMS Global Learning Consortium, Inc. (“IMS Global”) 은 과학적이고 실험적이며 학구적인 협력의 목적 만을 위해서 이 IMS Global 공통 카트리지 프로파일: 실행 (“표준”) 에 포함된 정보를 발표하고 있습니다. IMS Global 은 표준의 정확성이나 완성도에 대해 보증이나 발언을 하지 않습니다. 이것은 ‘있는 그대로’ 그리고 ‘사용 가능한 그대로’의 형식으로 제공됩니다.

표준은 늘 통지 없이 변화와 개정이 될 수 있습니다. 표준이 당신에게 관련이 있는 이상, 그 유용성, 정확도, 그리고 완성도를 평가하는 것은 당신의 단독 의무입니다. IMS Global 은 당신의 논평과 제안을 수령하기 원합니다. 우리의 웹 사이트, http://www.imsglobal.org를 통해서 IMS Global 에 연락하십시오. 서류 번호를 참조하십시오. : IMS Global 학습 도구 상호운용성 회원 v1.0

개정: 2016년 5월 24일