edutap.ai developers

Blackboard에서 EduTap LTI 1.3 설정하기

Blackboard 시스템 관리자를 위한 EduTap LTI 1.3 도구 제공자 설정 가이드

이 가이드는 Blackboard Learn Ultra 시스템 관리자가 EduTap을 LTI 1.3 도구 제공자로 등록하고 설정하는 과정을 안내합니다.

사전 요구 사항

  • Blackboard Learn Ultra (Blackboard Learn Original에서는 LTI 1.3이 지원되지 않음)
  • Blackboard 인스턴스의 시스템 관리자 권한
  • EduTap 계정 및 API 키 (EduTap 담당자에게 문의)

LTI 1.3은 OAuth 1.0 기반의 LTI 1.1을 OAuth 2.0 + JWT 기반 인증으로 대체하여, 더 강력한 보안과 풍부한 기능을 제공합니다.

EduTap LTI 제품 정보

항목값
Client ID86a58b15-29b1-429c-9bec-9814cde94866
NameEduTAP
DescriptionAI Tutor chatbot for online courses
Tool Launch URLhttps://tapapi.coxwave.link/api/v1/lti/launch
OIDC Login Initiation URLhttps://tapapi.coxwave.link/api/v1/lti/login
Public Keyset URLhttps://tapapi.coxwave.link/api/v1/lti/jwks
Redirect URIshttps://tapapi.coxwave.link/api/v1/lti/launch

Step 1: Blackboard에 LTI 도구 등록

  1. 시스템 관리자로 Blackboard 인스턴스에 로그인합니다.
  2. System Admin > Integrations > LTI Tool Providers로 이동합니다.
  3. Register LTI 1.3/Advantage Tool을 클릭합니다.
  4. Client ID 필드에 아래 값을 입력합니다:
86a58b15-29b1-429c-9bec-9814cde94866
  1. Submit을 클릭합니다.

Client ID를 입력하고 Submit을 누르면, Blackboard가 EduTap의 등록 정보를 자동으로 조회하여 Tool Launch URL, OIDC Login URL, JWKS URL, Redirect URIs, Domain 등의 필드를 자동으로 채웁니다.

  1. 자동으로 채워진 값들이 아래와 일치하는지 확인합니다:
항목자동 채워지는 값
Initiate Login URLhttps://tapapi.coxwave.link/api/v1/lti/login
Tool Redirect URL(s)https://tapapi.coxwave.link/api/v1/lti/launch
JWKS URLhttps://tapapi.coxwave.link/api/v1/lti/jwks
  1. Deployment ID가 생성됩니다. 이 값을 기록해 두세요 — Step 4에서 EduTap 팀에 전달해야 합니다.

Step 2: 도구 설정 구성

도구 등록 후 설정을 구성합니다:

  1. LTI Tool Providers 목록에서 EduTAP을 찾아 Edit을 클릭합니다.
  2. 아래 설정을 확인하거나 업데이트합니다:
설정권장 값
Tool StatusApproved
User Fields to SendRole in Course, Name, Email Address
Allow Grade Service AccessYes
Allow Membership Service AccessYes

Allow Grade Service Access를 반드시 Yes로 설정하세요. 이 설정이 없으면 성적 연동이 동작하지 않습니다.

  1. Submit을 클릭하여 변경 사항을 저장합니다.

Step 3: Placement 생성

Placement는 도구가 코스 내에서 어떻게 표시될지 정의합니다.

  1. LTI Tool Providers 페이지에서 EduTAP 옆의 드롭다운 화살표를 클릭합니다.
  2. Manage Placements > Create Placement를 선택합니다.
  3. 아래 내용을 입력합니다:
항목값
LabelEduTap AI Tutor
Handleedutap-ai-tutor
AvailabilityYes
TypeDeep Linking content tool
Launch in New WindowNo (iframe 경험을 위해 권장)
Target Link URIhttps://tapapi.coxwave.link/api/v1/lti/launch
  1. Submit을 클릭합니다.

Step 4: EduTap에 Deployment ID 전달

아래 정보를 EduTap 통합 팀(support@edutap.ai)에 전달해 주세요:

  1. Deployment ID (Step 1에서 생성된 값)
  2. Blackboard 인스턴스 URL (예: https://your-university.blackboard.com)

EduTap 팀이 서버 측에서 이 값들을 설정하고, 테스트 준비가 완료되면 확인해 드립니다.

Step 5: 통합 검증

EduTap 팀이 설정 완료를 확인한 후:

  1. 강사 권한으로 Blackboard의 코스에 접속합니다.
  2. Content > Build Content를 클릭하거나 Placement가 추가된 콘텐츠 영역을 사용합니다.
  3. 도구 목록에서 EduTap AI Tutor를 선택합니다.
  4. 코스 내에서 EduTap 인터페이스가 올바르게 로드되는지 확인합니다.

문제 해결

문제해결 방법
"Tool is not configured" 오류Deployment ID가 EduTap에 전달되고 확인되었는지 확인하세요.
실행 시 빈 화면Tool Launch URL이 올바른지, 도구 상태가 Approved인지 확인하세요.
사용자 역할이 인식되지 않음User Fields to Send에서 'Role in Course'가 활성화되어 있는지 확인하세요.
OIDC 로그인 실패자동 채워진 OIDC Login Initiation URL이 올바른지 확인하세요.
JWKS 검증 오류자동 채워진 Public Keyset URL에 접근 가능한지 확인하세요.
성적이 연동되지 않음Allow Grade Service Access가 Yes로 설정되어 있는지 확인하세요.

문제가 지속되면 Blackboard 인스턴스 URL과 오류 상세 정보를 포함하여 EduTap 지원팀에 문의하세요.

참고: EduTap LTI 엔드포인트

엔드포인트URL
Client ID86a58b15-29b1-429c-9bec-9814cde94866
Tool Launch URLhttps://tapapi.coxwave.link/api/v1/lti/launch
OIDC Login URLhttps://tapapi.coxwave.link/api/v1/lti/login
Public Keyset URLhttps://tapapi.coxwave.link/api/v1/lti/jwks
Redirect URIshttps://tapapi.coxwave.link/api/v1/lti/launch

다음 단계

SDK 연동

JavaScript SDK로 EduTap 임베드하기

데이터 연동

AI 튜터를 위한 코스 데이터 업로드

목차

사전 요구 사항EduTap LTI 제품 정보Step 1: Blackboard에 LTI 도구 등록Step 2: 도구 설정 구성Step 3: Placement 생성Step 4: EduTap에 Deployment ID 전달Step 5: 통합 검증문제 해결참고: EduTap LTI 엔드포인트다음 단계