Add Comments to Your LMS via LTI 1.3

1. FastComments에 로그인하고 귀하의 LTI 1.3 구성 페이지로 이동합니다.
2. (선택 사항) 연결 중인 플랫폼을 플랫폼 드롭다운에서 선택하세요 - 표시 레이블을 설정하지만, 자동 감지도 잘 작동합니다.
3. URL 생성을 클릭하세요. 일회용 등록 URL이 표시됩니다 (30분 동안 유효, 한 번만 사용 가능).
4. 귀하의 LMS에서 LTI 1.3 동적 등록 화면을 열고 URL을 도구 시작 등록 엔드포인트 (또는 해당) 필드에 붙여넣습니다. 제출하세요.
5. 귀하의 LMS가 FastComments에 콜백을 보내 키를 교환하고 통합을 생성합니다. 완료되면 팝업이 자동으로 닫힙니다.
6. FastComments로 돌아가면 새 구성이 기존 구성 표에 나타납니다. 이 도구를 이제 LMS 코스 내에서 사용할 수 있습니다.

FastComments LTI 1.3는 다음 플랫폼에서 테스트되었습니다:

• D2L Brightspace (LTI Advantage를 지원하는 모든 버전)
• Moodle 4.0+ (External Tool 플러그인, LTI Advantage)
• Blackboard Learn (SaaS 및 Ultra)
• Sakai (LTI Advantage를 지원하는 버전)
• Schoology (Enterprise, 가능한 경우 Dynamic Registration)

Dynamic Registration을 사용하는 IMS LTI 1.3 Advantage 사양을 구현한 다른 LMS들도 작동해야 합니다 - 등록 URL을 생성할 때 플랫폼 드롭다운에서 Other LTI 1.3 platform을 선택하세요 (여기에서 가져오세요).

Canvas LMS는 다른 설정 흐름을 사용합니다 (Dynamic Registration 대신 개발자별 키(per-developer-key) 구성 JSON을 사용). 전용 Canvas LMS 설치 가이드를 참조하세요.

LTI 1.3 구성으로 이동

FastComments에 로그인한 다음 LTI 1.3 구성 페이지로 이동합니다.

계정에 아직 LTI 접근 권한이 없으면 "이 계정에 대해 LTI가 활성화되어 있지 않습니다" 메시지가 표시됩니다 - 해당 플랜에 LTI를 활성화하려면 지원팀에 문의하세요.

플랫폼 선택 (선택 사항)

동적 등록 URL 생성 아래에서 플랫폼 드롭다운을 사용하여 연결할 LMS를 FastComments에 알려주세요:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Other LTI 1.3 platform

또는 자동 감지로 둔 상태로 둘 수도 있습니다. 플랫폼 정보는 등록 시 LMS의 openid-configuration에서 읽어오며; 드롭다운은 생성된 구성에 표시될 레이블만 초기값으로 제공합니다.

URL 생성

URL 생성을 클릭합니다. FastComments는 일회성 등록 토큰을 생성하고 다음과 같은 URL을 표시합니다:

https://fastcomments.com/lti/v1p3/register/<long-token>

복사하세요. 이 URL은:

• 단회 사용입니다 - LMS가 성공적으로 호출하면 토큰은 소모됩니다.
• 사용되지 않으면 30분 후에 만료됩니다.
• 비공개로 유지해야 합니다 - 이 URL을 가진 사람은 해당 30분 동안 테넌트에 도구를 등록할 수 있습니다.

기존 구성

등록이 성공적으로 완료되면 새 구성은 동일한 페이지의 기존 구성 테이블에 플랫폼, Issuer, Client ID 및 상태와 함께 표시됩니다. 등록 해제가 필요한 경우 이 테이블에서 구성을 삭제할 수 있습니다.

D2L Brightspace는 LTI Advantage 관리 인터페이스를 통해 동적 등록(Dynamic Registration)을 제공합니다. 관리자 권한이 필요합니다.

Open the Registration Screen

