Dodaj komentarze do swojego LMS za pomocą LTI 1.3

1. Zaloguj się do FastComments i przejdź do your LTI 1.3 Configuration page.
2. (Opcjonalnie) Wybierz platformę, z której się łączysz, z rozwijanego menu Platform — ustawia ona etykietę wyświetlaną, ale Auto-detect działa dobrze.
3. Kliknij Generate URL. Pojawi się jednorazowy Registration URL (ważny przez 30 minut, do jednorazowego użycia).
4. W swoim LMS otwórz ekran LTI 1.3 Dynamic Registration i wklej adres URL do pola Tool initiation registration endpoint (lub ekwiwalentnego). Zatwierdź.
5. Twój LMS wywoła FastComments, wymieni klucze i utworzy integrację. Okienko zamknie się samo po zakończeniu.
6. Po powrocie do FastComments nowa konfiguracja pojawi się w tabeli Existing Configurations. Narzędzie jest teraz dostępne w kursach twojego LMS.

FastComments LTI 1.3 został przetestowany w:

• D2L Brightspace (dowolna wersja z LTI Advantage)
• Moodle 4.0+ (wtyczka External Tool, LTI Advantage)
• Blackboard Learn (SaaS i Ultra)
• Sakai (wersje z obsługą LTI Advantage)
• Schoology (Enterprise, Dynamic Registration jeśli dostępne)

Każdy inny LMS, który implementuje specyfikację IMS LTI 1.3 Advantage z Dynamic Registration, powinien również działać - wybierz Other LTI 1.3 platform z rozwijanego menu platform podczas generowania Twojego URL rejestracji (uzyskaj go tutaj).

Canvas LMS używa innego procesu konfiguracji (per-developer-key configuration JSON zamiast Dynamic Registration). Zobacz dedykowany przewodnik instalacji Canvas LMS.

Przejdź do konfiguracji LTI 1.3

Zaloguj się do FastComments i przejdź do swojej strony konfiguracji LTI 1.3.

If your account doesn't yet have LTI access, you'll see "LTI not enabled for this account" - contact support to enable it on your plan.

Wybierz platformę (opcjonalnie)

W sekcji Generate a Dynamic Registration URL użyj rozwijanego menu Platform, aby poinformować FastComments, z którym LMS się łączysz:

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

Możesz też zostawić ustawienie Automatyczne wykrywanie. Platforma jest odczytywana z openid-configuration Twojego LMS podczas rejestracji; rozwijane menu tylko ustawia etykietę wyświetlaną dla powstałej konfiguracji.

Wygeneruj URL

Kliknij Generate URL. FastComments tworzy jednorazowy token rejestracyjny i pokazuje URL wyglądający tak:

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

Skopiuj go. Ten URL:

• Jest jednorazowy - po tym, jak Twój LMS wywoła go pomyślnie, token zostaje użyty.
• Wygasa po 30 minutach, jeśli nie zostanie użyty.
• Powinien być przechowywany w tajemnicy - każdy, kto ma ten URL, może zarejestrować narzędzie względem Twojego tenanta w ciągu tych 30 minut.

Istniejące konfiguracje

Po pomyślnej rejestracji nowa konfiguracja pojawi się w tabeli Existing Configurations na tej samej stronie, z informacjami o Platform, Issuer, Client ID i Status. Możesz usuwać konfiguracje z tej tabeli, jeśli kiedykolwiek będziesz potrzebować wyrejestrować usługę.

D2L Brightspace udostępnia Dynamic Registration za pośrednictwem interfejsu administracyjnego LTI Advantage. Wymagany jest dostęp administratora.

Otwórz ekran rejestracji

