
Мова 🇺🇦 Українська
TLDR
Налаштування FastComments
Реєстрація інструменту
Додати до курсу
Використання інструменту
Безпека та відповідність
Опитування
Додати коментарі до вашого LMS за допомогою LTI 1.3
FastComments інтегрується з будь-якою LMS, сумісною з LTI 1.3 - D2L Brightspace, Moodle, Blackboard Learn, Sakai, Schoology, та іншими - через стандарт IMS LTI Dynamic Registration. Один URL, вставлений у екран реєстрації вашої LMS, налаштовує всю інтеграцію: SSO, контекст курсу, зіставлення ролей та розміщення контенту. Немає потреби встановлювати плагін на ваш сервер. (Canvas LMS має власний посібник, оскільки його процес реєстрації відрізняється.)
Після реєстрації FastComments з'являється як Learning Tool у ваших курсах. Студенти бачать коментарі у вигляді ниток та спільний чат поруч із вмістом курсу, і вони автоматично входять у систему під своїм обліковим записом LMS.
Ціноутворення 
Інтеграція FastComments LTI 1.3 включена в плани Flex та Pro без додаткової оплати.
Вона працює з будь-якою LMS, яка підтримує IMS LTI 1.3 Advantage spec, включаючи Dynamic Registration.
Швидкий старт 
- Увійдіть у FastComments і перейдіть на your LTI 1.3 Configuration page.
- (Необов'язково) Виберіть платформу, з якої ви підключаєтеся, у спадному списку Platform - це задає мітку відображення, але Auto-detect працює добре.
- Клацніть Generate URL. З'явиться одноразовий Registration URL (дійсний 30 хвилин, для одноразового використання).
- У вашому LMS відкрийте екран LTI 1.3 Dynamic Registration і вставте URL у поле Tool initiation registration endpoint (або еквівалентне). Надішліть.
- Ваш LMS викликає FastComments у відповідь, обмінюється ключами і створює інтеграцію. Коли операція завершена, спливаюче вікно закривається автоматично.
- Повернувшись у FastComments, нова конфігурація з'явиться в таблиці Existing Configurations. Інструмент тепер доступний у курсах вашого 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 де доступно)
Будь-яка інша LMS, яка реалізує специфікацію IMS LTI 1.3 Advantage із Dynamic Registration, також має працювати — оберіть Other LTI 1.3 platform у випадаючому списку платформи під час генерації вашого URL реєстрації (отримати його тут).
Canvas LMS використовує інший процес налаштування (per-developer-key configuration JSON замість Dynamic Registration). Дивіться спеціальний посібник із встановлення Canvas LMS.
Створити URL реєстрації 
Перейдіть до конфігурації LTI 1.3
Увійдіть у FastComments і перейдіть на вашу сторінку конфігурації LTI 1.3.
Якщо у вашого облікового запису ще немає доступу до LTI, ви побачите "LTI not enabled for this account" — зверніться до служби підтримки, щоб увімкнути його у вашому плані.
Виберіть платформу (необов'язково)
У розділі Generate a Dynamic Registration URL використайте випадаюче меню Platform, щоб повідомити FastComments, з якою LMS ви підключаєтеся:
- D2L Brightspace
- Moodle
- Blackboard Learn
- Sakai
- Schoology
- Інша платформа LTI 1.3
Ви також можете залишити вибір на Auto-detect. Платформа зчитується з openid-configuration вашої LMS під час реєстрації; випадаюче меню лише задає текстову мітку для отриманої конфігурації.
Згенерувати URL
Натисніть Generate URL. FastComments створює одноразовий реєстраційний токен і показує URL, який виглядає як:
https://fastcomments.com/lti/v1p3/register/<long-token>
Скопіюйте його. Цей URL:
- Є одноразовим — щойно ваша LMS успішно виконає виклик, токен буде використано.
- Термін дії спливає через 30 хвилин, якщо його не використано.
- Повинна зберігатися приватною — будь-хто з цим URL зможе зареєструвати інструмент для вашого тенанта протягом цих 30 хвилин.
Існуючі конфігурації
Як тільки реєстрація успішно завершиться, нова конфігурація з’явиться в таблиці Existing Configurations на тій же сторінці з інформацією про Platform, Issuer, Client ID та Status. Ви можете видаляти конфігурації з цієї таблиці, якщо вам потрібно скасувати реєстрацію.
Реєстрація в D2L Brightspace 
D2L Brightspace надає можливість динамічної реєстрації через адміністративний інтерфейс LTI Advantage. Вам потрібен доступ адміністратора.
Відкрийте екран реєстрації
- Увійдіть у свій екземпляр Brightspace як адміністратор.
- Перейдіть до Admin Tools > Manage Extensibility > LTI Advantage.
- Натисніть Register Tool. (Пряме посилання:
https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)
Вставте URL
Ви побачите форму реєстрації. Ключове поле — Tool initiation registration endpoint (у деяких версіях Brightspace воно називається "Tool Initiation Registration URL").
Вставте URL реєстрації FastComments (отримайте його тут) у це поле. Інші поля залиште порожніми — вони автоматично заповнюються FastComments під час процесу реєстрації.
Натисніть Register.
Схваліть інструмент
Brightspace відкриє спливне вікно, яке з'єднається з FastComments, обміняється ключами та покаже екран підтвердження. Спливне вікно закриється самостійно після завершення реєстрації.
Новий інструмент з'явиться у вашому списку інструментів LTI Advantage. За замовчуванням Brightspace позначає нові інструменти як disabled (вимкнені) — перемкніть перемикач у стан enabled (увімкнено), щоб ваші курси могли ним користуватися.
Додайте розгортання
У Brightspace інструментам LTI потрібне розгортання (deployment), перш ніж їх можна буде використовувати в курсах:
- Відкрийте щойно зареєстрований інструмент FastComments.
- Натисніть View Deployments > New Deployment.
- Дайте розгортанню назву (наприклад, "FastComments - All Courses"), оберіть підрозділи організації, у яких воно має бути доступним, і збережіть.
Після першого запуску через це розгортання FastComments закріплює deployment_id за своїм записом конфігурації — подальші запуски з іншого розгортання в межах того самого клієнта будуть відхилені, якщо ви не пройдете реєстрацію знову.
Реєстрація в Moodle 
Використовуєте Moodle? Ми також публікуємо спеціальний плагін для Moodle для FastComments з тіснішою інтеграцією, ніж LTI 1.3 (механізми синхронізації оцінок, розширені звіти по активності, рідний інтерфейс налаштувань Moodle). Дивіться Посібник з встановлення плагіна Moodle. Наведений нижче потік LTI 1.3 — правильний вибір, якщо ви хочете одну реєстрацію, яка також покриває інші LMS, або якщо ваш адміністратор Moodle відмовляється встановлювати сторонні плагіни.
Moodle 4.0+ підтримує динамічну реєстрацію LTI 1.3 через плагін External Tool.
Відкрийте екран керування інструментом
- Увійдіть до Moodle як адміністратор сайту.
- Перейдіть до Site administration > Plugins > Activity modules > External tool > Manage tools.
Вставте URL
Ви побачите картку з позначкою Tool URL. Вставте URL реєстрації FastComments (отримайте його тут) у текстове поле та натисніть Add LTI Advantage.
Moodle відкриє екран реєстрації, що показує ідентифікацію інструмента та дозволи, які він запитує. Перегляньте їх і натисніть Activate (або Register, залежно від версії Moodle).
Спливаюче вікно закривається після завершення реєстрації; новий інструмент FastComments зʼявиться в списку Tools зі статусом Active.
Зробіть його доступним
За замовчуванням Moodle додає нові інструменти до списку "Course tools", але не показує їх у виборі активності. Щоб зробити FastComments доступним для всього курсу:
- Натисніть на значок шестерні на плитці FastComments.
- У розділі Tool configuration usage виберіть Show in activity chooser and as a preconfigured tool.
- Зберегти.
Інструктори тепер можуть додати FastComments до будь-якого курсу через Add an activity or resource > FastComments.
Реєстрація в Blackboard Learn 
Blackboard Learn SaaS and Ultra підтримують LTI 1.3 Dynamic Registration.
Відкрийте екран постачальника інструменту
- Увійдіть до Blackboard як системний адміністратор.
- Перейдіть до Administrator Panel > Integrations > LTI Tool Providers.
- Натисніть Register LTI 1.3 / LTI Advantage Tool.
Якщо ви бачите лише "Register LTI 1.1 Provider", ваша версія Blackboard ще не підтримує LTI 1.3 - оновіть або зв'яжіться зі службою підтримки Blackboard.
Вставте URL
Вставте URL реєстрації FastComments (отримати його тут) у поле Client ID / Registration URL (найменування полів у Blackboard може відрізнятися залежно від версії). Натисніть Submit.
Blackboard виконує реєстраційний обмін з FastComments і показує екран підтвердження.
Схваліть та увімкніть
За замовчуванням Blackboard позначає щойно зареєстровані інструменти як Approved but excluded:
- Знайдіть запис FastComments у списку постачальників інструментів.
- Відкрийте меню та оберіть Edit.
- Встановіть Tool Status на Approved.
- У розділі Institution Policies перегляньте, які дані користувача передаються (ім'я, електронна пошта, роль). Збережіть.
Тепер цей інструмент доступний викладачам під час додавання вмісту до курсів.
Реєстрація в Sakai або Schoology 
Sakai
Sakai підтримує LTI 1.3 Dynamic Registration у випусках з LTI Advantage. З Administration Workspace:
- Увійдіть як адміністратор Sakai і відкрийте Administration Workspace.
- Виберіть External Tools > Install LTI 1.3 Tool.
- Вставте URL реєстрації FastComments (отримайте його тут) і надішліть.
- Підтвердьте інструмент, коли рукостискання завершиться.
Після цього інструмент з'явиться в розділі External Tools, і його зможуть додавати на сайти їхні адміністратори.
Schoology
Інстанси Schoology Enterprise підтримують LTI 1.3, але доступність Dynamic Registration залежить від розгортання. Уточніть це у свого менеджера акаунта Schoology.
Якщо Dynamic Registration недоступний у вашому інстансі Schoology, вам потрібно буде налаштувати інтеграцію вручну, використовуючи такі ендпоінти:
- 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
Після того як Schoology надасть вам Client ID і Deployment ID, зверніться до служби підтримки FastComments, щоб зареєструвати конфігурацію у вашому тенанті.
Інші платформи LTI 1.3
Будь-яка LMS, що відповідає специфікації IMS LTI 1.3 Advantage, має працювати з тим самим URL реєстрації (отримайте його тут). Шукайте налаштування з назвою "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" або подібним.
Якщо ваша платформа підтримує лише ручне налаштування LTI 1.3, використайте чотири ендпоінти, наведені в розділі про Schoology вище, і зверніться до служби підтримки для завершення налаштування.
Додати до вмісту курсу D2L 
Ця сторінка описує додавання FastComments до курсу Brightspace після того, як адміністратор зареєстрував інструмент і створив розгортання. Якщо інструмент ще не зареєстровано, спочатку перегляньте посібник з реєстрації D2L.
Brightspace постачає два інструменти створення контенту: Classic Content та New Content Experience (також називається Lessons). Обидва надають доступ до FastComments, але шляхи меню відрізняються. Кожен розділ нижче описує обидва варіанти там, де вони розходяться.
Знайти інструмент FastComments
Інструмент FastComments з’являється в двох місцях у редакторі вмісту курсу:
- В виборі активностей (activity picker), до якого можна потрапити через кнопку Add Existing у модулі/юніті (у старіших версіях Brightspace мітка Add Existing Activities). У поточних збірках Brightspace FastComments відображається безпосередньо в селекті; в старіших версіях його вкладено в підменю External Learning Tools. Будь-який шлях додає FastComments як окрему тему.
- У діалозі Insert Stuff всередині HTML-редактора, під LTI Advantage. Це вбудовує FastComments inline у HTML-тему через потік LTI deep linking.
Якщо FastComments не з’являється в жодному з селектів, розгортання не ввімкнено для організаційної одиниці (org unit), яка містить курс. Попросіть вашого адміністратора Brightspace відкрити Admin Tools > Manage Extensibility > LTI Advantage > інструмент FastComments > View Deployments, відкрити розгортання і додати організаційну одиницю курсу (або батьківську org unit) у розділ Org Units.
Додати FastComments як тему в модулі
Classic Content:
- Відкрийте курс і натисніть Content в навбарі.
- Виберіть модуль, який повинен містити обговорення (або створіть його через Add a module).
- Натисніть Add Existing (старіший Brightspace: Add Existing Activities > External Learning Tools).
- У селекті натисніть FastComments. Brightspace створює тему в модулі і повертає вас до перегляду вмісту.
- Клацніть нову тему. Перейменуйте її на щось описове, наприклад
FastComments Discussion, використовуючи вбудований редактор заголовка.
New Content Experience (Lessons):
- Відкрийте курс і натисніть Content.
- Відкрийте юніт і lesson, які повинні містити обговорення.
- Натисніть Add > Existing Activity і виберіть FastComments (у старих версіях Brightspace: вкладено в External Learning Tools).
- Активність додається до lesson.
- Натисніть заголовок активності, щоб перейменувати його.
Вперше, коли будь-який користувач (інструктор або студент) відкриває тему, FastComments ініціалізує нитку для цього resource link. Нитка прив’язана до ID resource link, тому перейменування або переміщення теми не змінює ту нитку, яка завантажується.
Вбудувати FastComments inline у HTML-тему
Використовуйте цей потік, коли ви хочете, щоб коментарі з’являлися під матеріалом (читанням, відео або іншим контентом) в тій самій сторінці теми, а не як окрема тема.
- Відкрийте або створіть HTML-тему в модулі/lesson.
- Натисніть Edit HTML, щоб відкрити HTML-редактор Brightspace.
- Помістіть курсор в те місце, де має з’явитися нитка коментарів.
- Натисніть кнопку Insert Stuff (іконка пазлу в панелі інструментів редактора).
- У діалозі Insert Stuff прокрутіть до LTI Advantage і натисніть FastComments.
- FastComments відкриває deep linking-пікер. Підтвердіть розміщення (за замовчуванням опції підходять для обговорень контенту); натисніть Insert або Continue.
- Brightspace повертає вас до HTML-редактора з блоком-заповнювачем, що представляє LTI launch. Натисніть Save and Close у темі.
Коли тема завантажується, Brightspace замінює заповнювач на iframe, який автоматично запускає FastComments через LTI. Студенти бачать нитку обговорення inline.
Одна HTML-тема може містити кілька deep-linked вбудов FastComments. Кожне вбудування отримує власну нитку, оскільки кожен deep link створює унікальний resource link ID.
Тема модуля проти inline quicklink
Виберіть підхід «тема модуля», коли:
- Обговорення є основною активністю на цьому кроці модуля.
- Ви хочете, щоб тема відображалася в таблиці вмісту Brightspace, в трекінгу завершення та в Class Progress.
Виберіть підхід «inline embed», коли:
- Коментарі повинні розташовуватися під іншим контентом на тій самій сторінці.
- Ви не хочете окремого елемента, що відстежується для завершення, у таблиці вмісту.
Видимість, чорновик і умови випуску
Нова тема FastComments за замовчуванням видима студентам. Щоб приховати її під час налаштування:
- У редакторі вмісту натисніть заголовок теми (Classic) або меню з трьома крапками на активності (New Content Experience).
- Встановіть статус у Draft (Classic) або вимкніть перемикач Visibility (New Content Experience).
Теми в статусі Draft невидимі для студентів. Інструктори та асистенти все ще бачать їх з бейджем «Draft».
Щоб обмежити тему для певної групи або секції:
- Відкрийте тему.
- Натисніть меню заголовка теми > Edit Properties In-place (Classic) або Edit > Restrictions (New Content Experience).
- У розділі Release Conditions натисніть Create.
- Виберіть Group enrollment або Section enrollment, оберіть групу/секцію та збережіть.
Умови випуску накладаються разом із власним відображенням ролей FastComments. Студенти, які не можуть бачити тему, не отримують LTI launch.
Що бачать студенти при першому запуску
Коли студент натискає тему (або завантажує HTML-тему з вбудованим плеєром):
- Brightspace виконує LTI 1.3 launch у фоні.
- FastComments отримує ім’я студента, email, URL аватара і роль в LMS, і автоматично входить за нього. Немає запиту на вхід у FastComments.
- Нитка коментарів для цього resource link відображається всередині iframe Brightspace.
Відображення ролей під час запуску:
- Brightspace
Administratorстає FastComments admin для нитки (повна модерація, видалення, бан і доступ до конфігурації). - Brightspace
Instructorстає FastComments moderator (прикріплення, приховування, видалення, бан). - Усі інші ролі (
Learner,TeachingAssistant, тощо) стають звичайними коментаторами.
Коментарі приписуються до акаунта студента Brightspace. Якщо студент змінює своє ім’я або аватар у Brightspace, наступний LTI launch синхронізує зміну.
Обмежити публічний доступ (рекомендовано)
За замовчуванням дані коментарів FastComments є доступними для читання публічно. Будь-хто, хто зможе вгадати URL нитки або API endpoint, може переглянути коментарі, навіть поза Brightspace. Для обговорень курсу майже завжди потрібно обмежити перегляд лише для зареєстрованих студентів.
Відкрийте вашу сторінку налаштування віджета і створіть правило з увімкненою опцією Require SSO To View Comments, потім встановіть рівень безпеки на Secure SSO, щоб нитки можна було завантажувати лише через підписаний LTI launch.
Див. Protecting Comment Threads With Single-Sign-On для повного покрокового опису, включно з тим, як обмежити правило для однієї доменної зони або сторінки.
Висота iframe і зміна розмірів
FastComments надсилає postMessage org.imsglobal.lti.frameResize при кожному рендері нитки та при змінах контенту (новий коментар, розгортання відповідей). Brightspace слухає це повідомлення і регулює висоту iframe, щоб нитка не обрізалась і не показувала внутрішню смугу прокрутки.
Якщо iframe залишається з фіксованою малою висотою:
- Підтвердьте, що курс завантажується через HTTPS. Слухач postMessage Brightspace відкидає mixed-content фрейми.
- Підтвердьте, що жодне розширення браузера не блокує канал postMessage.
- Для inline вбудов у HTML-темі оточуючий HTML не повинен обертати iframe у контейнер з фіксованою висотою. Видаліть будь-який inline
style="height: ..."з батьківського елемента.
Специфічні підводні камені Brightspace
Інструмент не показується у виборі Add Existing. Розгортання не ввімкнено для org unit цього курсу. Адміністратор повинен додати org unit (або батьківську) до списку Org Units розгортання. Саме реєстрації інструмента недостатньо; розгортання визначає, які курси бачать інструмент.
Несумісність deployment_id при запуску. FastComments TOFU-приписує перший deployment_id, який він бачить для реєстрації. Якщо адміністратор видалить початкове розгортання і створить нове, запуски з нового розгортання будуть відхилені з помилкою невідповідності розгортання. Виправлення — повторно зареєструвати FastComments (згенерувати нову URL реєстрації (отримати її тут) і запустити Dynamic Registration знову); старий запис конфігурації буде замінено.
Інструмент запускається, але показує «Invalid LTI launch». Курс знаходиться в іншій структурі орендаря/організації, ніж покриває розгортання, або розгортання було вимкнено після реєстрації. Повторно перевірте Admin Tools > Manage Extensibility > LTI Advantage > FastComments > перемикач Enabled та список org unit розгортання.
Імена та ролі відсутні всередині FastComments. Brightspace відправляє LTI launch з Names and Role Provisioning Services (NRPS) claims. Якщо курс було оновлено з старого посилання LTI 1.1, у запуску відсутні claims name і email. Повторно додайте тему FastComments через Add Existing (не мігруйте старе посилання), щоб запуск використовував LTI 1.3.
Вбудова показує екран входу замість автоматичного SSO. HTML-тема була вставлена як простий <iframe>, спрямований на FastComments, а не через Insert Stuff > LTI Advantage. Прості iframe пропускають LTI launch і відправляють користувачів на публічну сторінку FastComments. Видаліть iframe і вставте знову через потік Insert Stuff.
Додати до вмісту курсу Moodle 
Цей посібник охоплює додавання FastComments до курсу Moodle 4.x після того, як адміністратор сайту зареєстрував інструмент і налаштував його показ у вікні вибору активностей. Якщо FastComments ще не зареєстровано, спочатку зверніться до посібника з реєстрації Moodle.
Відкрийте курс у режимі редагування
- Увійдіть до Moodle як Редактор курсу (Editing Teacher) або з вищими правами для цього курсу.
- Відкрийте курс.
- Увімкніть Режим редагування за допомогою перемикача у верхньому правому куті заголовка курсу.
Moodle 4.x замінив застарілий випадаючий список «Додати елемент курсу», який використовувався у 3.x, на повноекранне діалогове вікно вибору активностей. Moodle 4.5 зберігає те саме вікно вибору, але додає рядок із зірочками/обраними елементами вгорі, тому закріплення FastComments один раз робить його доступнішим у наступних розділах.
Додайте активність FastComments
- Прокрутіть до розділу курсу (теми або тижня), де має бути обговорення.
- Натисніть Додати елемент курсу внизу цього розділу.
- У діалоговому вікні вибору оберіть FastComments. Якщо ви його не бачите, перейдіть до розділу з підводними каменями нижче.
Відкриється форма налаштувань активності. Важливі поля:
- Назва елементу курсу (обов'язково). Відображається на сторінці курсу та в журналі оцінок. Приклад:
Week 3 Discussion. - Опис елементу курсу. Необов'язковий вступний текст, що відображається над гілкою коментарів.
- Показувати опис на сторінці курсу. Позначте це, якщо хочете, щоб опис був видимим без переходу в активність.
- Попередньо налаштований інструмент. Встановлено на
FastComments(вибирається автоматично при запуску з вікна вибору). Не змінюйте. - Контейнер запуску. Встановіть У новому вікні. Дивіться розділ з підводними каменями, щоб дізнатися, чому «У тому ж вікні» ламається в деяких розгортаннях Moodle.
- URL інструменту, Публічний ключ, Спільний секрет, Користувацькі параметри. Залиште порожніми. Динамічна реєстрація обробила це на рівні сайту.
Прокрутіть униз і натисніть Зберегти та повернутися до курсу (або Зберегти та показати, щоб одразу відкрити активність).
Активність з'являється як рядок у розділі з іконкою FastComments. Студенти натискають на рядок, щоб відкрити гілку коментарів.
Вбудуйте FastComments безпосередньо через редактор
Для гілки обговорення всередині Сторінки, розділу Книги, Заняття (Lesson) або будь-якого іншого ресурсу, що використовує редактор Atto або TinyMCE:
- Відкрийте ресурс у режимі редагування.
- Помістіть курсор туди, де має з'явитися гілка обговорення.
- На панелі інструментів редактора натисніть кнопку LTI / Зовнішній інструмент. В Atto вона підписана «Insert LTI Advantage content». У TinyMCE (за замовчуванням у Moodle 4.3+) вона знаходиться в меню Більше як Зовнішні інструменти.
- Оберіть FastComments зі списку інструментів.
- FastComments відкриє вікно вибору deep-linking. Підтвердьте назву гілки обговорення та натисніть Embed.
- Редактор вставить блок-заповнювач LTI. Збережіть ресурс.
Кожен вбудований екземпляр є окремою гілкою обговорення, прив'язаною до ідентифікатора елементу вмісту deep-link, тому Сторінка з трьома вбудовуваннями FastComments отримає три незалежні гілки.
Обмеження доступу та налаштування груп
Стандартні налаштування активностей Moodle застосовуються до активностей FastComments:
- Загальні налаштування модуля > Груповий метод. Встановлення значення Окремі групи або Видимі групи само по собі не розділяє FastComments на гілки для кожної групи. Груповий метод Moodle фільтрує лише журнал оцінок і список учасників. Щоб запустити окрему гілку для кожної групи, додайте одну активність FastComments на групу та використовуйте Обмеження доступу для визначення кожної з них.
- Обмеження доступу > Додати обмеження. Підтримує стандартні умови Moodle: Дата, Оцінка, Група, Групування, Профіль користувача та вкладені набори обмежень. Використовуйте Групу, щоб прив'язати активність FastComments до однієї групи.
- Завершення елементу курсу. Встановіть Студенти повинні переглянути цей елемент курсу, щоб завершити його, якщо хочете відстежувати завершення. FastComments наразі не повідомляє про подію завершення назад у Moodle, окрім самого запуску.
Зіставлення ролей
FastComments зчитує LTI-заявку roles, яку Moodle надсилає при кожному запуску, та зіставляє її так:
- Moodle Менеджер або Адміністратор сайту -> FastComments admin
- Moodle Редактор курсу або Асистент викладача -> FastComments moderator
- Moodle Студент -> FastComments commenter
- Moodle Гість -> лише читання
Адміністратори можуть видаляти будь-який коментар, блокувати користувачів і редагувати налаштування гілки. Модератори можуть видаляти та схвалювати коментарі всередині гілки, до якої вони були запущені. Користувацькі ролі Moodle успадковують зіставлення архетипу, з якого вони були скопійовані.
Що бачать студенти
Студенти натискають на активність FastComments (або прокручують до вбудованого блоку всередині Сторінки чи Книги). Moodle надсилає їхню ідентичність до FastComments через LTI-запуск:
- Немає екрана входу. FastComments авторизує їх за допомогою облікового запису Moodle.
- Їхнє відображуване ім'я, електронна пошта та аватар надходять з Moodle.
- Гілка обговорення прив'язана до
(сайт Moodle, курс, ідентифікатор посилання на ресурс), тому та сама активність, скопійована в інший курс, отримає нову гілку. - Відповіді у гілках, голосування та сповіщення працюють так само, як у окремій гілці FastComments.
Забороніть публічний доступ (рекомендовано)
За замовчуванням дані коментарів FastComments є публічно доступними для читання. Будь-хто, хто може вгадати URL гілки обговорення або API-ендпоінт, може переглядати її коментарі, навіть поза Moodle. Для обговорень у курсі ви майже напевно захочете обмежити перегляд лише зарахованими студентами.
Відкрийте свою сторінку налаштування віджета і створіть правило з увімкненим параметром Require SSO To View Comments, а потім встановіть рівень безпеки на Secure SSO, щоб гілки обговорення можна було завантажити лише через підписаний LTI-запуск.
Дивіться Захист гілок обговорення за допомогою Single-Sign-On для повного покрокового керівництва, включно з тим, як обмежити правило одним доменом або сторінкою.
Підводні камені Moodle
FastComments відсутній у вікні вибору активностей. Адміністратор сайту зареєстрував інструмент, але не встановив Використання конфігурації інструменту на Показувати у вікні вибору активностей та як попередньо налаштований інструмент. Виправте це в Адмініструванні сайту > Плагіни > Модулі активностей > Зовнішній інструмент > Керування інструментами > іконка шестерні на плитці FastComments.
Запуск не вдається або показує порожній фрейм, коли встановлено «У тому ж вікні». Сесійні cookie Moodle за замовчуванням використовують SameSite=Lax, і деякі браузери видаляють їх під час міжсайтового POST-запиту, який LTI 1.3 використовує для повернення з FastComments. Встановіть Контейнер запуску на У новому вікні для цієї активності. Це жорстка вимога для вбудованого FastComments всередині Сторінки або Книги, оскільки шлях запуску, вбудований через редактор, завжди відкриває нове вікно.
Заявка iss — це URL сайту Moodle, а не ідентифікатор орендаря. FastComments використовує URL сайту Moodle (значення конфігурації wwwroot) як LTI-видавця. Якщо ваш екземпляр Moodle переїде на новий домен або ви зміните wwwroot, наявні гілки FastComments залишаться прив'язаними до старого видавця і не відповідатимуть новим запускам. Перереєструйте інструмент на новий URL і за потреби перенесіть гілки через адмін-панель FastComments.
Резервне копіювання та відновлення активностей. Резервне копіювання курсу та відновлення його в новий курс створює нові ідентифікатори посилань на ресурси, тому відновлені активності FastComments починаються з порожніми гілками. Оригінальний курс зберігає оригінальні гілки. Це передбачена поведінка, а не помилка.
TinyMCE за замовчуванням у Moodle 4.5. Moodle 4.5 постачається з TinyMCE як редактором за замовчуванням для нових встановлень. Кнопка Зовнішнього інструменту знаходиться в меню Більше (...), а не на головній панелі інструментів. Старіші сайти, оновлені з 4.1, зберігають Atto, якщо адміністратор не змінив значення за замовчуванням.
Додати до вмісту курсу Blackboard 
Після того як адміністратор зареєстрував FastComments як LTI 1.3 Advantage інструмент і затвердив політики закладу, викладачі додають його до курсів через стандартні точки розміщення Blackboard. Точні кроки відрізняються між Ultra Course View та Original Course View, тому нижче описано обидва варіанти.
Ultra Course View
Ultra Course View є налаштуванням за замовчуванням у Blackboard Learn SaaS станом на 2026 рік.
- Відкрийте курс і перейдіть на сторінку Course Content.
- Наведіть курсор або торкніться місця, куди ви хочете вставити тред коментарів в огляді, і натисніть фіолетову кнопку + (Add content).
- Виберіть Content Market. Панель Content Market перелічує всі затверджені LTI інструменти та розміщення Building Block для вашого закладу.
- Знайдіть плитку FastComments і натисніть її. Blackboard створює елемент контенту у позиції, де ви відкрили меню +.
- За замовчуванням елемент з’являється в огляді як запис «Visible to students» для викладачів, у яких особисто вимкнено Hide from students. Якщо у вас за замовчуванням встановлено Hidden, елемент створюється прихованим і ви вмикаєте селектор видимості на рядку елемента, коли будете готові.
- Щоб перейменувати елемент, клацніть заголовок в огляді і введіть нову мітку. Заголовок, який бачать студенти в огляді, незалежний від ідентифікатора треда FastComments, тож перейменування безпечне в будь-який час.
Якщо ви не бачите Content Market як опцію, у вашої установи це розміщення приховано. Ви також можете потрапити в той самий вибір через More tools у тому ж меню + під групою LTI Tools.
Original Course View
Original Course View все ще підтримується в Learn SaaS і залишається основним досвідом для самохостованих сайтів Learn 9.1 на релізній гілці Q4 2024 CU.
- Відкрийте курс і зайдіть у Content Area (наприклад, стандартну область Information або Content у меню курсу).
- Увімкніть Edit Mode за допомогою перемикача у верхньому правому куті сторінки.
- Натисніть Build Content у панелі дій.
- У підменю Learning Tools натисніть FastComments. Підменю Learning Tools заповнюється з розміщень інструментів LTI 1.3 після того, як адміністратор зареєструє інструмент. Якщо ви не бачите його, див. розділ про проблеми нижче.
- У формі Create FastComments встановіть:
- Name: мітка, яку бачать студенти в області контенту.
- Description: необов’язковий текст, що показується над вбудованим тредом.
- Permit Users to View this Content: перемикач доступності Так/Ні.
- Track Number of Views: увімкніть, якщо хочете статистику переглядів по елементу в Blackboard. FastComments веде власну аналітику незалежно.
- Date and Time Restrictions: необов’язкові вікна Display After / Display Until.
- Надішліть форму. Інструмент з’являється як клікабельний елемент в області контенту.
Вбудовування всередині елемента або документа
В обох видах перегляду курсу викладачі вбудовують FastComments вміст у тіло Item, Document або будь-яке поле з розширеним текстом через кнопку LTI Advantage у Редакторі контенту.
Ultra Course View:
- Створіть або відредагуйте Document.
- Натисніть Add content всередині тіла документа там, де ви хочете, щоб з’явився тред.
- У панелі інструментів редактора відкрийте меню Insert content і натисніть Content Market (вхідна точка LTI Advantage / Deep Linking).
- Виберіть FastComments. FastComments повертає deep-link payload, і Blackboard вставляє вбудований блок у тіло документа на позицію курсора.
- Збережіть документ. Студенти бачать тред відрендереним вбудовано під час прокрутки.
Original Course View:
- Відредагуйте будь-який елемент з полем розширеного тексту.
- У панелі інструментів Content Editor натисніть піктограму плюса Add Content і виберіть Content Market (позначено як Add Content from External Tool в старіших Q4 2024 CU).
- Виберіть FastComments. Редактор вставляє заповнювач, який посилається на ресурс, пов’язаний глибоким посиланням.
- Надішліть елемент.
Кожне deep-link вбудовування створює свій власний тред FastComments, тож елемент з двома вбудованими блоками FastComments матиме два незалежні потоки коментарів.
Видимість, умови публікації та обмеження груп
Елементи контенту FastComments поводяться як будь-який інший елемент контенту Blackboard щодо правил контролю доступу, накладених на них.
- Ultra: натисніть селектор видимості на рядку (Visible to students, Hidden from students, Conditional availability). Conditional availability підтримує вікна дати/часу, правила продуктивності щодо елементів gradebook і правила членства щодо груп курсу.
- Original: відкрийте контекстне меню елемента і виберіть Adaptive Release або Adaptive Release: Advanced, щоб обмежити доступ за датою, членством, оцінкою або статусом рев’ю. Використовуйте Set Group Availability на елементі, щоб обмежити доступ до конкретних груп курсу.
FastComments поважає будь-яке рішення брамки Blackboard. Якщо Blackboard приховує елемент від студента, LTI-запуск для цього студента ніколи не відбувається, і він не з’являється у перегляді модератора.
Поведінка Gradebook
FastComments не надсилає оцінки назад через LTI Advantage Assignment and Grade Services. Для елементів контенту FastComments автоматично стовпець оцінок не створюється.
Якщо ваш орендатор Blackboard налаштований автоматично створювати стовпець у gradebook для кожного нового елемента контенту незалежно від метаданих оцінювання, порожній стовпець з’явиться все одно. Щоб його приховати:
- Ultra: відкрийте Gradebook, натисніть заголовок стовпця, виберіть Edit і вимкніть Show to students та Include in calculations. Або використайте Delete, якщо ваша установа дозволяє видаляти стовпці для неоцінюваних елементів.
- Original: відкрийте Grade Center, натисніть на шеврон стовпця, виберіть Hide from Users (on/off), а за потреби — Hide from Instructor View у розділі Column Organization.
Що бачать студенти
Коли студент відкриває елемент FastComments або прокручує до вбудованого блоку:
- Blackboard запускає LTI 1.3 повідомлення до FastComments. Студент автоматично входить через SSO, використовуючи свій обліковий запис Blackboard (ім’я, email, аватар, роль) без відображення форми входу.
- Тред коментарів відображається в iframe. Дерево відповідей, відповіді, згадки та реакції доступні залежно від налаштувань віджета коментарів у FastComments.
- Їхні коментарі атрибутуються до їхнього облікового запису Blackboard. Якщо студент змінить своє ім’я або фото в Blackboard пізніше, наступний запуск оновить профіль FastComments.
Відображення ролей з Blackboard у FastComments:
- System Administrator та Course Builder відображаються як FastComments admin.
- Instructor та Teaching Assistant відображаються як FastComments moderator.
- Student, Guest та Observer відображаються як FastComments commenter.
Модератори бачать елементи керування модерацією (pin, hide, ban, delete) вбудовано в кожному коментарі треда.
Обмеження публічного доступу (рекомендовано)
За замовчуванням дані коментарів FastComments доступні для публічного читання. Будь-хто, хто може вгадати URL треда або API endpoint, може переглянути його коментарі, навіть поза межами Blackboard. Для дискусій курсу майже напевне ви захочете обмежити перегляд тільки зареєстрованими студентами.
Відкрийте свою сторінку налаштування віджета і створіть правило з увімкненою опцією Require SSO To View Comments, потім встановіть рівень безпеки на Secure SSO, щоб треди можна було завантажувати лише через підписаний LTI запуск.
Див. Protecting Comment Threads With Single-Sign-On для повного покрокового опису, включно з тим, як обмежити правило для окремого домену або сторінки.
Скопування області треда (Thread Scoping)
FastComments скопує кожен тред за (Blackboard host, course ID, resource link ID). Два елементи FastComments в одному курсі породжують два треди. Той самий елемент, скопійований у два екземпляри курсу (наприклад, через копіювання курсу), створює два треди, тому що Blackboard видає новий resource link ID під час копіювання. Щоб зберегти спільний тред при копіюванні курсу, використовуйте Deep Linking з явним URN треда, налаштованим у FastComments перед запуском копіювання.
Специфічні проблеми Blackboard
Плитка 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 для цього орендаря. Якщо вони відрізняються, видаліть розміщення і перезапустіть динамічну реєстрацію з нової URL-адреси реєстрації (отримайте її тут).
Висота iframe виглядає фіксованою або вміст обрізається. Деякі орендарі Blackboard поставляються зі суворою політикою Content Security Policy, яка блокує стандартне LTI iframe-resize postMessage. FastComments надсилає як повідомлення у стилі Canvas lti.frameResize, так і повідомлення специфікації IMS org.imsglobal.lti.frameResize, щоб максимально підвищити сумісність, але переважні tenant-рівневі CSP можуть блокувати слухач батьківського вікна. Попросіть вашого адміністратора підтвердити, що *.fastcomments.com внесено до allowlist інструментів LTI і що жодний користувацький CSP заголовок не видаляє події postMessage. Після цього зміна розміру працює без додаткової конфігурації.
Копіювання курсу дублює треди. При копіюванні курсу Blackboard видає нові resource link ID для розміщень LTI, тому скопійовані курси починаються з порожніх тредів. Це очікувана поведінка. Якщо вам потрібно, щоб скопійований курс успадкував оригінальний тред, налаштуйте Deep Linking з явним URN треда перед копіюванням, або зверніться в службу підтримки FastComments для масового переназначення ID тредів.
Студент бачить загальну помилку Blackboard при запуску. Причина — відсутній або застарілий claim email. Підтвердіть, що політика закладу для FastComments має увімкнені Role, Name та Email Address у розділі User Fields to Send. Збережіть, потім запустіть знову в новій сесії браузера.
Додати до вмісту курсу Sakai або Schoology 
Після реєстрації FastComments на платформі викладачі додають його до матеріалів курсу за допомогою стандартних потоків зовнішніх інструментів платформи. Ця сторінка охоплює Sakai 23.x та Schoology Enterprise.
Обмеження публічного доступу (рекомендовано)
За замовчуванням дані коментарів FastComments є публічно доступними для читання на обох платформах. Будь-хто, хто може вгадати URL гілки або API-ендпоінт, може переглядати її коментарі, навіть поза межами Sakai або Schoology. Для обговорень у курсах ви майже напевно захочете обмежити перегляд лише зарахованими студентами.
Відкрийте свою сторінку налаштування віджета і створіть правило з увімкненою опцією Require SSO To View Comments, а потім встановіть рівень безпеки на Secure SSO, щоб гілки можна було завантажити лише через підписаний LTI-запуск.
Дивіться Захист гілок коментарів за допомогою Single-Sign-On для повного покрокового керівництва, включно з тим, як обмежити дію правила одним доменом або сторінкою.
Sakai
1. Додавання FastComments до сайту
Власник сайту вмикає інструмент на рівні кожного сайту:
- Відкрийте сайт і натисніть Site Info у лівій навігації.
- Натисніть Manage Tools.
- Прокрутіть до списку External Tools і увімкніть перемикач FastComments.
- Натисніть Continue, перегляньте список інструментів, а потім натисніть Finish.
Тепер FastComments з'являється як пункт лівої навігації на сайті.
2. Зміна порядку пункту в лівій навігації
Перейдіть до Site Info > Tool Order. Перетягніть FastComments на потрібну позицію та натисніть Save. На цьому екрані також можна перейменувати мітку навігації та приховати її від студентів.
3. Вбудовування на сторінці Lessons
Щоб розмістити FastComments безпосередньо на сторінці Lessons, а не як окремий інструмент лівої навігації:
- Відкрийте інструмент Lessons на сайті.
- Натисніть Add Content > Add External Tool.
- Виберіть FastComments зі списку.
- Якщо FastComments оголосив Deep Linking під час реєстрації, Sakai відкриє селектор вмісту інструменту, щоб ви могли вибрати або підписати гілку. Якщо Deep Linking не було оголошено, Sakai вставить посилання на запуск за замовчуванням.
- Збережіть елемент Lessons.
Кожен вбудований екземпляр отримує власну гілку, прив'язану до цього посилання на ресурс.
4. Налаштування дозволів для доступу студентів
Sakai регулює запуски зовнішніх інструментів через Realms. Щоб переконатися, що студенти можуть запускати FastComments:
- Увійдіть як адміністратор Sakai та відкрийте Administration Workspace > Realms.
- Відкрийте відповідний realm (наприклад,
!site.template.courseабо realm конкретного сайту). - Переконайтеся, що для ролі
accessувімкненоlti.launch, і що дозволи ролі в групі external.tools надано. - Збережіть realm.
Для перевизначень на рівні сайту власник може налаштувати видимість інструменту для кожної ролі через Site Info > Tool Order, приховуючи або показуючи FastComments для кожної ролі.
5. Що бачать студенти
Студенти натискають пункт лівої навігації FastComments (або прокручують до вбудованого блоку Lessons) і потрапляють безпосередньо до перегляду гілки коментарів. SSO відбувається автоматично: Sakai передає ідентичність користувача в LTI-запуску, і FastComments виконує вхід під їхнім обліковим записом Sakai.
Відображення ролей:
- Sakai
Instructor-> модератор FastComments - Sakai
Admin(адміністратор в Administration Workspace) -> адміністратор FastComments - Sakai
Student/access-> коментатор FastComments
6. Підводні камені Sakai
- Інструмент не видно в Manage Tools. Якщо FastComments не з'являється у списку External Tools, адміністратору Sakai потрібно відкрити реєстр інструментів (Administration Workspace > External Tools > FastComments) і встановити Stealthed на
false. Інструменти зі статусом Stealthed приховані з вибору Manage Tools на рівні сайту. - Збої запусків у браузерах зі спільною сесією. CSRF-токен порталу Sakai прив'язаний до сесії браузера. Якщо студент увійшов на два сайти Sakai в різних вкладках або має застарілу сесію, запуск повертає 403. Рішення: закрийте інші вкладки Sakai, вийдіть, увійдіть знову та повторіть запуск. Адміністратори також можуть збільшити
sakai.csrf.token.cache.ttl, якщо це відбувається в усьому кластері. - Вбудовування у фрейм. Переконайтеся, що
lti.frameheightуsakai.propertiesдостатньо великий (600 або більше), щоб гілка коментарів не обрізалася на сторінці Lessons.
Schoology
Schoology Enterprise має два сценарії встановлення. Визначте, який із них застосовується, перш ніж додавати інструмент до курсу.
1. Два сценарії встановлення
- (a) Встановлення на рівні Enterprise. Системний адміністратор Schoology встановив FastComments на рівні організації та призначив його всім курсам або конкретним шаблонам курсів. Викладачі пропускають встановлення та одразу переходять до «Add Materials».
- (b) Самостійне встановлення викладачем. Викладач встановлює інструмент в окремий курс через Course Options > External Tools > Install LTI Apps. Для самостійного встановлення системний адміністратор спочатку має затвердити застосунок FastComments на рівні організації.
2. Додавання FastComments як матеріалу курсу
Усередині курсу:
- Відкрийте курс і перейдіть до Materials.
- Натисніть Add Materials > Add File/Link/External Tool.
- Виберіть External Tool.
- Виберіть FastComments зі списку зареєстрованих інструментів.
- Вкажіть Name (це те, що студенти бачать у списку матеріалів) та необов'язковий Description.
- Залиште Enable Grading (передача оцінок) ВИМКНЕНОЮ. FastComments не передає оцінки назад у Schoology, тому увімкнення передачі оцінок створить порожній стовпець у журналі оцінок.
- Натисніть Submit.
Матеріал тепер з'являється у списку матеріалів курсу та відкриває гілку FastComments при натисканні.
3. Вбудовування через редактор Rich Text
Якщо системний адміністратор увімкнув розміщення Deep Linking для FastComments під час реєстрації, викладачі можуть вбудовувати гілку коментарів у будь-яке поле Rich Text (інструкції до завдань, тіла сторінок, теми обговорень):
- Відкрийте редактор Rich Text на цільовій сторінці.
- Натисніть іконку External Tool (пазл) на панелі інструментів.
- Виберіть FastComments.
- Налаштуйте вбудовування в діалозі deep-linking і натисніть Insert.
- Збережіть сторінку.
Якщо кнопка External Tool не з'являється в редакторі Rich Text, Deep Linking вимкнено для цього інструменту на цьому тенанті. Дивіться підводні камені нижче.
4. Видимість і призначення секцій
Schoology регулює доступність інструменту для кожної секції через Course Options:
- З курсу натисніть Course Options > External Tools.
- Для кожного встановленого LTI-застосунку ви можете керувати тим, чи доступний він усім секціям курсу чи лише певним секціям.
- Щоб обмежити FastComments певними секціями, зніміть прапорці з секцій, які не повинні бачити інструмент.
- Доступ на рівні секції також регулює, які секції бачать пункт Add Materials > External Tool для FastComments.
5. Що бачать студенти
Студенти натискають матеріал FastComments (або прокручують до вбудованого елемента) і потрапляють до гілки обговорення. SSO відбувається автоматично через LTI-запуск Schoology під їхнім обліковим записом Schoology.
Відображення ролей:
- Schoology
Administrator-> адміністратор FastComments - Schoology
Instructor-> модератор FastComments - Schoology
Student-> коментатор FastComments
6. Підводні камені Schoology
- Лише Enterprise. Персональні та безкоштовні облікові записи Schoology не можуть встановлювати інструменти LTI 1.3. Якщо ваш тенант на безкоштовному тарифі, опція External Tools відсутня в Course Options. Оновіть до Schoology Enterprise, щоб використовувати FastComments.
- Deep Linking вимкнено за замовчуванням на рівні тенанта. Деякі тенанти Schoology обмежують розміщення Deep Linking на рівні організації. У такому разі викладачі бачать лише потік Add Materials > External Tool і не бачать кнопку External Tool у редакторі Rich Text. Щоб увімкнути вбудовування, системний адміністратор переходить до System Settings > Integration > LTI 1.3 > FastComments, увімкнює розміщення Content Item / Deep Linking і зберігає.
- Перевизначення призначення на рівні секції. Якщо FastComments призначено на рівні enterprise, але викладач не бачить його в Add Materials, секція курсу виключена з призначення на рівні організації. Попросіть системного адміністратора додати секцію до призначення застосунку FastComments.
- Назва матеріалу проти ідентичності гілки. Перейменування матеріалу в Schoology не переміщує гілку коментарів. Гілки прив'язані до LTI resource link ID, тому перейменування зберігає ту саму гілку; видалення та повторне створення матеріалу створює нову, порожню гілку.
Усунення неполадок 
"Токен реєстрації не знайдено, прострочено або вже використано"
Токен у вашому URL реєстрації (отримайте його тут) дійсний протягом 30 хвилин і може бути використаний лише один раз. Якщо ваш LMS працював довше, або якщо реєстрація була повторена після успішного завершення, токен буде відхилено. Згенеруйте новий URL на сторінці конфігурації FastComments LTI 1.3 і почніть спочатку.
"Платформа відхилила реєстрацію"
Ваш LMS відмовив у реєстраційному рукостисканні. Найпоширеніші причини:
- Інструмент уже зареєстровано з тим самим ім'ям клієнта. Деякі платформи (зокрема D2L) відхиляють повторну реєстрацію "FastComments", доки попередню не буде видалено. Видаліть старий інструмент у вашому LMS, а потім спробуйте знову.
- Неправильне поле в LMS. Переконайтеся, що ви вставили URL у поле registration / tool initiation registration endpoint, а не в поле launch URL або login URL.
- LMS насправді не підтримує Dynamic Registration. Старіші версії Moodle та Blackboard заявляють про підтримку LTI 1.3, але дозволяють лише ручну конфігурацію. Перевірте документацію вашої платформи.
"Не вдалося отримати конфігурацію платформи"
FastComments не зміг прочитати документ openid-configuration вашого LMS. Це рідкісний випадок і зазвичай означає, що LMS надав некоректний або недоступний URL виявлення. Зверніться до служби підтримки вашого LMS.
Запуск показує "Configuration not found"
Або конфігурацію в FastComments було видалено, або запуск надійшов від пари iss/client_id, яку ми не розпізнаємо. Якщо ви видалили та повторно зареєстрували інструмент, вкажіть вашому LMS видалити та знову додати інструмент FastComments, щоб він отримав новий client_id.
Запуск показує "Deployment not registered"
Ви запустили FastComments із розгортання Brightspace/Moodle/Blackboard, відмінного від того, у якому відбувся перший запуск. FastComments фіксує deployment_id під час першого запуску як перевірку безпеки. Щоб додати нове розгортання під тим самим клієнтом, зверніться до служби підтримки — ми додамо ідентифікатор розгортання до конфігурації.
Запуск показує "Unsupported message_type"
LMS надіслав LTI-повідомлення, яке FastComments не обробляє (наприклад, LtiSubmissionReviewRequest). FastComments підтримує лише стандартний запуск resource-link та потоки deep-linking. Зверніться до нас, якщо вам потрібно додати конкретний тип повідомлення.
Iframe не змінює розмір
Більшість LMS автоматично підлаштовують розмір LTI iframe. Якщо ваш цього не робить, перевірте, чи налаштування запуску LMS дозволяють інструменту надсилати події postMessage до батьківського фрейма. FastComments надсилає повідомлення про зміну розміру як у стилі Canvas (lti.frameResize), так і за специфікацією IMS (org.imsglobal.lti.frameResize).
Принцип найменших привілеїв та мінімізація даних 
The FastComments LTI 1.3 інтеграція дотримується принципу найменших привілеїв: вона використовує лише ті дані запуску, які необхідні для ідентифікації користувача, прив'язки коментарів до правильного курсу та ресурсу, а також застосування дозволів на основі ролей.
Решта цієї сторінки відображає кожен клейм, який споживає інтеграція, кожну службу LTI Advantage, яку вона не запитує, і кожну категорію даних, яку вона не збирає. Рецензенти з питань безпеки та закупівель можуть безпосередньо використовувати відповіді з таблиць нижче.
Дані, що отримуються з LMS
Кожен запуск LTI 1.3 містить підписаний JWT від LMS. FastComments витягує з цього JWT такі клейми і нічого більше:
| Field | LTI claim | Purpose | Required | Stored |
|---|---|---|---|---|
| User identifier | sub | Визначає користувача послідовно між запусками, щоб одна й та сама особа відповідала одному SSO-користувачу FastComments | Yes | Yes, as part of a stable internal SSO ID |
| Display name | name | Підпис, що відображається поруч із коментарями користувача | Yes (falls back to "LMS User" if absent) | Yes |
email | Збіг акаунту, повідомлення, модерація, кореспонденція з підтримкою | Optional (the integration works without it) | Yes when provided | |
| Avatar URL | picture | Відображається поруч із коментарями користувача | Optional | URL only; FastComments does not download or rehost the image |
| Roles | https://purl.imsglobal.org/spec/lti/claim/roles | Визначає, чи є користувач адміністратором, викладачем (модератором) чи учнем | Yes | Derived isAdmin / isModerator flags on the SSO session |
| Course context | https://purl.imsglobal.org/spec/lti/claim/context (id, title) | Зв'язує потік коментарів з правильним курсом у LMS | Yes | Yes, as part of the resolved page identifier |
| Resource link | https://purl.imsglobal.org/spec/lti/claim/resource_link (id) | Прив'язує коментарі до правильної активності або розміщення інструменту в курсі | Yes when present | Yes, as part of the resolved page identifier |
| Deployment ID | https://purl.imsglobal.org/spec/lti/claim/deployment_id | Направляє запуск до правильної конфігурації орендаря FastComments | Yes | Yes, on the FastComments LTI configuration record |
Клейми та області, заявлені при реєстрації
Під час динамічної реєстрації LTI 1.3 FastComments реєструється з scope: "" (без додаткових OAuth-областей) і заявляє лише ці OpenID Connect клейми:
iss, sub, name, email, picture
Вона реєструє два типи повідомлень:
LtiResourceLinkRequest- стандартний запуск курсу у FastComments.LtiDeepLinkingRequest- дозволяє викладачам розміщувати інструмент FastComments у курсі.
Жодних додаткових токенів доступу від LMS не запитується.
Служби LTI Advantage, які не запитуються
| Service / scope | Requested? | Reason |
|---|---|---|
| Names and Role Provisioning Services (NRPS) | No | Інтеграції не потрібен список учасників курсу; ідентичність користувача надходить з кожним запуском |
| Assignment and Grade Services (AGS) - lineitem, score, result scopes | No | Інтеграція не працює з журналом оцінок |
| Deep Linking beyond the standard placement return | No additional data | Deep linking використовується лише для розміщення інструменту викладачем; вміст курсу не перелічується |
Дані, які не збираються
Окрім самих даних LTI, FastComments не запитує і не отримує від LMS або користувача наступне:
| Category | Collected? |
|---|---|
| Student grades | No |
| Assignment submissions | No |
| Attendance records | No |
| Full course rosters | No |
| Government identifiers | No |
| Date of birth | No |
| Postal address or phone number | No |
| Financial information | No |
| LMS administrator credentials | No |
Межі доступу
- FastComments отримує дані лише в межах авторизованого запуску LTI 1.3, підписаного ключами LMS, зареєстрованими в системі. Інтеграція не робить зворотних викликів у LMS для отримання додаткової інформації.
- Токени запуску одноразові й мають короткий термін дії. Повторні або прострочені токени відхиляються.
- Адміністратори LMS контролюють, де інструмент розгортається в їхній платформі. Наприклад, D2L Brightspace підтримує обмеження по org-unit для кожного розгортання та налаштування безпеки на рівні розгортання, що дозволяє адміністраторам обмежити доступ до інструменту конкретними курсами або організаційними одиницями замість глобальної доступності. Moodle, Blackboard, Sakai і Schoology пропонують еквівалентні контролі на рівні розгортання у своїх реалізаціях LTI 1.3.
Зберігання та збереження
FastComments зберігає дані, похідні від LTI, протягом періоду активного коментування та відповідно до налаштувань збереження, визначених клієнтом. Дані коментарів зберігаються у виробничому сховищі з шифруванням at-rest. Після закриття акаунта або надісланого письмового запиту на видалення FastComments видаляє або анонімізує дані клієнта відповідно до застосовної угоди.
Для повних відомостей про зберігання та обробку даних див. Політика конфіденційності FastComments.
Періодичність перегляду
Будь-яка нова функція LTI, яка вимагатиме додаткових клеймів, областей або служб LTI Advantage, переглядається перед випуском, щоб підтвердити, що запитуваний доступ необхідний і пропорційний функції, яка відправляється.
Коротка відповідь для анкет з безпеки
FastComments застосовує принцип найменших привілеїв і мінімізації даних до своєї інтеграції LTI 1.3. Інтеграція використовує лише клейми запуску LTI, необхідні для автентифікації користувача (
sub,name,picture), визначення його ролі та ідентифікації курсу й ресурсу, до яких належать коментарі. FastComments не запитує Names and Role Provisioning Services, Assignment and Grade Services, дані журналу оцінок, відвідуваність, повні списки учасників або адміністративний доступ до LMS. Адміністратори LMS зберігають контроль над тим, в яких організаційних одиницях, курсах і розгортаннях інструмент доступний.
Додати опитування до вашого курсу LMS 
Як тільки FastComments буде додано до вашого курсу LMS, ви також зможете проводити живі опитування безпосередньо в коментарях. Увімкніть Enable Polls у налаштуваннях налаштування віджета, і кнопка опитування з’явиться на панелі інструментів коментаря. Опитування можуть мати від 2 до 10 варіантів, результати оновлюються в реальному часі для всіх на сторінці, і ви обираєте, хто може створювати опитування і чи вимагає голосування входу в систему. Більше нічого не потрібно встановлювати на LMS.
Спробуйте демо живих опитувань або прочитайте Документацію з опитувань, щоб налаштувати їх.