OneRoster (명부 및 성적 교환 표준)

개요

학교와 대학은 학생 및 교원 정보와 수업 편성을 학사 시스템에서 관리하고, 실제 수업은 학습 플랫폼과 여러 학습 도구에서 진행한다. 두 축이 분리되어 있으면 학기마다 명부를 내려받아 다시 올리는 작업이 반복되고, 중간에 생기는 변동은 반영이 늦어진다. OneRoster는 명부와 성적을 시스템 사이에서 주고받는 형식과 절차를 표준화해, 기관이 시스템 조합을 바꾸더라도 같은 방식으로 연동을 유지할 수 있게 한다.

기술 관점에서 OneRoster는 두 가지 교환 방식을 함께 제공한다. 하나는 정해진 구조의 CSV 파일 묶음을 압축해 주고받는 방식이고, 다른 하나는 실시간 조회 및 반영이 가능한 REST API 방식이다. 1.2에서는 REST 호출의 인증을 OAuth 2.0 Bearer Token(Client Credentials)으로 통일하고, 이전 버전이 허용했던 OAuth 1.0a 메시지 서명 방식을 제거했다.

핵심 개념

• Provider / Consumer: 데이터를 제공하는 쪽과 받아 쓰는 쪽. 학사 시스템이 Provider, 학습 플랫폼이나 학습 도구가 Consumer가 되는 구성이 일반적이다.
• sourcedId: 모든 주요 객체가 갖는 고유 식별자. 시스템이 달라도 같은 대상을 같은 식별자로 가리키게 해, 반복 동기화에서 중복 생성과 유실을 막는 기준이 된다.
• org: 학교 및 교육청 등 조직 단위. 상위 조직과의 관계를 함께 표현한다.
• academicSession: 학년도, 학기, 성적 산출 기간 같은 학사 기간 단위.
• course / class: 교과목 정의와 실제 운영되는 수업 단위. 하나의 course에서 여러 class가 파생된다.
• enrollment: 사용자가 특정 class에 학습자 또는 교수자로 참여하는 수강 등록 관계.
• lineItem / result: 성적부의 평가 항목과 그 항목에 대한 개별 점수. 성적 반환은 이 두 객체를 통해 이뤄진다.
• scoreScale: 점수 체계 정의. 기관마다 다른 등급 및 척도를 명시적으로 표현한다. 백분율과 등급제를 함께 쓰는 기관에서 점수 값만 주고받을 때 생기는 해석 차이를 줄인다.
• demographics: 사용자와 분리해 관리하는 인구통계 정보. 별도 객체로 두어 필요한 시스템에만 제공할 수 있다.
• status / dateLastModified: 각 객체가 갖는 상태 값과 최종 변경 시각. 삭제 대신 비활성 상태로 표시하는 방식과, 변경분만 골라 조회하는 증분 동기화의 근거가 된다.

구성 요소

OneRoster 1.2의 REST API는 채택 범위를 나눌 수 있도록 세 서비스로 구분된다.

• Rostering: 조직, 사용자, 교과목, 수업, 학사 기간, 수강 등록, 인구통계 정보를 다룬다. 명부 동기화의 핵심 영역이다.
• Resource: 수업, 교과목, 사용자에 대한 자원 배정을 관리한다. 자원 자체에 대한 접근을 제공하지는 않고, 그 자원을 획득할 수 있을 만큼의 기술 정보를 전달한다.
• Gradebook: 평가 항목(lineItems)과 점수(results), 평가 항목의 묶음(categories), 점수 척도(scoreScales)를 다룬다. 조회 방식과 전송 방식 엔드포인트가 함께 제공된다.

1.2에는 Assessment Results Profile이라는 추가 프로파일도 있다. Gradebook 서비스를 확장해 수업 문맥 밖에서 이루어지는 평가를 포함하고, 성적부 안에 평가의 계층 구조를 구성할 수 있게 한다.

교환 방식은 두 갈래다. CSV 바인딩은 정해진 파일 집합을 압축해 일괄 이관하며, 1.2에서는 22개 파일이 정의되어 있다. REST 바인딩은 81개 엔드포인트를 통해 필요한 범위만 실시간으로 조회하거나 반영한다. 기관은 서비스와 바인딩을 필요에 맞게 골라 채택할 수 있다.

작동 방식

CSV 방식은 다음 순서로 진행된다.