1. Zaloguj się do swojej instancji Brightspace jako administrator.
2. Przejdź do Admin Tools > Manage Extensibility > LTI Advantage.
3. Kliknij Register Tool. (The direct URL is https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Wklej URL

Zobaczysz formularz rejestracji. Kluczowe pole to punkt końcowy rejestracji inicjacji narzędzia (w niektórych wersjach Brightspace oznaczane jako "URL rejestracji inicjacji narzędzia").

Wklej adres rejestracyjny FastComments (pobierz go tutaj) do tego pola. Pozostaw pozostałe pola puste - są automatycznie wypełniane przez FastComments podczas wymiany rejestracyjnej.

Kliknij Register.

Zatwierdź narzędzie

Brightspace otworzy wyskakujące okno, które komunikuje się z FastComments, wymieni klucze i pokaże ekran potwierdzenia. Wyskakujące okno zamknie się automatycznie po zakończeniu rejestracji.

Nowe narzędzie pojawi się na liście narzędzi LTI Advantage. Domyślnie Brightspace oznacza nowe narzędzia jako wyłączone - przestaw przełącznik na włączone, aby Twoje kursy mogły z niego korzystać.

Dodaj wdrożenie

W Brightspace narzędzia LTI wymagają wdrożenia, zanim będą mogły być używane w kursach:

1. Otwórz nowo zarejestrowane narzędzie FastComments.
2. Kliknij View Deployments > New Deployment.
3. Nadaj wdrożeniu nazwę (np. "FastComments - All Courses"), wybierz jednostki organizacyjne, w których ma być dostępne, i zapisz.

Po pierwszym uruchomieniu poprzez to wdrożenie FastComments przypisze deployment_id do swojego rekordu konfiguracyjnego - kolejne uruchomienia z innego wdrożenia dla tego samego klienta zostaną odrzucone, chyba że ponownie zarejestrujesz.

Używasz Moodle? Publikujemy także dedykowaną wtyczkę Moodle dla FastComments z głębszą integracją niż LTI 1.3 (hooki synchronizacji ocen, rozbudowane raportowanie aktywności, natywne UI ustawień Moodle). Zobacz poradnik instalacji wtyczki Moodle. Schemat LTI 1.3 poniżej jest właściwy, jeśli chcesz pojedynczej rejestracji obejmującej też inne LMS-y, albo jeśli administrator Moodle nie zainstaluje wtyczek firm trzecich.

Moodle 4.0+ obsługuje dynamiczną rejestrację LTI 1.3 poprzez wtyczkę Narzędzie zewnętrzne.

Otwórz ekran zarządzania narzędziem

1. Zaloguj się do Moodle jako administrator witryny.
2. Przejdź do Administracja witryną > Wtyczki > Moduły aktywności > Narzędzie zewnętrzne > Zarządzaj narzędziami.

Wklej adres URL

Zobaczysz kartę oznaczoną Adres URL narzędzia. Wklej adres rejestracyjny FastComments (uzyskaj go tutaj) do pola tekstowego i kliknij Dodaj LTI Advantage.

Moodle otworzy ekran rejestracji pokazujący tożsamość narzędzia i żądane uprawnienia. Sprawdź i kliknij Aktywuj (lub Zarejestruj, w zależności od wersji Moodle).

Okno dialogowe zamknie się po zakończeniu rejestracji; nowe narzędzie FastComments pojawi się na liście Narzędzia ze statusem Aktywny.

Udostępnij

Domyślnie Moodle dodaje nowe narzędzia do listy „Narzędzia kursu”, ale nie pokazuje ich w wyborze aktywności. Aby udostępnić FastComments w całym kursie:

1. Kliknij ikonę zębatki na kafelku FastComments.
2. W sekcji Użycie konfiguracji narzędzia wybierz Pokaż w wyborze aktywności i jako wstępnie skonfigurowane narzędzie.
3. Zapisz.

Prowadzący mogą teraz dodać FastComments do dowolnego kursu poprzez Dodaj aktywność lub zasób > FastComments.

Blackboard Learn SaaS i Ultra obsługują Dynamiczną rejestrację LTI 1.3.

Otwórz ekran dostawcy narzędzia

1. Zaloguj się do Blackboard jako administrator systemu.
2. Przejdź do Panel administratora > Integracje > Dostawcy narzędzi LTI.
3. Kliknij Zarejestruj narzędzie LTI 1.3 / LTI Advantage.

Jeśli widzisz tylko 'Zarejestruj dostawcę LTI 1.1', Twoja wersja Blackboard nie obsługuje jeszcze LTI 1.3 — zaktualizuj ją lub skontaktuj się z pomocą techniczną Blackboard.

Wklej adres URL

Wklej adres rejestracyjny FastComments (pobierz go tutaj) w pole ID klienta / Adres URL rejestracji (etykietowanie w Blackboard różni się w zależności od wersji). Zatwierdź.

Blackboard przeprowadzi procedurę rejestracji z FastComments i wyświetli ekran potwierdzenia.

Zatwierdź i włącz

Blackboard domyślnie oznacza nowo zarejestrowane narzędzia jako Zatwierdzone, ale wykluczone:

1. Znajdź wpis FastComments na liście dostawców narzędzi.
2. Otwórz menu i wybierz Edytuj.
3. Ustaw Status narzędzia na Zatwierdzone.
4. W sekcji Zasady instytucji sprawdź, jakie dane użytkownika są przesyłane (imię i nazwisko, adres e-mail, rola). Zapisz.

Narzędzie jest teraz dostępne dla prowadzących, gdy dodają treści do kursów.

Sakai

Sakai obsługuje Dynamiczną Rejestrację LTI 1.3 w wydaniach z LTI Advantage. Z poziomu Obszaru administracyjnego:

1. Zaloguj się jako administrator Sakai i otwórz Obszar administracyjny.
2. Wybierz Narzędzia zewnętrzne > Zainstaluj narzędzie LTI 1.3.
3. Wklej adres rejestracyjny FastComments (uzyskaj go tutaj) i wyślij.
4. Zatwierdź narzędzie po zakończeniu procedury nawiązywania połączenia (handshake).

Narzędzie pojawi się następnie w Narzędziach zewnętrznych i może być dodane do witryn przez ich opiekunów.

Schoology

Instancje Schoology Enterprise obsługują LTI 1.3, ale dostępność rejestracji dynamicznej różni się w zależności od wdrożenia. Skonsultuj się ze swoim opiekunem konta Schoology.

Jeśli rejestracja dynamiczna nie jest dostępna na Twojej instancji Schoology, będziesz musiał skonfigurować integrację ręcznie, używając następujących punktów końcowych:

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

Po otrzymaniu od Schoology identyfikatora klienta (Client ID) i identyfikatora wdrożenia (Deployment ID), skontaktuj się z pomocą techniczną FastComments, aby zarejestrować konfigurację na swojej instancji.

Inne platformy LTI 1.3

Każdy LMS, który przestrzega specyfikacji IMS LTI 1.3 Advantage, powinien działać z tym samym adresem rejestracyjnym (uzyskaj go tutaj). Szukaj ustawienia oznaczonego jako "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" lub podobnego.

Jeśli Twoja platforma obsługuje jedynie ręczną konfigurację LTI 1.3, użyj czterech punktów końcowych wymienionych w sekcji Schoology powyżej i skontaktuj się z pomocą techniczną, aby dokończyć konfigurację.

Ta strona opisuje dodawanie FastComments do kursu Brightspace po tym, jak administrator zarejestrował narzędzie i utworzył wdrożenie. Jeśli narzędzie nie zostało jeszcze zarejestrowane, najpierw zobacz przewodnik rejestracji D2L.

FastComments osadzony jako temat jednostki w Brightspace

Brightspace oferuje dwa środowiska tworzenia treści: Classic Content oraz New Content Experience (również nazywane Lessons). Oba umożliwiają korzystanie z FastComments, lecz ścieżki w menu się różnią. Każda z poniższych sekcji opisuje oba przypadki tam, gdzie się rozchodzą.

Zlokalizuj narzędzie FastComments

Narzędzie FastComments pojawia się w dwóch miejscach w edytorze zawartości kursu:

1. W selektorze aktywności, dostępnym z przycisku modułu/jednostki Add Existing (w starszych wersjach Brightspace oznaczonym jako Add Existing Activities). W aktualnych wersjach Brightspace FastComments pojawia się bezpośrednio w selektorze; w starszych wersjach znajduje się w podmenu External Learning Tools. Każda z dróg dodaje FastComments jako samodzielny temat.
2. W oknie dialogowym Insert Stuff w edytorze HTML, pod LTI Advantage. To osadza FastComments inline w temacie HTML za pomocą przepływu deep linking LTI.

Jeśli FastComments nie pojawia się w żadnym z selektorów, wdrożenie nie jest włączone dla jednostki organizacyjnej (org unit) zawierającej kurs. Poproś administratora Brightspace o przejście do Admin Tools > Manage Extensibility > LTI Advantage > narzędzie FastComments > View Deployments, otwarcie wdrożenia i dodanie jednostki organizacyjnej kursu (lub jednostki nadrzędnej) w sekcji Org Units.

Dodaj FastComments jako temat w module

Classic Content:

1. Otwórz kurs i kliknij Content w pasku nawigacyjnym.
2. Wybierz moduł, który ma zawierać dyskusję (lub utwórz nowy przez Add a module).
3. Kliknij Add Existing (starszy Brightspace: Add Existing Activities > External Learning Tools).
4. W selektorze kliknij FastComments. Brightspace tworzy temat w module i wraca do widoku zawartości.
5. Kliknij nowy temat. Zmień nazwę na coś opisowego, np. FastComments Discussion, używając edytora tytułu inline.

New Content Experience (Lessons):

1. Otwórz kurs i kliknij Content.
2. Otwórz jednostkę i lekcję, która ma zawierać dyskusję.
3. Kliknij Add > Existing Activity i wybierz FastComments (starszy Brightspace: zagnieżdżone pod External Learning Tools).
4. Aktywność zostanie dodana do lekcji.
5. Kliknij tytuł aktywności, aby go zmienić.

Za pierwszym razem, gdy którykolwiek użytkownik (instruktor lub student) otworzy temat, FastComments inicjalizuje wątek dla tego resource link. Wątek jest powiązany z identyfikatorem resource link, więc zmiana nazwy lub przeniesienie tematu nie zmienia wczytywanego wątku.

Osadź FastComments inline w temacie HTML

Użyj tego przepływu, gdy chcesz, aby komentarze pojawiały się poniżej materiału do przeczytania, wideo lub innej zawartości w tej samej stronie tematu, zamiast jako oddzielny temat.

1. Otwórz lub utwórz temat HTML w module/lekcji.
2. Kliknij Edit HTML, aby otworzyć edytor HTML Brightspace.
3. Umieść kursor w miejscu, gdzie ma się pojawić wątek komentarzy.
4. Kliknij przycisk Insert Stuff (ikonka puzzla na pasku narzędzi edytora).
5. W oknie Insert Stuff przewiń do LTI Advantage i kliknij FastComments.
6. FastComments otworzy selektor deep linking. Potwierdź miejsce umieszczenia (domyślne opcje działają dla dyskusji z treści); kliknij Insert lub Continue.
7. Brightspace wróci do edytora HTML z blokiem zastępczym reprezentującym uruchomienie LTI. Kliknij Save and Close w temacie.

Gdy temat się załaduje, Brightspace zastąpi blok zastępczy iframe’em, który automatycznie uruchomi FastComments przez LTI. Studenci zobaczą wątek dyskusji inline.

Pojedynczy temat HTML może zawierać wiele deep-linked osadzeń FastComments. Każde osadzenie otrzymuje własny wątek, ponieważ każdy deep link generuje odrębny identyfikator resource link.

Temat modułu vs osadzenie inline (Quicklink)

Wybierz podejście temat modułu, gdy:

• Dyskusja jest główną aktywnością dla tego kroku w module.
• Chcesz, aby temat pojawiał się w spisie treści Brightspace, w śledzeniu ukończeń i w Class Progress.

Wybierz podejście osadzenia inline, gdy:

• Komentarze powinny znajdować się pod inną treścią na tej samej stronie.
• Nie chcesz oddzielnego elementu śledzonego w spisie treści.

Widoczność, wersja robocza i warunki publikacji

Nowy temat FastComments jest domyślnie widoczny dla studentów. Aby go ukryć podczas konfiguracji:

1. W edytorze zawartości kliknij tytuł tematu (Classic) lub menu trzech kropek przy aktywności (New Content Experience).
2. Ustaw status na Draft (Classic) lub wyłącz przełącznik Visibility (New Content Experience).

Tematy w wersji roboczej są niewidoczne dla studentów. Instruktorzy i asystenci dydaktyczni nadal widzą je z odznaką "Draft".

Aby ograniczyć temat do konkretnej grupy lub sekcji:

1. Otwórz temat.
2. Kliknij menu tytułu tematu > Edit Properties In-place (Classic) lub Edit > Restrictions (New Content Experience).
3. W sekcji Release Conditions kliknij Create.
4. Wybierz Group enrollment lub Section enrollment, wybierz grupę/sekcję i zapisz.

Warunki publikacji sumują się z mapowaniem ról FastComments. Studenci, którzy nie widzą tematu, nie otrzymują uruchomienia LTI.

Co widzą studenci przy pierwszym uruchomieniu

Gdy student kliknie temat (lub załaduje temat HTML z osadzeniem):

1. Brightspace wykonuje uruchomienie LTI 1.3 w tle.
2. FastComments otrzymuje imię i nazwisko studenta, e-mail, URL avatara oraz rolę w LMS i automatycznie loguje go. Nie pojawia się monit logowania do FastComments.
3. Wątek komentarzy dla tego resource link renderuje się wewnątrz iframe Brightspace.

Mapowanie ról przy uruchomieniu:

• Brightspace Administrator staje się w FastComments administratorem wątku (pełne uprawnienia do moderacji, usuwania, banowania i dostępu do konfiguracji).
• Brightspace Instructor staje się w FastComments moderatorem (pin, ukrywanie, usuwanie, banowanie).
• Wszystkie inne role (Learner, TeachingAssistant itp.) stają się zwykłymi komentującymi.

Komentarze są przypisywane do konta Brightspace studenta. Jeśli student zmieni swoje imię lub avatar w Brightspace, następne uruchomienie LTI zsynchronizuje zmianę.

Zabezpiecz publiczny dostęp (zalecane)

Domyślnie dane komentarzy FastComments są publicznie odczytywalne. Każdy, kto potrafi odgadnąć URL wątku lub punkt końcowy API, może zobaczyć komentarze, także poza Brightspace. W przypadku dyskusji kursowych niemal na pewno chcesz ograniczyć przeglądanie tylko do zapisanych uczestników.

Otwórz swoją stronę dostosowywania widgetu i utwórz regułę z włączoną opcją Require SSO To View Comments, następnie ustaw poziom zabezpieczeń na Secure SSO, aby wątki mogły być ładowane tylko przez podpisane uruchomienie LTI.

Zobacz Protecting Comment Threads With Single-Sign-On po pełny przewodnik, w tym jak ograniczyć regułę do pojedynczej domeny lub strony.

Wysokość iframe i zmiana rozmiaru

FastComments wysyła postMessage org.imsglobal.lti.frameResize przy każdym renderowaniu wątku i przy zmianach zawartości (nowy komentarz, rozwinięcie odpowiedzi). Brightspace nasłuchuje tego komunikatu i dostosowuje wysokość iframe, aby wątek nie był przycinany i nie pokazywał wewnętrznego paska przewijania.

Jeśli iframe pozostaje na stałej małej wysokości:

• Upewnij się, że kurs ładuje się przez HTTPS. Nasłuchiwacz postMessage Brightspace odrzuca ramki mieszanej zawartości.
• Upewnij się, że żadna wtyczka przeglądarki nie blokuje kanału postMessage.
• Dla osadzeń inline w temacie HTML, otaczający HTML nie może owijać iframe’a w kontener o stałej wysokości. Usuń wszelkie inline style="height: ..." z elementu nadrzędnego.

Specyficzne problemy w Brightspace

Narzędzie nie pokazuje się w selektorze Add Existing. Wdrożenie nie jest włączone dla jednostki organizacyjnej tego kursu. Administrator musi dodać jednostkę organizacyjną (lub jednostkę nadrzędną) do listy Org Units wdrożenia. Sama rejestracja narzędzia nie wystarczy; wdrożenie określa, które kursy widzą narzędzie.

Niepasujący deployment_id przy uruchomieniu. FastComments zapamiętuje (TOFU) pierwszy deployment_id, który zobaczy przy rejestracji. Jeśli administrator usunie oryginalne wdrożenie i stworzy nowe, uruchomienia z nowego wdrożenia będą odrzucane z błędem niezgodności deployment. Rozwiązaniem jest ponowna rejestracja FastComments (wygenerowanie nowego URL rejestracji (pobierz go tutaj) i ponowne uruchomienie Dynamic Registration); stary rekord konfiguracji zostanie zastąpiony.

Narzędzie uruchamia się, ale pokazuje "Invalid LTI launch". Kurs znajduje się w innej strukturze tenant/organizacji niż ta, którą obejmuje wdrożenie, lub wdrożenie zostało wyłączone po rejestracji. Sprawdź ponownie Admin Tools > Manage Extensibility > LTI Advantage > FastComments > przełącznik Enabled oraz listę jednostek organizacyjnych wdrożenia.

Brakuje imion i ról w FastComments. Brightspace wysyła uruchomienia LTI z roszczeniami Names and Role Provisioning Services (NRPS). Jeśli kurs został zaktualizowany ze starszego linku LTI 1.1, uruchomienie może nie zawierać roszczeń name i email. Dodaj ponownie temat FastComments przez Add Existing (nie migruj starego linku), aby uruchomienie używało LTI 1.3.

Osadzenie pokazuje ekran logowania zamiast auto-SSO. Temat HTML został wstawiony jako zwykły <iframe> wskazujący na FastComments zamiast przez Insert Stuff > LTI Advantage. Zwykłe iframe’y pomijają uruchomienie LTI i kierują użytkowników na publiczną stronę FastComments. Usuń iframe i ponownie wstaw go przez przepływ Insert Stuff.

Ten przewodnik opisuje dodawanie FastComments do kursu Moodle 4.x po tym, jak administrator witryny zarejestrował narzędzie i ustawił je tak, aby było widoczne w wyborze aktywności. Jeśli FastComments nie jest jeszcze zarejestrowany, najpierw zobacz przewodnik rejestracji Moodle.

Otwórz kurs w trybie edycji

1. Zaloguj się do Moodle jako Editing Teacher (lub wyżej) dla danego kursu.
2. Otwórz kurs.
3. Włącz przełącznik Edit mode w prawym górnym rogu nagłówka kursu.

Moodle 4.x zastąpił stare rozwijane menu "Add an activity or resource" z wersji 3.x dialogiem wyboru aktywności na pełnym ekranie. Moodle 4.5 zachowuje ten sam wybór, ale dodaje wiersz z ulubionymi/oznaczonymi gwiazdką na górze, więc przypięcie FastComments raz ułatwia jego znalezienie w kolejnych sekcjach.

Dodaj aktywność FastComments

1. Przewiń do sekcji kursu (temat lub tydzień), w której powinna się znajdować dyskusja.
2. Kliknij Add an activity or resource na dole tej sekcji.
3. W oknie wyboru wybierz FastComments. Jeśli go nie widzisz, przejdź do sekcji o problemach poniżej.

Otworzy się formularz ustawień aktywności. Pola, które mają znaczenie:

• Activity name (wymagane). Wyświetlane na stronie kursu i w dzienniku ocen. Przykład: Week 3 Discussion.
• Activity description. Opcjonalny tekst wprowadzający renderowany nad wątkiem komentarzy.
• Show description on course page. Zaznacz to, jeśli chcesz, aby opis był widoczny bez konieczności wchodzenia do aktywności.
• Preconfigured tool. Ustawione na FastComments (automatycznie wybrane po uruchomieniu z wybieraka). Nie zmieniaj.
• Launch container. Ustaw na New window. Zobacz sekcję o problemach, dlaczego opcja "Same window" może powodować błędy w niektórych wdrożeniach Moodle.
• Tool URL, Public key, Shared secret, Custom parameters. Pozostaw puste. Dynamic Registration obsłużyło to na poziomie witryny.

Przewiń na dół i kliknij Save and return to course (lub Save and display, aby od razu otworzyć aktywność).

Aktywność pojawi się jako wiersz w sekcji z ikoną FastComments. Studenci klikają wiersz, aby otworzyć wątek komentarzy.

Osadź FastComments inline w edytorze

Dla wątku wewnątrz Page, rozdziału Book, Lesson lub dowolnego innego zasobu używającego edytora Atto lub TinyMCE:

1. Otwórz zasób w trybie edycji.
2. Umieść kursor w miejscu, gdzie powinien pojawić się wątek.
3. W pasku narzędzi edytora kliknij przycisk LTI / External tool. W Atto jest oznaczony jako "Insert LTI Advantage content". W TinyMCE (domyślnie w Moodle 4.3+) znajduje się w menu More jako External tools.
4. Wybierz FastComments z listy narzędzi.
5. FastComments otworzy wybierak deep-linking. Potwierdź tytuł wątku i kliknij Embed.
6. Edytor wstawia blok zastępczy LTI. Zapisz zasób.

Każda osadzona instancja to odrębny wątek identyfikowany na podstawie ID elementu deep-link, więc strona Page z trzema osadzeniami FastComments będzie miała trzy niezależne wątki.

Ograniczenia dostępu i ustawienia grup

Standardowe ustawienia aktywności Moodle mają zastosowanie do aktywności FastComments:

• Common module settings > Group mode. Ustawienie na Separate groups lub Visible groups nie dzieli automatycznie FastComments na wątki per grupa. Tryb grup w Moodle jedynie filtruje dziennik ocen i listę członków. Aby uruchomić oddzielny wątek dla każdej grupy, dodaj po jednej aktywności FastComments dla każdej grupy i użyj Restrict access, aby ograniczyć zasięg każdej z nich.
• Restrict access > Add restriction. Obsługuje standardowe warunki Moodle: Date, Grade, Group, Grouping, User profile oraz zagnieżdżone zestawy ograniczeń. Użyj Group, aby przypisać aktywność FastComments do jednej grupy.
• Activity completion. Ustaw na Students must view this activity to complete it, jeśli chcesz śledzić ukończenie. FastComments obecnie nie zgłasza do Moodle zdarzenia ukończenia poza uruchomieniem.

Mapowanie ról

FastComments odczytuje roszczenie roles LTI, które Moodle wysyła przy każdym uruchomieniu i mapuje je w następujący sposób:

• Moodle Manager lub Site administrator -> FastComments admin
• Moodle Editing teacher lub Non-editing teacher -> FastComments moderator
• Moodle Student -> FastComments commenter
• Moodle Guest -> tylko do odczytu

Administratorzy mogą usuwać dowolne komentarze, blokować użytkowników i edytować ustawienia wątku. Moderatorzy mogą usuwać i zatwierdzać komentarze wewnątrz wątku, do którego zostali uruchomieni. Niestandardowe role Moodle dziedziczą mapowanie archetypu, od którego zostały sklonowane.

Co widzą studenci

Studenci klikają aktywność FastComments (lub przewijają do osadzonego bloku wewnątrz Page lub Book). Moodle wysyła ich tożsamość do FastComments za pomocą uruchomienia LTI:

• Brak ekranu logowania. FastComments loguje ich przy użyciu konta Moodle.
• Ich nazwa wyświetlana, e-mail i avatar pochodzą z Moodle.
• Wątek jest ograniczony do (Moodle site, course, resource link ID), więc ta sama aktywność zduplikowana w innym kursie otrzymuje nowy wątek.
• Odpowiedzi w wątkach, głosowanie i powiadomienia działają tak samo, jak w samodzielnym wątku FastComments.

Zablokuj publiczny dostęp (zalecane)

Domyślnie dane komentarzy FastComments są publicznie czytelne. Każdy, kto potrafi odgadnąć URL wątku lub punkt końcowy API, może przeglądać jego komentarze, nawet poza Moodle. Dla dyskusji kursowych prawie na pewno chcesz ograniczyć podgląd tylko do zapisanych studentów.

Otwórz swoją stronę dostosowywania widgetu i utwórz regułę z włączoną opcją Require SSO To View Comments, a następnie ustaw poziom bezpieczeństwa na Secure SSO, aby wątki mogły być ładowane tylko przez podpisane uruchomienie LTI.

Zobacz Protecting Comment Threads With Single-Sign-On po pełny przewodnik krok po kroku, w tym jak ograniczyć regułę do pojedynczej domeny lub strony.

Problemy Moodle

Brak FastComments w wyborze aktywności. Administrator witryny zarejestrował narzędzie, ale nie ustawił Tool configuration usage na Show in activity chooser and as a preconfigured tool. Napraw to w Site administration > Plugins > Activity modules > External tool > Manage tools > ikona koła zębatego na kafelku FastComments.

Uruchomienie kończy się niepowodzeniem lub pokazuje puste okno, gdy ustawione na "Same window". Ciasteczka sesyjne Moodle używają domyślnie SameSite=Lax, a niektóre przeglądarki usuwają je podczas cross-site POST, którego używa LTI 1.3, aby wrócić z FastComments. Ustaw Launch container na New window przy aktywności. To twardy wymóg dla osadzonego FastComments wewnątrz Page lub Book, ponieważ ścieżka uruchamiania osadzona przez edytor zawsze otwiera nowe okno.

Roszczenie iss to URL strony Moodle, a nie identyfikator tenanta. FastComments używa URL strony Moodle (wartość konfiguracyjna wwwroot) jako wydawcy LTI. Jeśli Twoja instancja Moodle zostanie przeniesiona na nową domenę lub zmienisz wwwroot, istniejące wątki FastComments pozostaną powiązane ze starym wydawcą i nie będą pasować do nowych uruchomień. Zarejestruj narzędzie ponownie dla nowego URL i w razie potrzeby przenieś wątki przez panel administracyjny FastComments.

Kopia zapasowa i przywracanie aktywności. Wykonanie kopii zapasowej kursu i przywrócenie go do nowego kursu tworzy nowe ID resource link, więc przywrócone aktywności FastComments zaczynają z pustymi wątkami. Oryginalny kurs zachowuje oryginalne wątki. To zamierzone zachowanie, a nie błąd.

TinyMCE jako domyślny w Moodle 4.5. Moodle 4.5 jest dostarczany z TinyMCE jako domyślnym edytorem dla nowych instalacji. Przycisk External tool znajduje się w menu More (...) zamiast na głównym pasku narzędzi. Starsze witryny zaktualizowane z 4.1 zachowują Atto, chyba że administrator zmienił domyślny edytor.

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. Open the course and go to the Course Content page.
2. Hover or tap where you want the comment thread to land in the outline and click the purple + (Add content) button.
3. Choose Content Market. The Content Market panel lists every approved LTI tool and Building Block placement for your institution.
4. Find the FastComments tile and click it. Blackboard creates a content item at the position where you opened the + menu.
5. The item lands in the outline as a "Visible to students" entry by default for instructors who have Hide from students off as their personal default. If your default is Hidden, the item is created hidden and you flip the visibility selector on the item row when you're ready.
6. To rename the item, click the title in the outline and type a new label. The title students see in the outline is independent of the FastComments thread identifier, so renaming is safe at any time.

If you don't see Content Market as an option, your institution has the placement hidden. You also reach the same picker through More tools in the same + menu under the LTI Tools group.

Original Course View

Original Course View is still supported in Learn SaaS and remains the primary experience for self-hosted Learn 9.1 sites on the Q4 2024 CU release line.

1. Open the course and enter a Content Area (for example, the default Information or Content area in the course menu).
2. Turn Edit Mode on with the toggle in the top-right of the page.
3. Click Build Content in the action bar.
4. Under the Learning Tools submenu, click FastComments. The Learning Tools submenu is populated from LTI 1.3 tool placements after an administrator registers the tool. If you don't see it, see the gotchas section below.
5. On the Create FastComments form, set:
   • Name: the label students see in the content area.
   • Description: optional text shown above the embedded thread.
   • Permit Users to View this Content: Yes/No availability toggle.
   • Track Number of Views: enable if you want Blackboard's per-item view statistics. FastComments runs its own analytics independently.
   • Date and Time Restrictions: optional Display After / Display Until windows.
6. Submit. The tool appears as a clickable item in the content area.

Embedding Inside an Item or Document

In both course views, instructors embed FastComments inline inside the body of an Item, Document, or any rich-text field through the Content Editor's LTI Advantage button.

Ultra Course View:

1. Create or edit a Document.
2. Click Add content inside the document body where you want the thread to appear.
3. In the editor toolbar, open the Insert content menu and click Content Market (the LTI Advantage / Deep Linking entry point).
4. Pick FastComments. FastComments returns a deep-link payload and Blackboard inserts an embedded block in the document body at the cursor position.
5. Save the document. Students see the thread rendered inline as they scroll past it.

Original Course View:

1. Edit any item with a rich-text body.
2. In the Content Editor toolbar, click the Add Content plus icon and choose Content Market (labeled Add Content from External Tool in older Q4 2024 CUs).
3. Pick FastComments. The editor inserts a placeholder block referencing the deep-linked resource.
4. Submit the item.

Each deep-link embed produces its own FastComments thread, so an Item with two embedded FastComments blocks has two independent comment streams.

Visibility, Release Conditions, and Group Restrictions

FastComments content items behave like any other Blackboard content item for the access control rules layered on top of them.

• Ultra: click the visibility selector on the row (Visible to students, Hidden from students, Conditional availability). Conditional availability supports date/time windows, performance rules against gradebook items, and member rules against course groups.
• Original: open the item's context menu and choose Adaptive Release or Adaptive Release: Advanced to gate the tool by date, membership, grade, or review status. Use Set Group Availability on the item to restrict to specific course groups.

FastComments respects whatever Blackboard's gate decides. If Blackboard hides the item from a student, the LTI launch never happens for that student and they don't appear in the moderator view.

Gradebook Behavior

FastComments does not report grades back over LTI Advantage Assignment and Grade Services. No grade column is auto-created for FastComments content items.

If your Blackboard tenant is configured to auto-create a gradebook column for every new content item regardless of grading metadata, an empty column appears anyway. To hide it:

• Ultra: open the Gradebook, click the column header, choose Edit, and turn off Show to students plus Include in calculations. Or use Delete if your institution permits column deletion for ungraded items.
• Original: open the Grade Center, click the column's chevron, choose Hide from Users (on/off), and optionally Hide from Instructor View under Column Organization.

What Students See

When a student opens the FastComments item or scrolls to an embedded block:

1. Blackboard launches the LTI 1.3 message to FastComments. The student is signed in via SSO using their Blackboard identity (name, email, avatar, role) without seeing a login form.
2. The comment thread renders in the iframe. Threading, replies, mentions, and reactions are all available based on the comment widget settings configured in FastComments.
3. Their comments are attributed to their Blackboard account. If the student edits their name or photo in Blackboard later, the next launch updates the FastComments profile.

Role mapping from Blackboard to FastComments:

• System Administrator and Course Builder map to FastComments admin.
• Instructor and Teaching Assistant map to FastComments moderator.
• Student, Guest, and Observer map to FastComments commenter.

Moderators see moderation controls (pin, hide, ban, delete) inline on every comment in the thread.

Lock Down Public Access (Recommended)

By default, FastComments comment data is publicly readable. Anyone who can guess a thread's URL or API endpoint can view its comments, even outside Blackboard. For course discussions you almost certainly want to restrict viewing to enrolled students only.

Open your widget customization page and create a rule with Require SSO To View Comments enabled, then set the security level to Secure SSO so threads can only be loaded through the signed LTI launch.

See Protecting Comment Threads With Single-Sign-On for the full walkthrough, including how to scope the rule to a single domain or page.

Thread Scoping

FastComments scopes each thread by (Blackboard host, course ID, resource link ID). Two FastComments items in the same course produce two threads. The same item copied across two course shells (for example, through course copy) produces two threads, because Blackboard issues a fresh resource link ID during the copy. To keep a shared thread across course copies, use Deep Linking with an explicit thread URN configured in FastComments before launching the copy.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). The administrator approved the tool but left an institution policy blocking the relevant placement. Go to Administrator Panel > Integrations > LTI Tool Providers, edit the FastComments entry, and confirm both Course Content Tool (Original) and Course Content Tool - allow students / Deep Linking content tool (Ultra) placements are enabled. Save and refresh the course page.