1. Sign in to your Brightspace instance as an admin.
2. Navigate to Admin Tools > Manage Extensibility > LTI Advantage.
3. Click Register Tool. (The direct URL is https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Paste the URL

You'll see a registration form. The key field is Tool initiation registration endpoint (some Brightspace versions label it "Tool Initiation Registration URL").

Paste the FastComments registration URL (여기에서 가져오세요) into that field. Leave the other fields blank - they're auto-populated by FastComments during the registration handshake.

Click Register.

Approve the Tool

Brightspace opens a popup that talks to FastComments, exchanges keys, and shows a confirmation screen. The popup closes itself when registration completes.

The new tool appears in your LTI Advantage tool list. By default Brightspace marks new tools as disabled - flip the toggle to enabled so your courses can use it.

Add a Deployment

In Brightspace, LTI tools need a deployment before they can be used in courses:

1. Open the newly-registered FastComments tool.
2. Click View Deployments > New Deployment.
3. Give the deployment a name (e.g. "FastComments - All Courses"), pick the org units it should be available in, and save.

After the first launch through this deployment, FastComments pins the deployment_id to its configuration record - subsequent launches from a different deployment under the same client will be rejected unless you re-register.

Moodle를 사용하고 계신가요? FastComments는 LTI 1.3보다 더 긴밀하게 통합되는 등급 동기화 훅, 더 깊은 활동 보고, 네이티브 Moodle 설정 UI를 제공하는 전용 Moodle 플러그인도 배포합니다. Moodle 플러그인 설치 가이드를 참조하세요. 아래의 LTI 1.3 흐름은 다른 LMS도 포함하는 단일 등록을 원하거나 Moodle 관리자가 타사 플러그인을 설치하지 않을 경우 적합한 선택입니다.

Moodle 4.0+는 External Tool 플러그인을 통해 LTI 1.3 동적 등록을 지원합니다.

도구 관리 화면 열기

1. 사이트 관리자 계정으로 Moodle에 로그인합니다.
2. 사이트 관리 > 플러그인 > 활동 모듈 > 외부 도구 > 도구 관리로 이동합니다.

URL 붙여넣기

Tool URL이라는 카드가 표시됩니다. 텍스트 필드에 FastComments 등록 URL(여기에서 가져오기)을 붙여넣고 Add LTI Advantage를 클릭합니다.

Moodle은 도구의 식별 정보와 요청된 권한을 보여주는 등록 화면을 엽니다. 검토한 후 활성화(또는 Moodle 버전에 따라 등록)를 클릭하세요.

등록이 완료되면 팝업이 닫히며 새 FastComments 도구가 도구 목록에 활성 상태로 나타납니다.

사용 가능하게 만들기

기본적으로 Moodle은 새 도구를 "강좌 도구" 목록에 추가하지만 활동 선택기에는 표시하지 않습니다. FastComments를 강좌 전체에 노출하려면:

1. FastComments 타일에서 톱니바퀴 아이콘을 클릭합니다.
2. 도구 구성 사용에서 활동 선택기 및 사전 구성된 도구로 표시를 선택합니다.
3. 저장합니다.

이제 강사는 활동 또는 자료 추가 > FastComments를 통해 어떤 강좌든 FastComments를 추가할 수 있습니다.

Blackboard Learn SaaS 및 Ultra는 LTI 1.3 동적 등록을 지원합니다.

도구 제공자 화면 열기

1. 시스템 관리자로 Blackboard에 로그인하세요.
2. Administrator Panel > Integrations > LTI Tool Providers로 이동하세요.
3. Register LTI 1.3 / LTI Advantage Tool을 클릭하세요.

만약 "Register LTI 1.1 Provider"만 보인다면, 사용 중인 Blackboard 버전은 LTI 1.3을 아직 지원하지 않습니다 — 업그레이드하거나 Blackboard 지원에 문의하세요.

URL 붙여넣기

FastComments 등록 URL (여기에서 가져오기)을 Client ID / Registration URL 필드에 붙여넣으세요 (Blackboard의 표기법은 버전별로 다를 수 있습니다). 제출하세요.

Blackboard가 FastComments와 등록 핸드셰이크를 수행하고 확인 화면을 표시합니다.

승인 및 활성화

Blackboard는 새로 등록된 도구를 기본적으로 Approved but excluded로 표시합니다:

1. 도구 제공자 목록에서 FastComments 항목을 찾으세요.
2. 메뉴를 열고 Edit를 선택하세요.
3. Tool Status를 Approved로 설정하세요.
4. Institution Policies에서 전송되는 사용자 데이터(이름, 이메일, 역할)를 검토하세요. 저장하세요.

이제 강사가 코스에 콘텐츠를 추가할 때 해당 도구를 사용할 수 있습니다.

Sakai

Sakai는 LTI Advantage가 포함된 릴리스에서 LTI 1.3 동적 등록을 지원합니다. 관리자 워크스페이스에서:

1. Sakai 관리자 계정으로 로그인하고 관리자 워크스페이스를 엽니다.
2. 외부 도구 > LTI 1.3 도구 설치를 선택합니다.
3. FastComments 등록 URL (여기에서 가져오기)을 붙여넣고 제출합니다.
4. 핸드셰이크가 완료되면 도구를 승인합니다.

그러면 도구가 외부 도구 아래에 표시되며 해당 사이트의 유지관리자가 사이트에 추가할 수 있습니다.

Schoology

Schoology Enterprise 인스턴스는 LTI 1.3을 지원하지만 동적 등록의 사용 가능 여부는 배포에 따라 다릅니다. Schoology 계정 관리자에게 확인하세요.

동적 등록이 귀하의 Schoology 인스턴스에서 사용 불가능한 경우, 다음 엔드포인트를 사용하여 통합을 수동으로 구성해야 합니다:

• OIDC 로그인 URL: https://fastcomments.com/lti/v1p3/login
• 대상 링크 URL: https://fastcomments.com/lti/v1p3/launch
• 공개 키셋 URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• 리디렉션 URL: https://fastcomments.com/lti/v1p3/launch

Schoology가 Client ID 및 Deployment ID를 제공하면, FastComments 지원팀에 연락하여 테넌트에 구성을 등록해 달라고 요청하세요.

Other LTI 1.3 Platforms

IMS LTI 1.3 Advantage 사양을 따르는 모든 LMS는 동일한 등록 URL (여기에서 가져오기)로 작동해야 합니다. "동적 등록", "도구 등록 URL", "도구 시작 등록 엔드포인트" 또는 이와 유사한 레이블이 있는 설정을 찾으십시오.

플랫폼이 수동 LTI 1.3 설정만 지원하는 경우 위 Schoology 섹션에 나열된 네 가지 엔드포인트를 사용하고 최종 구성을 위해 지원팀에 연락하세요.

이 페이지에서는 관리자가 도구를 등록하고 배포(deployment)를 생성한 후 Brightspace 강좌에 FastComments를 추가하는 방법을 설명합니다. 도구가 아직 등록되지 않았다면 먼저 D2L 등록 가이드를 참조하세요.

Brightspace의 유닛 토픽으로 임베드된 FastComments

Brightspace는 두 가지 콘텐츠 작성 환경을 제공합니다: 클래식 콘텐츠(Classic Content) 와 새 콘텐츠 경험(New Content Experience) (일명 Lessons). 둘 다 FastComments를 노출하지만 메뉴 경로가 다릅니다. 아래 각 섹션은 분기되는 부분을 모두 다룹니다.

FastComments 도구 찾기

FastComments 도구는 코스 콘텐츠 편집기 내부에서 두 곳에 나타납니다:

1. 모듈/유닛의 추가(Existing) 버튼(구버전 Brightspace에서는 기존 활동 추가(Add Existing Activities) 라고 표기)에서 접근하는 활동 선택기(activity picker). FastComments는 현재 Brightspace 빌드에서는 선택기에 직접 표시됩니다; 구버전에서는 External Learning Tools 하위 메뉴에 중첩되어 있습니다. 어느 경로든 FastComments를 단일 토픽으로 추가합니다.
2. HTML 편집기 내부의 Insert Stuff 대화상자에서 LTI Advantage 항목 아래. 이는 LTI 딥 링크 흐름을 통해 HTML 토픽 내에 FastComments를 인라인으로 임베드합니다.

FastComments가 어느 선택기에도 나타나지 않으면 해당 강좌를 포함하는 조직 단위(org unit)에 대해 배포가 활성화되지 않은 것입니다. Brightspace 관리자에게 Admin Tools > Manage Extensibility > LTI Advantage > FastComments 도구 > View Deployments를 열고 배포를 열어 Org Units 아래에 강좌의 조직 단위(또는 상위 조직 단위)를 추가해 달라고 요청하세요.

모듈에 FastComments를 토픽으로 추가하기

클래식 콘텐츠:

1. 코스를 열고 내비게이션 바에서 Content를 클릭합니다.
2. 토론을 넣을 모듈을 선택합니다(또는 모듈 추가(Add a module) 로 새로 만듭니다).
3. Add Existing(구버전 Brightspace: Add Existing Activities > External Learning Tools)를 클릭합니다.
4. 선택기에서 FastComments를 클릭합니다. Brightspace가 모듈에 토픽을 생성하고 콘텐츠 보기로 돌아갑니다.
5. 새 토픽을 클릭합니다. 인라인 제목 편집기를 사용해 FastComments Discussion 같은 설명적인 이름으로 바꿉니다.

새 콘텐츠 경험(Lessons):

1. 코스를 열고 Content를 클릭합니다.
2. 토론을 넣을 유닛과 레슨을 엽니다.
3. Add > Existing Activity를 클릭하고 FastComments를 선택합니다(구버전 Brightspace: External Learning Tools 아래에 중첩).
4. 활동이 레슨에 추가됩니다.
5. 활동 제목을 클릭해 이름을 변경합니다.

어떤 사용자가(강사든 학생이든) 처음으로 토픽을 열면 FastComments가 해당 리소스 링크에 대한 스레드를 초기화합니다. 스레드는 리소스 링크 ID에 바인딩되므로 토픽 이름을 바꾸거나 이동해도 로드되는 스레드는 변경되지 않습니다.

HTML 토픽에 FastComments를 인라인으로 임베드하기

읽기 자료, 비디오 또는 기타 콘텐츠 아래에 같은 토픽 페이지 내에서 댓글을 표시하고 싶을 때 이 흐름을 사용하세요.

1. 모듈/레슨에서 HTML 토픽을 열거나 새로 만듭니다.
2. Edit HTML을 클릭하여 Brightspace HTML 편집기를 엽니다.
3. 댓글 스레드가 나타나야 할 위치에 커서를 놓습니다.
4. 편집기 툴바의 퍼즐 조각 아이콘인 Insert Stuff 버튼을 클릭합니다.
5. Insert Stuff 대화상자에서 LTI Advantage로 스크롤한 뒤 FastComments를 클릭합니다.
6. FastComments가 딥 링크 선택기를 엽니다. 배치(기본 옵션은 콘텐츠 토론에 적합)를 확인하고 Insert 또는 Continue를 클릭합니다.
7. Brightspace가 플레이스홀더 블록을 가진 상태로 HTML 편집기로 돌아갑니다. 토픽에서 Save and Close를 클릭합니다.

토픽이 로드되면 Brightspace는 플레이스홀더를 LTI로 자동 실행되는 iframe으로 교체합니다. 학생들은 토론 스레드를 인라인으로 보게 됩니다.

하나의 HTML 토픽은 여러 개의 딥 링크된 FastComments 임베드를 담을 수 있습니다. 각 임베드는 별도의 리소스 링크 ID를 생성하므로 각 임베드마다 자체 스레드를 가집니다.

모듈 토픽 대 인라인 퀵링크

다음과 같은 경우 모듈 토픽 방식을 선택하세요:

• 토론이 해당 모듈 단계의 주요 활동인 경우.
• 토픽이 Brightspace의 목차, 완료 추적, Class Progress에 표시되기를 원할 경우.

다음과 같은 경우 인라인 임베드 방식을 선택하세요:

• 댓글이 같은 페이지의 다른 콘텐츠 아래에 있어야 할 경우.
• 목차에 별도의 완료 추적 가능한 항목으로 표시되기를 원하지 않을 경우.

표시, 초안(Draft), 공개 조건(Release Conditions)

새 FastComments 토픽은 기본적으로 학생에게 표시됩니다. 설정하는 동안 숨기려면:

1. 콘텐츠 편집기에서 토픽 제목(클래식) 또는 활동의 점 3개 메뉴(새 콘텐츠 경험)를 클릭합니다.
2. 상태를 Draft로 설정(클래식)하거나 Visibility를 끕니다(새 콘텐츠 경험).

초안 토픽은 학생에게 보이지 않습니다. 강사와 조교는 여전히 "Draft" 배지가 있는 상태로 볼 수 있습니다.

토픽을 특정 그룹이나 섹션으로 제한하려면:

1. 토픽을 엽니다.
2. 토픽 제목 메뉴 > Edit Properties In-place(클래식) 또는 Edit > Restrictions(새 콘텐츠 경험)을 클릭합니다.
3. Release Conditions 아래에서 Create를 클릭합니다.
4. Group enrollment 또는 Section enrollment를 선택하고 그룹/섹션을 선택한 뒤 저장합니다.

공개 조건은 FastComments 자체의 역할 매핑과 함께 적용됩니다. 학생이 토픽을 볼 수 없으면 LTI 실행도 받지 못합니다.

학생이 처음 실행할 때 보이는 것

학생이 토픽을 클릭(또는 임베드가 포함된 HTML 토픽을 로드)하면:

1. Brightspace가 배경에서 LTI 1.3 런치를 수행합니다.
2. FastComments는 학생의 이름, 이메일, 아바타 URL, LMS 역할을 받아 자동으로 로그인 처리합니다. FastComments 로그인 프롬프트는 없습니다.
3. 해당 리소스 링크의 댓글 스레드가 Brightspace iframe 내부에 렌더링됩니다.

런치 시 역할 매핑:

• Brightspace Administrator는 해당 스레드에 대한 FastComments의 관리자(admin)가 됩니다(전체 중재, 삭제, 차단, 구성 접근 권한).
• Brightspace Instructor는 FastComments의 중재자(moderator)가 됩니다(고정, 숨김, 삭제, 차단).
• 그 외 모든 역할들(Learner, TeachingAssistant 등)은 일반 댓글 작성자가 됩니다.

댓글은 학생의 Brightspace 계정에 귀속됩니다. 학생이 Brightspace에서 이름이나 아바타를 수정하면 다음 LTI 런치에서 변경사항이 동기화됩니다.

iframe 높이 및 리사이즈

FastComments는 각 스레드 렌더와 콘텐츠 변경(새 댓글, 답글 확장) 시마다 org.imsglobal.lti.frameResize postMessage를 전송합니다. Brightspace는 이 메시지를 수신하여 iframe 높이를 조정하므로 스레드가 잘리거나 내부 스크롤바가 표시되지 않습니다.

iframe이 고정된 짧은 높이에 머무르면:

• 코스가 HTTPS로 로드되는지 확인하세요. Brightspace의 postMessage 리스너는 혼합 콘텐츠 프레임을 거부합니다.
• 브라우저 확장 기능이 postMessage 채널을 차단하고 있지 않은지 확인하세요.
• HTML 토픽의 인라인 임베드인 경우, iframe을 고정 높이 컨테이너로 감싸지 않았는지 확인하세요. 부모 요소에서 inline style="height: ..." 를 제거하세요.

Brightspace 특이 문제(Gotchas)

Add Existing 선택기에 도구가 표시되지 않음. 배포가 이 강좌의 조직 단위에 대해 활성화되어 있지 않습니다. 관리자가 배포의 Org Units 목록에 조직 단위(또는 상위 단위)를 추가해야 합니다. 도구 등록만으로는 충분하지 않으며, 배포가 어떤 강좌에서 도구를 볼 수 있는지를 결정합니다.

런치 시 deployment_id 불일치. FastComments는 등록 시 처음 본 deployment_id를 TOFU(Trust On First Use) 방식으로 고정합니다. 관리자가 원래 배포를 삭제하고 새 배포를 만들면 새 배포에서의 런치는 배포 불일치 오류로 거부됩니다. 해결 방법은 FastComments를 다시 등록하는 것입니다(새 등록 URL을 생성하려면 여기에서 받으세요) 그리고 동적 등록(Dynamic Registration)을 다시 실행하세요; 이전 구성 레코드는 교체됩니다.

도구는 실행되지만 "Invalid LTI launch"가 표시됨. 강좌가 배포가 적용된 테넌트/조직 구조와 다르거나, 등록 이후 배포가 비활성화되었을 수 있습니다. Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled 토글과 배포의 조직 단위 목록을 다시 확인하세요.

FastComments 내부에 이름과 역할이 없음. Brightspace는 Names and Role Provisioning Services(NRPS) 클레임을 포함한 LTI 런치를 제공합니다. 만약 강좌가 이전 LTI 1.1 링크에서 업그레이드된 경우 런치에 name 및 email 클레임이 없을 수 있습니다. FastComments 토픽을 Add Existing로 다시 추가하세요(기존 링크를 마이그레이션하지 마세요). 그러면 런치가 LTI 1.3을 사용합니다.

임베드가 자동 SSO 대신 로그인 화면을 표시함. HTML 토픽이 Insert Stuff > LTI Advantage를 통해 삽입된 것이 아니라 FastComments를 직접 가리키는 일반 <iframe>으로 삽입된 경우입니다. 일반 iframe은 LTI 런치를 생략하고 사용자를 공개 FastComments 페이지로 보냅니다. iframe을 삭제하고 Insert Stuff 흐름을 통해 다시 삽입하세요.

Once an administrator has registered FastComments as an LTI 1.3 Advantage tool and approved the institution policies, instructors add it to courses through the standard Blackboard placement points. The exact steps differ between Ultra Course View and Original Course View, so both are covered below.

Ultra Course View

Ultra Course View is the default in Blackboard Learn SaaS as of 2026.

1. 강좌를 열고 Course Content 페이지로 이동합니다.
2. 개요에서 댓글 스레드를 배치하고 싶은 위치에 마우스를 올리거나 탭한 다음 보라색의 + (Add content) 버튼을 클릭합니다.
3. Content Market을 선택합니다. Content Market 패널에는 기관에서 승인한 모든 LTI 도구 및 Building Block 배치가 나열됩니다.
4. FastComments 타일을 찾아 클릭합니다. Blackboard는 + 메뉴를 연 위치에 콘텐츠 항목을 생성합니다.
5. 이 항목은 기본적으로 개요에 "Visible to students" 항목으로 생성됩니다(강사가 개인 기본 설정으로 Hide from students를 끈 경우). 기본값이 Hidden이면 항목이 숨김 상태로 생성되며, 준비가 되면 항목 행의 가시성 선택기를 켜서 표시할 수 있습니다.
6. 항목 이름을 변경하려면 개요에서 제목을 클릭하고 새 레이블을 입력합니다. 학생이 개요에서 보는 제목은 FastComments 스레드 식별자와 독립적이므로 언제든지 이름을 변경해도 안전합니다.

Content Market 옵션이 보이지 않는 경우, 귀 기관에서 해당 배치를 숨겨둔 것입니다. 동일한 선택기는 같은 + 메뉴의 LTI Tools 그룹 아래 More tools를 통해서도 접근할 수 있습니다.

Original Course View

Original Course View는 Learn SaaS에서 계속 지원되며 Q4 2024 CU 릴리스 라인의 자체 호스팅된 Learn 9.1 사이트에서는 여전히 기본 환경입니다.

1. 강좌를 열고 Content Area(예: 강좌 메뉴의 기본 Information 또는 Content 영역)에 들어갑니다.
2. 페이지 오른쪽 상단의 토글로 Edit Mode를 켭니다.
3. 작업 표시줄에서 Build Content를 클릭합니다.
4. Learning Tools 하위 메뉴에서 FastComments를 클릭합니다. Learning Tools 하위 메뉴는 관리자가 도구를 등록한 후 LTI 1.3 도구 배치로 채워집니다. 보이지 않으면 아래의 문제 해결 섹션을 참조하십시오.
5. Create FastComments 양식에서 다음을 설정합니다:
   • Name: 학생이 콘텐츠 영역에서 볼 레이블.
   • Description: 임베드된 스레드 위에 표시되는 선택적 텍스트.
   • Permit Users to View this Content: 사용 가능 여부 토글(예/아니오).
   • Track Number of Views: Blackboard의 항목별 조회 통계를 원하면 활성화합니다. FastComments는 자체 분석을 별도로 실행합니다.
   • Date and Time Restrictions: 선택적 Display After / Display Until 기간.
6. 제출합니다. 도구가 콘텐츠 영역에 클릭 가능한 항목으로 나타납니다.

Embedding Inside an Item or Document

두 강좌 보기 모두에서 강사는 Content Editor의 LTI Advantage 버튼을 통해 Item, Document 또는 모든 리치 텍스트 필드 본문 안에 FastComments를 인라인으로 임베드합니다.

Ultra Course View:

1. Document를 만들거나 편집합니다.
2. 스레드를 표시하고 싶은 문서 본문 안에서 Add content를 클릭합니다.
3. 편집기 도구 모음에서 Insert content 메뉴를 열고 Content Market(LTI Advantage / Deep Linking 진입점)을 클릭합니다.
4. FastComments를 선택합니다. FastComments는 딥링크 페이로드를 반환하고 Blackboard는 커서 위치에 임베디드 블록을 문서 본문에 삽입합니다.
5. 문서를 저장합니다. 학생은 스크롤하여 해당 부분을 지나갈 때 스레드가 인라인으로 렌더링된 것을 봅니다.

Original Course View:

1. 리치 텍스트 본문이 있는 항목을 편집합니다.
2. Content Editor 도구 모음에서 Add Content 더하기 아이콘을 클릭하고 Content Market을 선택합니다(구형 Q4 2024 CU에서는 Add Content from External Tool로 표시됨).
3. FastComments를 선택합니다. 편집기는 딥링크된 리소스를 참조하는 플레이스홀더 블록을 삽입합니다.
4. 항목을 제출합니다.

각 딥링크 임베드는 자체 FastComments 스레드를 생성하므로, 한 Item에 두 개의 FastComments 블록이 임베드되어 있으면 두 개의 독립된 댓글 스트림이 생성됩니다.

Visibility, Release Conditions, and Group Restrictions

FastComments 콘텐츠 항목은 그 위에 적용되는 접근 제어 규칙에 대해 다른 Blackboard 콘텐츠 항목과 동일하게 동작합니다.

• Ultra: 행의 가시성 선택기(Visible to students, Hidden from students, Conditional availability)를 클릭합니다. Conditional availability는 날짜/시간 창, 성적부 항목에 대한 성과 규칙, 강좌 그룹에 대한 구성원 규칙을 지원합니다.
• Original: 항목의 컨텍스트 메뉴를 열고 Adaptive Release 또는 Adaptive Release: Advanced를 선택하여 날짜, 구성원, 성적 또는 검토 상태로 도구를 제한합니다. 항목의 Set Group Availability를 사용하여 특정 강좌 그룹으로 제한합니다.

FastComments는 Blackboard의 게이트에서 결정한 것을 따릅니다. Blackboard가 학생에게 항목을 숨기면 해당 학생에 대해서는 LTI 런치가 전혀 발생하지 않으며 그 학생은 moderator 뷰에 나타나지 않습니다.

Gradebook Behavior

FastComments는 LTI Advantage Assignment and Grade Services를 통해 성적을 보고하지 않습니다. FastComments 콘텐츠 항목에 대해 자동으로 성적 열이 생성되지 않습니다.

기관의 Blackboard 테넌트가 채점 메타데이터와 관계없이 새 콘텐츠 항목마다 성적부 열을 자동 생성하도록 구성된 경우, 빈 열이 그래도 나타날 수 있습니다. 이를 숨기려면:

• Ultra: Gradebook을 열고 열 헤더를 클릭한 다음 Edit를 선택하고 Show to students 및 Include in calculations를 끕니다. 또는 기관에서 비채점 항목에 대한 열 삭제를 허용하면 Delete를 사용합니다.
• Original: Grade Center를 열고 열의 첼러번(chevron)을 클릭한 다음 Hide from Users (on/off)를 선택하고 선택적으로 Column Organization 아래에서 Hide from Instructor View를 선택합니다.

What Students See

학생이 FastComments 항목을 열거나 임베드된 블록으로 스크롤하면:

1. Blackboard가 FastComments로 LTI 1.3 메시지를 런치합니다. 학생은 Blackboard 신원(이름, 이메일, 아바타, 역할)을 사용하여 SSO로 로그인되며 로그인 양식을 보지 않습니다.
2. 댓글 스레드가 iframe에서 렌더링됩니다. 스레딩, 답글, 멘션 및 리액션은 FastComments에서 구성된 댓글 위젯 설정에 따라 모두 사용 가능합니다.
3. 학생의 댓글은 그들의 Blackboard 계정에 귀속됩니다. 학생이 나중에 Blackboard에서 이름이나 사진을 편집하면 다음 런치 시 FastComments 프로필이 업데이트됩니다.

Blackboard에서 FastComments로의 역할 매핑:

• System Administrator 및 Course Builder는 FastComments의 admin으로 매핑됩니다.
• Instructor 및 Teaching Assistant는 FastComments의 moderator로 매핑됩니다.
• Student, Guest, 및 Observer는 FastComments의 commenter로 매핑됩니다.

Moderator는 스레드의 모든 댓글 옆에 표시되는 핀(pin), 숨기기(hide), 차단(ban), 삭제(delete) 같은 중재 컨트롤을 보게 됩니다.

Thread Scoping

FastComments는 각 스레드를 (Blackboard host, course ID, resource link ID)로 범위를 한정합니다. 동일한 강좌 내의 두 FastComments 항목은 두 개의 스레드를 생성합니다. 동일한 항목이 두 개의 강좌 쉘에 복사된 경우(예: 강좌 복사를 통해) Blackboard가 복사 중에 새로운 resource link ID를 발급하므로 두 개의 스레드가 생성됩니다. 강좌 복사 시에도 스레드를 공유하려면, 복사하기 전에 FastComments에서 명시적 스레드 URN을 구성한 Deep Linking을 사용하십시오.

Blackboard-Specific Gotchas

FastComments 타일이 Build Content 메뉴(Original) 또는 Content Market(Ultra)에 없음. 관리자가 도구를 승인했지만 관련 배치를 차단하는 기관 정책을 남겨두었습니다. Administrator Panel > Integrations > LTI Tool Providers로 이동하여 FastComments 항목을 편집하고 Course Content Tool(Original) 및 Course Content Tool - allow students / Deep Linking content tool(Ultra) 배치가 모두 활성화되어 있는지 확인하십시오. 저장한 후 강좌 페이지를 새로고침합니다.

런치 시 "Tool not configured for this context" 또는 "Tool is not deployed" 오류. 동적 등록 중에 등록된 배포 범위가 강좌가 속한 기관 컨텍스트와 일치하지 않습니다. Blackboard의 도구 제공자 항목에서 Deployment ID가 이 테넌트의 FastComments LTI 1.3 Configuration 페이지에 표시된 값과 일치하는지 확인하십시오. 다르면 배치를 삭제하고 새 등록 URL(여기에서 가져오십시오)에서 동적 등록을 다시 실행하십시오.

Iframe 높이가 고정되어 보이거나 내용이 잘림. 일부 Blackboard 테넌트는 기본 LTI iframe-resize postMessage를 차단하는 엄격한 Content Security Policy를 적용합니다. FastComments는 호환성을 극대화하기 위해 Canvas 스타일의 lti.frameResize 메시지와 IMS 규격형 org.imsglobal.lti.frameResize 메시지 둘 다를 발신하지만, 테넌트 수준의 CSP 오버라이드가 부모 리스너를 차단합니다. 관리자에게 *.fastcomments.com이 LTI 도구 허용 목록에 포함되어 있는지와 맞춤 CSP 헤더가 postMessage 이벤트를 제거하고 있지 않은지 확인해 달라고 요청하십시오. 그러면 추가 구성 없이 리사이즈가 작동합니다.

Course copy가 스레드를 중복 생성함. Blackboard의 강좌 복사는 LTI 배치에 대해 새로운 resource link ID를 발급하므로 복사된 강좌는 빈 스레드로 시작합니다. 이는 예상된 동작입니다. 복사된 강좌가 원본 스레드를 상속받아야 하는 경우에는 복사 전에 명시적 스레드 URN으로 Deep Linking을 설정하거나 FastComments 지원팀에 문의하여 대량으로 스레드 ID를 재매핑하십시오.

학생이 런치 시 일반적인 Blackboard 오류를 봄. 원인은 누락되었거나 오래된 email 클레임일 수 있습니다. FastComments에 대한 기관 정책에서 User Fields to Send 아래에 Role, Name, Email Address가 활성화되어 있는지 확인하십시오. 저장한 다음 새 브라우저 세션에서 다시 런치해 보십시오.

"등록 토큰을 찾을 수 없거나, 만료되었거나, 이미 사용됨"

등록 URL (여기에서 확인하세요)의 토큰은 30분 동안만 유효하며 한 번만 사용할 수 있습니다. LMS에서 그보다 오래 걸렸거나 등록이 성공한 뒤 재시도된 경우 토큰이 거부됩니다. FastComments LTI 1.3 구성 페이지에서 새 URL을 생성하고 처음부터 다시 시작하세요.

"플랫폼이 등록을 거부함"

LMS가 등록 핸드셰이크를 거부했습니다. 가장 흔한 원인:

• 동일한 클라이언트 이름으로 이미 도구가 등록되어 있음. 일부 플랫폼(특히 D2L)은 이전 항목을 삭제할 때까지 "FastComments"를 두 번째로 등록하는 것을 거부합니다. LMS에서 이전 도구를 제거한 다음 다시 시도하세요.
• LMS의 잘못된 필드. URL을 런치 URL이나 로그인 URL 필드가 아닌 registration / tool initiation registration endpoint 필드에 붙여넣었는지 확인하세요.
• LMS가 실제로 Dynamic Registration을 지원하지 않음. 이전 버전의 Moodle 및 Blackboard는 LTI 1.3을 광고하지만 수동 구성만 허용합니다. 플랫폼 설명서를 확인하세요.

"플랫폼 구성 가져오기 실패"

FastComments가 LMS의 openid-configuration 문서를 읽지 못했습니다. 이는 드물며 일반적으로 LMS가 잘못되었거나 접근할 수 없는 discovery URL을 제공했음을 의미합니다. LMS 지원팀에 문의하세요.

런치에 "구성을 찾을 수 없음" 표시

FastComments의 구성이 삭제되었거나, 런치가 우리가 인식하지 못하는 iss/client_id 쌍에서 왔을 수 있습니다. 삭제 후 다시 등록했다면, LMS에 FastComments 도구를 제거했다가 다시 추가하도록 지시하여 새 client_id를 받도록 하세요.

런치에 "배포가 등록되지 않음" 표시

FastComments를 처음 런치한 것과 다른 Brightspace/Moodle/Blackboard 배포에서 FastComments를 실행했습니다. FastComments는 첫 런치 시 보안 확인을 위해 deployment_id를 고정합니다. 동일한 클라이언트 아래에 새 배포를 추가하려면 지원팀에 문의하세요 — 저희가 구성에 해당 deployment ID를 추가해 드립니다.

런치에 "지원되지 않는 message_type" 표시

LMS가 FastComments가 처리하지 않는 LTI 메시지(예: LtiSubmissionReviewRequest)를 보냈습니다. FastComments는 표준 resource-link 런치 및 deep-linking 흐름만 지원합니다. 특정 메시지 타입 추가가 필요하면 문의하세요.

Iframe 크기 조정이 되지 않음

대부분의 LMS는 LTI iframe을 자동으로 크기 조정합니다. 귀하의 LMS가 자동 조정하지 않는 경우, LMS의 런치 설정이 도구가 부모 프레임으로 postMessage 이벤트를 보낼 수 있도록 허용하는지 확인하세요. FastComments는 Canvas-style (lti.frameResize) 및 IMS-spec (org.imsglobal.lti.frameResize) 리사이즈 메시지 둘 다를 전송합니다.