1. 학사 시스템이 학기 시작 시점의 명부를 정해진 CSV 파일 집합으로 내보낸다.
2. 파일 묶음을 압축해 학습 플랫폼에 전달한다.
3. 학습 플랫폼이 sourcedId를 기준으로 기존 데이터와 대조해 신규 생성, 수정, 비활성화를 반영한다.

REST 방식은 다음 순서로 진행된다.

1. 기관이 Provider에 Consumer를 등록하고 자격 정보를 발급한다.
2. Consumer가 인증 서버에서 접근 토큰을 받는다.
3. Consumer가 필요한 범위의 엔드포인트를 호출해 조직, 수업, 수강 등록 정보를 조회한다.
4. 변경분은 학기 중에도 주기적으로 다시 조회해 반영한다.
5. 성적은 평가 항목을 먼저 맞춘 뒤 개별 점수를 전송해 성적부에 반영한다.

국내 도입 시나리오

국내 대학은 학사행정 시스템에서 수강 신청과 분반을 확정하고 학습관리 시스템에서 수업을 운영하는 구조가 일반적이다. 학기 초 명부 이관과 학기 말 성적 집계를 각각 별도 절차로 처리하는 대신, OneRoster의 Rostering과 Gradebook을 적용해 두 시점의 데이터 흐름을 같은 규격으로 정리할 수 있다.

시도교육청 단위로 다수 학교가 공통 플랫폼과 여러 학습 도구를 함께 쓰는 경우에는, 도구별로 명부 연동을 개별 개발하는 부담이 커진다. 표준 규격을 조건으로 두면 도구가 바뀌어도 연동 방식을 유지할 수 있다.

국내 에듀테크 기업이 학교 및 대학에 제품을 공급할 때, 명부 연동은 초기 구축 비용의 큰 부분을 차지한다. OneRoster를 지원하면 기관별 맞춤 개발 대신 표준 연동으로 대응 범위를 넓힐 수 있다.

적합성 인증

1EdTech는 OneRoster에 대해 스펙 버전과 서비스 단위로 적합성 시험을 운영한다. 인증을 받으려는 제품은 핵심 서비스 가운데 최소 하나를 지원해야 하며, 제공자 역할과 소비자 역할, CSV와 REST 바인딩이 각각 시험 대상으로 구분된다. 따라서 인증 표기를 확인할 때는 어떤 서비스와 어떤 바인딩에 대한 인증인지 함께 보는 것이 중요하다. 인증은 시험 시점부터 1년간 유효하고 매년 재시험이 권장되며, 갱신하지 않으면 비활성으로 표시된다. 인증 제품은 TrustEd Apps Directory에서 확인할 수 있다.

관련 표준

• LTI: LTI의 Names and Role Provisioning은 런치된 문맥 안에서 해당 수업의 명부를 조회한다. OneRoster는 시스템 사이의 일괄 및 정기 동기화를 다루므로, 두 표준은 범위가 다르며 함께 쓰인다.
• QTI: 평가 문항과 시험의 교환 형식이다. QTI로 시행한 평가의 결과 점수를 성적부로 반영하는 지점에서 OneRoster의 Gradebook과 이어진다.
• CASE: 역량 및 교육과정 체계를 교환한다. 수업과 평가 항목을 교육과정 체계에 연결할 때 참조된다.
• CLR: 포괄적 학습자 기록을 다룬다. 수업 단위 성적이 학습자 기록으로 축적되는 흐름에서 연결된다.
• Caliper: 학습 활동 데이터 수집 형식이다. 명부가 정리되어 있어야 활동 데이터를 사용자 및 수업 단위로 해석할 수 있다.

원문 자료

• 게이트웨이: https://www.1edtech.org/standards/oneroster
• OneRoster 스펙 포털: https://standards.1edtech.org/oneroster/
• OneRoster 1.2 스펙: https://www.imsglobal.org/spec/oneroster/v1p2
• 구현·모범사례 가이드: https://www.imsglobal.org/spec/oneroster/v1p2/impl
• CSV 바인딩: https://www.imsglobal.org/spec/oneroster/v1p2/bind/csv
• 적합성·인증 가이드: https://www.imsglobal.org/spec/oneroster/v1p2/cert
• 도입·조달 가이드: https://www.1edtech.org/standards/oneroster/OneRoster-Procurement-Guide

이 요약은 1EdTech의 공개 자료를 바탕으로 1EdTech Korea가 작성했습니다. 기술적 세부사항은 원문 스펙을 기준으로 합니다.