"Tool not configured for this context" or "Tool is not deployed" error on launch. The deployment scope registered during dynamic registration doesn't match the institution context the course belongs to. In Blackboard's tool provider entry, verify the Deployment ID matches what FastComments shows on its LTI 1.3 Configuration page for this tenant. If they differ, delete the placement and re-run dynamic registration from a fresh registration URL (get it here).

Iframe height looks fixed or content gets cut off. Some Blackboard tenants ship with a strict Content Security Policy that blocks the default LTI iframe-resize postMessage. FastComments emits both the Canvas-style lti.frameResize message and the IMS spec-form org.imsglobal.lti.frameResize message to maximize compatibility, but a tenant-level CSP override blocks the parent listener. Ask your administrator to confirm that *.fastcomments.com is on the LTI tool allowlist and that no custom CSP header is stripping postMessage events. Resize then works without further configuration.

Course copy duplicates threads. Blackboard course copy issues new resource link IDs for LTI placements, so copied courses start with empty threads. This is expected. If you need the copied course to inherit the original thread, set up Deep Linking with an explicit thread URN before copying, or contact FastComments support to remap thread IDs in bulk.

Student sees a generic Blackboard error on launch. The cause is a missing or stale email claim. Confirm the institution policy for FastComments has Role, Name, and Email Address enabled under User Fields to Send. Save, then launch again in a fresh browser session.

Po zarejestrowaniu FastComments na platformie, instruktorzy dodają go do zawartości kursu, używając standardowych przepływów dodawania narzędzi zewnętrznych platformy. Ta strona opisuje Sakai 23.x i Schoology Enterprise.

Zablokuj dostęp publiczny (zalecane)

Domyślnie dane komentarzy FastComments są na obu platformach publicznie czytelne. Każdy, kto potrafi odgadnąć URL wątku lub punkt końcowy API, może zobaczyć komentarze, nawet poza Sakai lub Schoology. W przypadku dyskusji kursowych niemal na pewno chcesz ograniczyć podgląd tylko do zapisanych studentów.

Otwórz swoją stronę dostosowywania widgetu i utwórz regułę z włączoną opcją Require SSO To View Comments, następnie ustaw poziom bezpieczeństwa na Secure SSO, aby wątki mogły być ładowane tylko przez podpisane uruchomienie LTI.

Zobacz Protecting Comment Threads With Single-Sign-On po pełny przewodnik krok po kroku, w tym jak ograniczyć zakres reguły do konkretnej domeny lub strony.

Sakai

1. Dodaj FastComments do witryny

Opiekun witryny włącza narzędzie dla poszczególnych witryn:

1. Otwórz witrynę i kliknij Site Info w lewym panelu nawigacyjnym.
2. Kliknij Manage Tools.
3. Przewiń do listy External Tools i włącz FastComments.
4. Kliknij Continue, przejrzyj listę narzędzi, a następnie kliknij Finish.

FastComments pojawi się teraz jako pozycja w lewym panelu nawigacyjnym witryny.

2. Zmień kolejność pozycji w lewym panelu

Przejdź do Site Info > Tool Order. Przeciągnij FastComments na żądaną pozycję i kliknij Save. Z tego ekranu możesz też zmienić etykietę nawigacji i ukryć ją przed studentami.

3. Osadź inline na stronie Lessons

Aby umieścić FastComments bezpośrednio wewnątrz strony Lessons zamiast jako samodzielne narzędzie w lewym panelu:

1. Otwórz narzędzie Lessons w witrynie.
2. Kliknij Add Content > Add External Tool.
3. Wybierz FastComments z listy.
4. Jeśli FastComments zadeklarował Deep Linking podczas rejestracji, Sakai otworzy selektor zawartości narzędzia, abyś mógł wybrać lub oznaczyć wątek. Jeśli Deep Linking nie zostało zadeklarowane, Sakai wstawi domyślne łącze uruchamiające.
5. Zapisz element Lessons.

Każda osadzona instancja otrzymuje własny wątek, powiązany z tym linkiem zasobu.

4. Dostosowanie uprawnień dla dostępu studentów

Sakai kontroluje uruchamianie narzędzi zewnętrznych przez Realms. Aby potwierdzić, że studenci mogą uruchamiać FastComments:

1. Zaloguj się jako administrator Sakai i otwórz Administration Workspace > Realms.
2. Otwórz odpowiedni realm (na przykład !site.template.course lub konkretny realm witryny).
3. Potwierdź, że rola access ma włączone lti.launch i że uprawnienia roli w grupie external.tools zostały przyznane.
4. Zapisz realm.

Dla nadpisania na poziomie witryny, opiekun może dostosować widoczność narzędzia dla poszczególnych ról z poziomu Site Info > Tool Order, ukrywając lub pokazując FastComments dla danej roli.

5. Co widzą studenci

Studenci klikają pozycję FastComments w lewym panelu nawigacyjnym (lub przewijają do osadzonego bloku Lessons) i trafiają bezpośrednio do widoku wątków komentarzy. SSO działa automatycznie: Sakai wysyła tożsamość użytkownika w uruchomieniu LTI, a FastComments loguje go pod kontem Sakai.

Mapowanie ról:

• Sakai Instructor -> FastComments moderator
• Sakai Admin (admin w Administration Workspace) -> FastComments admin
• Sakai Student / access -> FastComments commenter

6. Uwagi dotyczące Sakai

• Narzędzie niewidoczne w Manage Tools. Jeśli FastComments nie pojawia się na liście External Tools, administrator Sakai musi otworzyć rejestr narzędzi (Administration Workspace > External Tools > FastComments) i ustawić Stealthed na false. Narzędzia stealthed są ukryte przed selektorem Manage Tools dla witryn.
• Błędy uruchamiania w przeglądarkach z współdzieloną sesją. Token CSRF portalu Sakai jest powiązany z sesją przeglądarki. Jeśli student jest zalogowany do dwóch witryn Sakai w różnych kartach lub ma przestarzałą sesję, uruchomienie zwraca 403. Naprawa: zamknij inne karty Sakai, wyloguj się, zaloguj ponownie i uruchom ponownie. Administratorzy mogą też podwyższyć sakai.csrf.token.cache.ttl, jeśli problem pojawia się w całym klastrze.
• Osadzanie w ramce. Potwierdź, że lti.frameheight w sakai.properties jest wystarczająco duże (600 lub więcej), aby wątek komentarzy nie był przycinany wewnątrz strony Lessons.

Schoology

Schoology Enterprise ma dwa scenariusze instalacji. Potwierdź, który z nich ma zastosowanie przed dodaniem narzędzia do kursu.

1. Dwa scenariusze instalacji

• (a) Instalacja na poziomie przedsiębiorstwa. Administrator systemu Schoology zainstalował FastComments na poziomie organizacji i przypisał go do wszystkich kursów lub do konkretnych szablonów kursów. Instruktorzy pomijają instalację i przechodzą bezpośrednio do "Add Materials".
• (b) Samodzielna instalacja przez instruktora. Instruktor instaluje narzędzie w pojedynczym kursie z Course Options > External Tools > Install LTI Apps. Samodzielna instalacja wymaga uprzedniej akceptacji aplikacji FastComments na poziomie organizacji przez Administratora systemu.

2. Dodaj FastComments jako materiał kursowy

W obrębie kursu:

1. Otwórz kurs i przejdź do Materials.
2. Kliknij Add Materials > Add File/Link/External Tool.
3. Wybierz External Tool.
4. Wybierz FastComments z listy zarejestrowanych narzędzi.
5. Ustaw Name (to widzą studenci na liście materiałów) i opcjonalnie Description.
6. Pozostaw Enable Grading (grade passback) OFF. FastComments nie przesyła ocen z powrotem do Schoology, więc włączenie przekazywania ocen tworzy pustą kolumnę w dzienniku ocen.
7. Kliknij Submit.

Materiał pojawi się teraz na liście materiałów kursu i otworzy wątek FastComments po kliknięciu.

3. Osadzanie inline przez edytor Rich Text

Jeśli Administrator systemu włączył Deep Linking placement dla FastComments podczas rejestracji, instruktorzy mogą osadzić wątek komentarzy w dowolnym polu Rich Text (instrukcje zadania, treści stron, polecenia dyskusji):

1. Otwórz edytor Rich Text na docelowej stronie.
2. Kliknij ikonę External Tool (symbol puzzla) na pasku narzędzi.
3. Wybierz FastComments.
4. Skonfiguruj osadzenie w dialogu deep-linking i kliknij Insert.
5. Zapisz stronę.

Jeśli przycisk External Tool nie pojawia się w edytorze Rich Text, Deep Linking jest wyłączone dla tego narzędzia w tej instancji. Zobacz uwagi poniżej.

4. Widoczność i przypisywanie do sekcji

Schoology ogranicza dostępność narzędzia per sekcja poprzez Course Options:

1. Z kursu kliknij Course Options > External Tools.
2. Dla każdej zainstalowanej aplikacji LTI kontrolujesz, czy jest dostępna dla wszystkich sekcji w kursie, czy tylko dla wybranych sekcji.
3. Aby ograniczyć FastComments do określonych sekcji, odznacz sekcje, które nie powinny widzieć narzędzia.
4. Dostęp na poziomie sekcji także decyduje, które sekcje zobaczą wpis Add Materials > External Tool dla FastComments.

5. Co widzą studenci

Studenci klikają materiał FastComments (lub przewijają do osadzenia inline) i trafiają do dyskusji w wątkach. SSO działa automatycznie przez uruchomienie LTI Schoology pod ich kontem Schoology.

Mapowanie ról:

• Schoology Administrator -> FastComments admin
• Schoology Instructor -> FastComments moderator
• Schoology Student -> FastComments commenter

6. Uwagi dotyczące Schoology

• Tylko Enterprise. Konta osobiste i darmowe w Schoology nie mogą instalować narzędzi LTI 1.3. Jeśli Twój tenant korzysta z darmowego planu, opcja External Tools nie pojawia się w Course Options. Uaktualnij do Schoology Enterprise, aby używać FastComments.
• Deep Linking wyłączone domyślnie przez tenant. Niektóre tenany Schoology ograniczają placement Deep Linking na poziomie organizacji. W takim przypadku instruktorzy widzą tylko przepływ Add Materials > External Tool, a nie przycisk External Tool w edytorze Rich Text. Aby włączyć osadzanie inline, Administrator systemu przechodzi do System Settings > Integration > LTI 1.3 > FastComments i włącza placement Content Item / Deep Linking, a następnie zapisuje.
• Nadpisanie przypisania na poziomie sekcji. Jeśli FastComments jest przypisany na poziomie przedsiębiorstwa, ale instruktor nie widzi go w Add Materials, sekcja kursu została wykluczona w przypisaniu na poziomie organizacji. Poproś Administratora systemu o dodanie sekcji do przypisania aplikacji FastComments.
• Nazwa materiału vs. tożsamość wątku. Zmiana nazwy materiału w Schoology nie przenosi wątku komentarzy. Wątki są identyfikowane na podstawie LTI resource link ID, więc zmiana nazwy zachowuje ten sam wątek; usunięcie i ponowne utworzenie materiału tworzy nowy, pusty wątek.

"Token rejestracyjny nie znaleziony, wygasł lub został już użyty"

Token w Twoim URL rejestracyjnym (uzyskaj go tutaj) jest ważny przez 30 minut i może być użyty tylko raz. Jeśli Twój LMS potrzebował więcej czasu niż to, lub jeśli rejestracja została ponowiona po pomyślnym zakończeniu, token zostanie odrzucony. Wygeneruj nowy URL na stronie konfiguracji FastComments LTI 1.3 i zacznij od początku.

"Platform rejected registration"

Twój LMS odrzucił procedurę rejestracji. Najczęstsze przyczyny:

• Tool already registered with the same client name. Niektóre platformy (w szczególności D2L) odrzucają drugą rejestrację "FastComments" dopóki poprzednia nie zostanie usunięta. Usuń stare narzędzie w swoim LMS, a następnie spróbuj ponownie.
• Wrong field in the LMS. Upewnij się, że wkleiłeś URL do pola registration / tool initiation registration endpoint, a nie do pola launch URL lub login URL.
• The LMS doesn't actually support Dynamic Registration. Starsze wersje Moodle i Blackboard reklamują LTI 1.3, ale pozwalają tylko na ręczną konfigurację. Sprawdź dokumentację swojej platformy.

"Failed to fetch platform configuration"

FastComments nie mogło odczytać dokumentu openid-configuration Twojego LMS. To rzadkie i zazwyczaj oznacza, że LMS podał niepoprawny lub nieosiągalny discovery URL. Skontaktuj się ze wsparciem swojego LMS.

Launch shows "Configuration not found"

Albo konfiguracja w FastComments została usunięta, albo uruchomienie pochodziło z pary iss/client_id, której nie rozpoznajemy. Jeśli usunąłeś i ponownie zarejestrowałeś, poinstruuj swój LMS, aby usunął i ponownie dodał narzędzie FastComments, aby otrzymało nowe client_id.

Launch shows "Deployment not registered"

Uruchomiłeś FastComments z wdrożenia Brightspace/Moodle/Blackboard innego niż to, w którym zostało uruchomione po raz pierwszy. FastComments przypisuje deployment_id przy pierwszym uruchomieniu jako kontrolę bezpieczeństwa. Aby dodać nowe wdrożenie pod tym samym klientem, skontaktuj się z pomocą techniczną — dodamy identyfikator wdrożenia do konfiguracji.

Launch shows "Unsupported message_type"

LMS wysłał komunikat LTI, którego FastComments nie obsługuje (np. LtiSubmissionReviewRequest). FastComments obsługuje tylko standardowy resource-link launch oraz przepływy deep-linking. Skontaktuj się z nami, jeśli potrzebujesz dodania konkretnego typu komunikatu.

Iframe doesn't resize

Większość LMS automatycznie dopasowuje rozmiar iframe'ów LTI. Jeśli Twój tego nie robi, sprawdź, czy ustawienia uruchamiania LMS pozwalają narzędziu wysyłać zdarzenia postMessage do ramki nadrzędnej. FastComments wysyła zarówno komunikaty zmiany rozmiaru w stylu Canvas (lti.frameResize), jak i zgodne ze specyfikacją IMS (org.imsglobal.lti.frameResize).

Integracja FastComments LTI 1.3 stosuje zasadę najmniejszych uprawnień: używa tylko tych roszczeń z uruchomienia, które są wymagane do zidentyfikowania użytkownika, przypisania komentarzy do właściwego kursu i zasobu oraz zastosowania uprawnień opartych na rolach.

Reszta tej strony mapuje każde roszczenie używane przez integrację, każdą usługę LTI Advantage, o którą nie występuje żądanie, oraz każdą kategorię danych, których nie zbiera. Recenzenci ds. bezpieczeństwa i zamówień mogą bezpośrednio wykorzystać odpowiedzi z tabel poniżej.

Elementy danych otrzymywane od LMS

Każde uruchomienie LTI 1.3 zawiera podpisany JWT od LMS. FastComments wyodrębnia z tego JWT następujące roszczenia i nie używa niczego więcej:

Roszczenia i zakresy zadeklarowane podczas rejestracji

Podczas dynamicznej rejestracji LTI 1.3 FastComments rejestruje się z scope: "" (bez dodatkowych zakresów OAuth) i deklaruje tylko te roszczenia OpenID Connect:

iss, sub, name, email, picture

Rejestruje dwa typy wiadomości:

• LtiResourceLinkRequest - standardowe uruchomienie kursu do FastComments.
• LtiDeepLinkingRequest - pozwala instruktorom umieścić narzędzie FastComments wewnątrz kursu.

Z LMS nie są żądane żadne dodatkowe tokeny dostępu.

Usługi LTI Advantage, o które nie występuje żądanie

Dane, które nie są zbierane

Poza samym LTI, FastComments nie żąda ani nie otrzymuje następujących od LMS lub użytkownika:

Granice dostępu

• FastComments otrzymuje dane wyłącznie w ramach autoryzowanego uruchomienia LTI 1.3 podpisanego kluczami zarejestrowanymi przez LMS. Integracja nie dzwoni z powrotem do LMS po dodatkowe informacje.
• Tokeny uruchomienia są jednorazowe i krótkotrwałe. Zduplikowane lub wygasłe tokeny są odrzucane.
• Administratorzy LMS kontrolują, gdzie narzędzie jest wdrożone w ich platformie. D2L Brightspace, na przykład, obsługuje zakresowanie org-unit dla poszczególnych wdrożeń i ustawienia bezpieczeństwa na poziomie wdrożenia, co pozwala administratorom ograniczyć narzędzie do konkretnych kursów lub jednostek organizacyjnych zamiast udostępniać je globalnie. Moodle, Blackboard, Sakai i Schoology oferują równoważne kontrole na poziomie wdrożeń w swoich implementacjach LTI 1.3.

Przechowywanie i retencja

FastComments przechowuje dane pochodzące z LTI przez okres aktywnej usługi komentowania i zgodnie z ustawieniami retencji skonfigurowanymi przez klienta. Dane komentarzy są przechowywane w produkcyjnym magazynie szyfrowanym w stanie spoczynku. Po zakończeniu konta lub na pisemne żądanie usunięcia FastComments usuwa lub anonimizuje dane klienta zgodnie z obowiązującą umową.

Szczegółowe informacje o przechowywaniu i przetwarzaniu danych znajdują się w Polityce prywatności FastComments.

Częstotliwość przeglądu

Każda nowa funkcja LTI, która wymagałaby dodatkowych roszczeń, zakresów lub usług LTI Advantage, jest przeglądana przed wydaniem, aby potwierdzić, że żądany dostęp jest konieczny i proporcjonalny do dostarczanej funkcjonalności.

Krótkie oświadczenie do ankiet bezpieczeństwa

FastComments stosuje zasadę najmniejszych uprawnień i minimalizację danych w swojej integracji LTI 1.3. Integracja używa tylko roszczeń uruchomienia LTI wymaganych do uwierzytelnienia użytkownika (sub, name, email, picture), określenia jego roli oraz identyfikacji kursu i zasobu, do których należą komentarze. FastComments nie żąda Names and Role Provisioning Services, Assignment and Grade Services, danych dziennika ocen, obecności, pełnych list uczestników ani dostępu administracyjnego do LMS. Administratorzy LMS zachowują kontrolę nad tym, w których jednostkach organizacyjnych, kursach i wdrożeniach narzędzie jest dostępne.