
Език 🇧🇬 Български
TLDR
Настройка на FastComments
Регистриране на инструмента
Добавяне към курс
Използване на инструмента
Сигурност и съответствие
Анкети
Добавете коментари към вашия LMS чрез LTI 1.3
FastComments се интегрира с всяка LTI 1.3-compliant LMS - 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, включително Dynamic Registration.
Бърз старт 
- Влезте в FastComments и отидете на вашата страница за конфигурация на LTI 1.3.
- (По избор) Изберете платформата, от която се свързвате, от падащото меню Платформа - това задава етикета за показване, но Автоматично откриване работи добре.
- Кликнете върху Генерирай URL. Появява се еднократен Регистрационен URL (валиден за 30 минути, за еднократна употреба).
- Във вашата LMS отворете екрана за динамична регистрация на LTI 1.3 и поставете URL адреса в полето Крайна точка за иницииране на регистрация на инструмента (или еквивалентно). Изпратете.
- Вашата LMS извиква обратно към FastComments, разменя ключове и създава интеграцията. Изскачащият прозорец се затваря автоматично, когато процесът приключи.
- Във FastComments новата конфигурация се появява в таблицата Съществуващи конфигурации. Инструментът вече е наличен във вашите курсове в LMS.
Поддържани платформи 
FastComments LTI 1.3 е тестван с:
- D2L Brightspace (всяка версия с LTI Advantage)
- Moodle 4.0+ (плъгин External Tool, LTI Advantage)
- Blackboard Learn (SaaS и Ultra)
- Sakai (версии с поддръжка на LTI Advantage)
- Schoology (Enterprise, Dynamic Registration, когато е налично)
Всеки друг LMS, който поддържа спецификацията IMS LTI 1.3 Advantage с Dynamic Registration, също трябва да работи - изберете Other LTI 1.3 platform от падащото меню за платформа, когато генерирате вашия URL за регистрация (получете го тук).
Canvas LMS използва различен процес на настройка (JSON за конфигурация per-developer-key вместо Dynamic Registration). Вижте специалното ръководство за инсталиране на Canvas LMS.
Генериране на URL за регистрация 
Навигирайте до конфигурацията на LTI 1.3
Влезте в FastComments и отидете на вашата страница за конфигурация на LTI 1.3.
Ако вашият акаунт все още няма достъп до LTI, ще видите "LTI not enabled for this account" - свържете се с поддръжката, за да го активират във вашия план.
Изберете платформа (по избор)
Под Генериране на динамичен URL за регистрация, използвайте падащото меню Платформа, за да кажете на FastComments кой LMS свързвате:
- D2L Brightspace
- Moodle
- Blackboard Learn
- Sakai
- Schoology
- Друга LTI 1.3 платформа
Можете също така да го оставите на Автоматично разпознаване. Платформата се прочита от вашия LMS's openid-configuration по време на регистрацията; падащото меню само задава етикета за показване за получената конфигурация.
Генериране на URL
Кликнете Генерирай URL. FastComments създава еднократен токен за регистрация и ви показва URL, което изглежда така:
https://fastcomments.com/lti/v1p3/register/<long-token>
Копирайте го. Този URL:
- Е за еднократна употреба - след като вашият LMS го извика успешно, токенът се изразходва.
- Изтича след 30 минути, ако не бъде използван.
- Трябва да се пази в тайна - всеки с този URL може да регистрира инструмент срещу вашия tenant през тези 30 минути.
Съществуващи конфигурации
След като регистрацията завърши успешно, новата конфигурация ще се появи в таблицата Съществуващи конфигурации на същата страница, с нейната Платформа, Issuer, Client ID и Статус. Можете да изтривате конфигурации от тази таблица, ако някога трябва да отмените регистрацията.
Регистрация в D2L Brightspace 
D2L Brightspace предлага Динамична регистрация чрез администраторския интерфейс LTI Advantage. Необходим е администраторски достъп.
Отворете екрана за регистрация
- Влезте в инстанцията на Brightspace като администратор.
- Отидете в Административни инструменти > Управление на разширяемостта > LTI Advantage.
- Кликнете Регистриране на инструмент. (Директният URL е
https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)
Поставете URL адреса
Ще видите регистрационна форма. Ключовото поле е Крайна точка за регистрация на иницииране на инструмента (в някои версии на Brightspace е означено като "URL за регистрация на иницииране на инструмента").
Поставете FastComments регистрационния URL (вземете го тук) в това поле. Оставете останалите полета празни - те се попълват автоматично от FastComments по време на регистрационния обмен.
Кликнете Регистрирай.
Одобрете инструмента
Brightspace отваря изскачащ прозорец, който комуникира с FastComments, разменя ключове и показва екран за потвърждение. Изскачащият прозорец се затваря автоматично, когато регистрацията приключи.
Новият инструмент се появява в списъка ви с инструменти за LTI Advantage. По подразбиране Brightspace маркира новите инструменти като деактивирано - превключете тумблера на активирано, за да могат вашите курсове да го използват.
Добавяне на внедряване
В Brightspace, LTI инструментите се нуждаят от внедряване, преди да могат да бъдат използвани в курсове:
- Отворете току-що регистрирания FastComments инструмент.
- Кликнете Преглед на внедряванията > Ново внедряване.
- Дайте име на внедряването (напр. "FastComments - Всички курсове"), изберете организационните единици, в които трябва да бъде налично, и запазете.
След първото стартиране чрез това внедряване, FastComments фиксира deployment_id в своя запис за конфигурация - последващите стартирания от друго внедряване под същия клиент ще бъдат отхвърлени, освен ако не регистрирате отново.
Регистрация в Moodle 
Използвате Moodle? Ние също публикуваме специален плъгин за Moodle за FastComments с по-тясна интеграция от LTI 1.3 (hooks за синхронизиране на оценки, по-подробно отчитане на активности, вграден интерфейс за настройки в Moodle). Вижте Ръководство за инсталиране на плъгин за Moodle. По-долу описаният поток LTI 1.3 е подходящ, ако искате една регистрация, която покрива и други LMS, или ако администраторът на Moodle няма да инсталира плъгини на трети страни.
Moodle 4.0+ поддържа динамична регистрация LTI 1.3 чрез плъгина External Tool.
Отворете екрана за управление на инструмента
- Влезте в Moodle като администратор на сайта.
- Отидете в Администриране на сайта > Плъгини > Модули за активност > External tool > Управление на инструменти.
Поставете URL адреса
Ще видите карта, озаглавена URL на инструмента. Поставете URL адреса за регистрация на FastComments (вземете го тук) в текстовото поле и щракнете върху Add LTI Advantage.
Moodle отваря екран за регистрация, показващ идентичността на инструмента и разрешенията, които иска. Прегледайте и щракнете върху Activate (или Register, в зависимост от версията на Moodle).
Изскачащият прозорец се затваря, когато регистрацията приключи; новият инструмент FastComments се появява в списъка Инструменти със статус Активен.
Направете го достъпен
По подразбиране Moodle добавя новите инструменти в списъка "Инструменти на курса", но не ги показва в избора на активност. За да направите FastComments достъпен за целия курс:
- Щракнете върху иконата на зъбно колело на плочката FastComments.
- Под Използване на конфигурацията на инструмента, изберете Показване в избора на активност и като предварително конфигуриран инструмент.
- Запазете.
Преподавателите вече могат да добавят FastComments към всеки курс чрез Добавяне на активност или ресурс > FastComments.
Регистрация в Blackboard Learn 
Blackboard Learn SaaS и 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 варира според версията). Изпратете.
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 (вземете го оттук) и изпратете.
- Одобрете инструмента, когато handshake процесът завърши.
След това инструментът се появява под External Tools и може да бъде добавян към сайтовете от техните поддържащи.
Schoology
Инстанциите на Schoology Enterprise поддържат LTI 1.3, но наличието на Dynamic Registration варира според разполагането. Проверете с вашия мениджър на акаунта в Schoology.
Ако Dynamic Registration не е наличен във вашата инстанция на Schoology, ще трябва да конфигурирате интеграцията ръчно, като използвате следните endpoints:
- 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, за да регистрираме конфигурацията във вашия tenant.
Други LTI 1.3 платформи
Всяка LMS, която следва спецификацията IMS LTI 1.3 Advantage, трябва да работи със същия URL за регистрация (вземете го оттук). Потърсете настройка, означена като "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" или подобно.
Ако вашата платформа поддържа само ръчна настройка на LTI 1.3, използвайте четирите endpoints, изброени в раздела за Schoology по-горе, и се свържете с поддръжката за финализиране.
Добавяне към съдържанието на курс в D2L 
Тази страница описва добавянето на FastComments към Brightspace курс след като администраторът е регистрирал инструментa и е създал разполагане (deployment). Ако инструментът още не е регистриран, вижте първо ръководството за регистрация на D2L.
Brightspace предлага два начина за създаване на съдържание: Classic Content и New Content Experience (наричан още Lessons). И двата дават достъп до FastComments, но пътищата в менютата се различават. Всяка секция по-долу обхваща и двата случая, където има различия.
Намерете инструмента FastComments
Инструментът FastComments се показва на две места в редактора на съдържание на курса:
- Избирачът на дейности, достъпен от бутона Add Existing на модул/единица (в по-стари версии на Brightspace е етикетиран Add Existing Activities). FastComments се появява директно в избирача в текущите версии на Brightspace; в по-старите версии е вложен в подменю External Learning Tools. И в двата случая пътят добавя FastComments като самостоятелна тема.
- Диалогът Insert Stuff в HTML редактора, под LTI Advantage. Това вгражда FastComments в HTML тема чрез LTI deep linking потока.
Ако FastComments не се появява в нито един от избирачите, значи разполагането не е разрешено за организационната единица, която държи курса. Помолете вашия Brightspace администратор да отвори Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, да отвори разполагането и да добави организационната единица на курса (или родителска единица) под 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.
- Отворете единицата и урока, които трябва да съдържат дискусията.
- Кликнете Add > Existing Activity и изберете FastComments (по-стар Brightspace: вложен под External Learning Tools).
- Дейността се добавя към урока.
- Кликнете заглавието на дейността, за да го преименувате.
Първия път, когато някой потребител (инструктор или студент) отвори темата, FastComments инициализира нишката за този resource link. Нишката е свързана с resource link ID, така че преименуване или преместване на темата не променя коя нишка се зарежда.
Вграждане на FastComments в HTML тема (inline)
Използвайте този поток, когато искате коментарите да се показват под текст, видео или друго съдържание в същата страница на темата, вместо като отделна тема.
- Отворете или създайте HTML тема в модула/урока.
- Кликнете Edit HTML, за да отворите Brightspace HTML редактора.
- Поставете курсора там, където трябва да се появи нишката с коментари.
- Кликнете бутона Insert Stuff (икона на пъзел в лентата с инструменти на редактора).
- В диалога Insert Stuff превъртете до LTI Advantage и кликнете FastComments.
- FastComments отваря deep linking избирач. Потвърдете поставянето (по подразбиране опциите работят за дискусии в съдържание); кликнете Insert или Continue.
- Brightspace се връща в HTML редактора с плейсхолдер блок, представляващ LTI старта. Кликнете Save and Close на темата.
Когато темата се зареди, Brightspace заменя плейсхолдера с iframe, който автоматично стартира FastComments чрез LTI. Студентите виждат нишката с дискусията вградено.
Една HTML тема може да съдържа множество deep-linked вграждания на FastComments. Всяко вграждане получава собствена нишка, защото всеки deep link генерира различен resource link ID.
Тема в модул срещу вграден кратък линк (Inline Quicklink)
Изберете подхода с модула/темата когато:
- Дискусията е основната дейност за тази стъпка в модула.
- Искате темата да се появява в съдържанието на Brightspace, в проследяването на завършеност и в Class Progress.
Изберете подхода с вграденото когато:
- Коментарите трябва да стоят под друго съдържание на същата страница.
- Не искате отделен артикул, проследим за завършеност, в съдържанието.
Видимост, Чернова и Условия за пускане
Нова 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 стартиране.
Какво виждат студентите при първото стартиране
Когато студент кликне темата (или зареди HTML тема с вграждане):
- Brightspace извършва LTI 1.3 стартирането (launch) във фонов режим.
- FastComments получава името на студента, email, URL на аватара и ролята в LMS и ги използва за автоматично влизане. Няма подкана за вход в FastComments.
- Нишката с коментари за този resource link се визуализира в Brightspace iframe.
Картографиране на роли при стартиране:
- Brightspace
Administratorстава FastComments администратор (admin) за нишката (пълен достъп до модерация, изтриване, бан и конфигурация). - Brightspace
Instructorстава FastComments модератор (moderator) (pin, hide, delete, ban). - Всички останали роли (
Learner,TeachingAssistantи т.н.) стават стандартни коментатори.
Коментарите са приписани на Brightspace акаунта на студента. Ако студентът промени името или аватара си в Brightspace, следващото LTI стартиране синхронизира промяната.
Ограничете публичния достъп (Препоръчано)
По подразбиране, данните за коментарите на FastComments са публично четими. Всеки, който може да познае URL на нишка или API крайна точка, може да види коментарите, дори извън Brightspace. За дискусии в курсове почти сигурно искате да ограничите преглеждането само до записаните студенти.
Отворете вашата страница за персонализиране на widget и създайте правило с активирана опция Require SSO To View Comments, след което задайте нивото на сигурност на Secure SSO, така че нишките да могат да се зареждат само чрез подписаното LTI стартиране.
Вижте Protecting Comment Threads With Single-Sign-On за пълното ръководство, включително как да ограничите правилото до един домейн или страница.
Височина на iframe и преоразмеряване
FastComments изпраща org.imsglobal.lti.frameResize postMessage при всяко рендиране на нишката и при промени в съдържанието (нов коментар, разгъване на отговори). Brightspace слуша за това съобщение и коригира височината на iframe така, че нишката да не бъде изрязана и да не се показва вътрешна лента за превъртане.
Ако iframe остава с фиксирана малка височина:
- Потвърдете, че курсът се зарежда през HTTPS. postMessage слушателят на Brightspace отхвърля рамки със смесено съдържание.
- Потвърдете, че нито едно разширение на браузъра не блокира postMessage канала.
- За вграждания в HTML тема, заобикалящият HTML не трябва да опакова iframe в контейнер с фиксирана височина. Премахнете всеки inline
style="height: ..."от родителския елемент.
Специфични проблеми в Brightspace
Инструментът не се показва в избирача Add Existing. Разполагането не е разрешено за организационната единица на този курс. Администратор трябва да добави организационната единица (или родителска) в списъка Org Units на разполагането. Само регистрацията на инструмента не е достатъчна; разполагането определя кои курсове виждат инструмента.
deployment_id mismatch on launch. FastComments фиксира първия deployment_id, който види, за регистрацията. Ако администраторът изтрие оригиналното разполагане и създаде ново, стартирането от новото разполагане се отхвърля с грешка за несъответствие на разполагането. Решението е да регистрирате отново FastComments (генерирайте нов URL за регистрация (get it here) и изпълнете Dynamic Registration отново); старата записана конфигурация се заменя.
Инструментът стартира, но показва "Invalid LTI launch". Курсът е в различна структура на tenant/организация от тази, която покрива разполагането, или разполагането е било деактивирано след регистрацията. Проверете отново Admin Tools > Manage Extensibility > LTI Advantage > FastComments > плъзгача Enabled и списъка с организационни единици на разполагането.
Имена и роли липсват във FastComments. Brightspace изпраща LTI стартирания с Names and Role Provisioning Services (NRPS) claims. Ако курсът е бил ъпгрейднат от по-стар LTI 1.1 връзка, стартирането може да липсва name и email claims. Добавете отново FastComments темата чрез Add Existing (не мигрирайте старата връзка), така че стартирането да използва LTI 1.3.
Вграждането показва екран за вход вместо авто-SSO. HTML темата е вмъкната като обикновен
Добавяне към съдържанието на курс в Moodle 
Това ръководство описва добавянето на FastComments към курс в Moodle 4.x, след като администраторът на сайта е регистрирал инструмента и го е настроил да се показва в изборът на дейности. Ако FastComments все още не е регистриран, първо вижте ръководството за регистрация в Moodle.
Отворете курса в режим на редактиране
- Влезте в Moodle като Редактиращ учител (или по-висока роля) за курса.
- Отворете курса.
- Включете Режим на редактиране с превключвателя в горния десен ъгъл на заглавката на курса.
Moodle 4.x замени старото падащо меню „Добавяне на дейност или ресурс", използвано във 3.x, с диалогов прозорец за избор на дейности на цял екран. Moodle 4.5 запазва същия избор, но добавя ред със звезди/любими в горната част, така че закачването на FastComments веднъж го прави по-лесно достъпен в следващите раздели.
Добавяне на дейността FastComments
- Превъртете до раздела на курса (тема или седмица), където трябва да е дискусията.
- Кликнете Добавяне на дейност или ресурс в долната част на този раздел.
- В диалоговия прозорец за избор изберете FastComments. Ако не го виждате, преминете към раздела за проблеми по-долу.
Отваря се формата с настройки на дейността. Важните полета:
- Име на дейността (задължително). Показва се на страницата на курса и в оценника. Пример:
Week 3 Discussion. - Описание на дейността. Незадължителен уводен текст, изобразен над нишката с коментари.
- Показване на описанието на страницата на курса. Отметнете това, ако искате описанието да е видимо без кликване върху дейността.
- Предварително конфигуриран инструмент. Настроен на
FastComments(избира се автоматично при стартиране от избора). Не променяйте. - Контейнер за стартиране. Настройте на Нов прозорец. Вижте раздела за проблеми защо „Същият прозорец" се проваля в някои инсталации на Moodle.
- URL на инструмента, Публичен ключ, Споделена тайна, Персонализирани параметри. Оставете празни. Динамичната регистрация се погрижи за тях на ниво сайт.
Превъртете до долната част и кликнете Запази и върни към курса (или Запази и покажи, за да отворите дейността веднага).
Дейността се появява като ред в раздела с иконата на FastComments. Учениците кликват върху реда, за да отворят нишката с коментари.
Вграждане на FastComments в текста с редактора
За нишка в страница, глава от книга, урок или друг ресурс, който използва редактора Atto или TinyMCE:
- Отворете ресурса в режим на редактиране.
- Поставете курсора там, където трябва да се появи нишката.
- В лентата с инструменти на редактора кликнете бутона LTI / Външен инструмент. В Atto е означен като „Вмъкване на LTI Advantage съдържание". В TinyMCE (по подразбиране в Moodle 4.3+) е под менюто Още като Външни инструменти.
- Изберете FastComments от списъка с инструменти.
- FastComments отваря избор за дълбоки връзки (deep-linking). Потвърдете заглавието на нишката и кликнете Вграждане.
- Редакторът вмъква блок-заместител на LTI. Запазете ресурса.
Всяко вградено копие е отделна нишка, свързана с ID на елемента от дълбоката връзка, така че страница с три вградени FastComments получава три независими нишки.
Ограничаване на достъпа и настройки на групи
Стандартните настройки за дейности в Moodle се прилагат към дейностите FastComments:
- Общи настройки на модула > Режим на групите. Настройването на Отделни групи или Видими групи само по себе си не разделя FastComments на нишки за всяка група. Режимът на групите в Moodle филтрира само оценника и списъка с членове. За отделна нишка за всяка група добавете по една дейност FastComments за всяка група и използвайте Ограничаване на достъпа, за да обхватите всяка от тях.
- Ограничаване на достъпа > Добавяне на ограничение. Поддържа стандартните условия на Moodle: Дата, Оценка, Група, Групиране, Потребителски профил и вложени набори от ограничения. Използвайте Група, за да заключите дейност FastComments към една група.
- Завършване на дейността. Настройте на Учениците трябва да прегледат тази дейност, за да я завършат, ако искате проследяване на завършването. FastComments в момента не докладва събитие за завършване обратно към Moodle след стартирането.
Съпоставяне на роли
FastComments чете LTI claim-а roles, който Moodle изпраща при всяко стартиране, и го съпоставя по следния начин:
- Moodle Мениджър или Сайтов администратор -> FastComments admin
- Moodle Редактиращ учител или Нередактиращ учител -> FastComments moderator
- Moodle Ученик -> FastComments commenter
- Moodle Гост -> само за четене
Администраторите могат да изтриват всеки коментар, да блокират потребители и да редактират настройките на нишката. Модераторите могат да изтриват и одобряват коментари в нишката, в която са стартирали. Персонализираните роли в Moodle наследяват съпоставянето на архетипа, от който са клонирани.
Какво виждат учениците
Учениците кликват върху дейността FastComments (или превъртат до вградения блок в страница или книга). Moodle изпраща тяхната идентичност към FastComments чрез LTI стартирането:
- Няма екран за вход. FastComments ги вписва с помощта на Moodle акаунта.
- Тяхното показвано име, имейл и аватар идват от Moodle.
- Нишката е обвързана с
(Moodle сайт, курс, ID на ресурсна връзка), така че същата дейност, дублирана в друг курс, получава нова нишка. - Отговорите в нишка, гласуването и известията работят по същия начин като в самостоятелна нишка на FastComments.
Заключване на публичния достъп (препоръчително)
По подразбиране данните за коментари на FastComments са публично четими. Всеки, който може да познае URL на нишка или API крайна точка, може да види нейните коментари, дори извън Moodle. За дискусии в курс почти сигурно искате прегледът да е ограничен само до записани ученици.
Отворете вашата страница за персонализиране на уиджета и създайте правило с активирано Require SSO To View Comments, след което задайте нивото на сигурност на Secure SSO, така че нишките да могат да се зареждат само чрез подписаното LTI стартиране.
Вижте Защита на нишките с коментари чрез Single-Sign-On за пълното ръководство, включително как да обхватите правилото до един домейн или страница.
Проблеми в Moodle
FastComments липсва в избора на дейности. Администраторът на сайта е регистрирал инструмента, но не е настроил Използване на конфигурацията на инструмента на Показване в избора на дейности и като предварително конфигуриран инструмент. Коригирайте това под Администриране на сайта > Плъгини > Модули с дейности > Външен инструмент > Управление на инструменти > иконата със зъбно колело на плочката FastComments.
Стартирането се проваля или показва празен кадър при настройка „Същият прозорец". Бисквитките за сесия на Moodle използват SameSite=Lax по подразбиране, а някои браузъри ги отстраняват при междусайтовия POST, който LTI 1.3 използва за връщане от FastComments. Настройте Контейнер за стартиране на Нов прозорец за дейността. Това е задължително изискване за вграден FastComments в страница или книга, тъй като пътят на стартиране, вграден в редактора, винаги отваря нов прозорец.
Claim-ът iss е URL на Moodle сайта, а не tenant ID. FastComments използва URL на Moodle сайта (стойността на конфигурацията wwwroot) като LTI издател. Ако вашият Moodle екземпляр се премести на нов домейн или промените wwwroot, съществуващите нишки на FastComments остават обвързани със стария издател и няма да съвпадат с нови стартирания. Регистрирайте инструмента отново с новия URL и при нужда мигрирайте нишките чрез администрацията на FastComments.
Резервно копиране и възстановяване на дейности. Резервирането на курс и възстановяването му в нов курс създава нови ID на ресурсни връзки, така че възстановените дейности 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 на Content Editor-а.
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-linked ресурса.
- Подайте елемента.
Всяко deep-link вграждане създава собствена FastComments нишка, така че един Item с два вградени FastComments блока има два независими потока от коментари.
Видимост, условия за публикуване и ограничения по групи
Елементите със съдържание на FastComments се държат като всеки друг елемент на съдържанието в Blackboard относно правилата за контрол на достъпа, приложими върху тях.
- Ultra: кликнете селектора за видимост в реда (Visible to students, Hidden from students, Conditional availability). Conditional availability поддържа прозорци за дата/час, правила за представяне спрямо елементи от книга с оценки и правила за членство спрямо групи в курса.
- Original: отворете контекстното меню на елемента и изберете Adaptive Release или Adaptive Release: Advanced, за да ограничите достъпа до инструмента по дата, членство, оценка или статус на преглед. Използвайте Set Group Availability върху елемента, за да ограничите до конкретни групи в курса.
FastComments уважава каквото и да е решение за блокиране от Blackboard. Ако Blackboard скрие елемента от студент, LTI стартирането никога не се извършва за този студент и той/тя не се появява във вюто на модератора.
Поведение в Gradebook
FastComments не изпраща оценки обратно чрез LTI Advantage Assignment and Grade Services. За елементите на съдържанието FastComments не се създава автоматично колона за оценки.
Ако вашият Blackboard тенант е конфигуриран да създава автоматично колона в книгата с оценки за всеки нов елемент съдържание независимо от метаданните за оценяване, може да се появи празна колона. За да я скриете:
- 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 идентичност (име, имейл, аватар, роля) без да вижда форма за влизане.
- Нишката с коментари се визуализира в iframe. Threading, replies, mentions и reactions са налични в зависимост от настройките на коментарния уиджит конфигурирани в 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 за пълното ръководство, включително как да ограничите правилото до един домейн или страница.
Обхват на нишката
FastComments обхваща всяка нишка по (Blackboard host, course ID, resource link ID). Два FastComments елемента в един и същ курс създават две нишки. Същият елемент, копиран в два различни курсови контейнера (например чрез course copy), създава две нишки, защото Blackboard издава нов resource link ID при копирането. За да запазите споделена нишка при копиране на курсове, използвайте Deep Linking с експлицитен thread 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 Configuration за този тенант. Ако се различават, изтрийте поставянето и стартирайте отново динамичната регистрация от нов URL за регистрация (вземете го тук).
Височината на iframe изглежда фиксирана или съдържанието се отрязва. Някои Blackboard тенанти доставят строг Content Security Policy, който блокира стандартното LTI iframe-resize postMessage. FastComments излъчва както Canvas-стил lti.frameResize съобщение, така и IMS spec-form org.imsglobal.lti.frameResize съобщение за максимална съвместимост, но tenant-нулево заместване на CSP блокира listener-а в родителя. Помолете вашия администратор да потвърди, че *.fastcomments.com е в allowlist-а на LTI инструмента и че няма персонализиран CSP хедър, който отстранява postMessage събитията. След това оразмеряването работи без допълнителна конфигурация.
Копирането на курса дублира нишките. При копиране на курс Blackboard издава нови resource link ID-та за LTI поставянията, така че копираните курсове започват с празни нишки. Това е очаквано. Ако искате копираният курс да наследи оригиналната нишка, настройте Deep Linking с експлицитен thread URN преди копирането, или се свържете с поддръжката на FastComments, за да пренасочат ID-тата на нишките в масов порядък.
Студент вижда обща грешка на Blackboard при стартиране. Причината е липсващо или остаряло твърдение 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 старт.
Вижте Protecting Comment Threads With 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(admin in 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) Инсталиране на ниво организация. Системният администратор на 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 (grade passback) OFF. FastComments не връща оценки обратно в Schoology, така че включването на връщането на оценки създава празна колона в журнала с оценки.
- Кликнете Submit.
Материалът вече се появява в списъка с материали на курса и отваря нишката на FastComments при кликване.
3. Вграждане в редактoра Rich Text
Ако Системният администратор е активирал Deep Linking placement за 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 е автоматично чрез Schoology LTI старта под техния 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 placement на ниво организация. Когато това е така, обучителите виждат само потока Add Materials > External Tool, а не бутона External Tool в Rich Text редактора. За да разрешите вграждането в ред (inline), Системният администратор отива на System Settings > Integration > LTI 1.3 > FastComments и активира разположението Content Item / Deep Linking, след което запазва.
- Замяна на присвояване по секции. Ако FastComments е назначен на ниво организация, но обучителят не може да го види в 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 е предоставил малформиран или недостъпен discovery URL. Свържете се с поддръжката на вашия LMS.
При стартиране се показва "Configuration not found"
Или конфигурацията в FastComments е била изтрита, или стартирането идва от двойка iss/client_id, която не разпознаваме. Ако сте изтрили и повторно регистрирали, инструктирайте вашия LMS да премахне и повторно добави инструмента FastComments, така че да получи новия client_id.
При стартиране се показва "Deployment not registered"
Стартирахте FastComments от deployment на Brightspace/Moodle/Blackboard, различен от този, в който е било стартирано за първи път. FastComments записва deployment_id при първото стартиране като проверка за сигурност. За да добавите нов deployment под същия клиент, се свържете с поддръжката - ние ще добавим deployment ID-то към конфигурацията.
При стартиране се показва "Unsupported message_type"
LMS е изпратил LTI съобщение, което FastComments не обработва (напр. LtiSubmissionReviewRequest). FastComments поддържа само стандартния resource-link launch и deep-linking потоци. Свържете се с нас, ако имате нужда от добавяне на конкретен тип съобщение.
Iframe не се преоразмерява
Повечето LMS автоматично преоразмеряват LTI iframes. Ако вашият не го прави, проверете дали настройките за стартиране на LMS позволяват на инструмента да изпраща postMessage събития към родителския frame. FastComments изпраща както Canvas-стил (lti.frameResize), така и IMS-спецификация (org.imsglobal.lti.frameResize) съобщения за преоразмеряване.
Най-малко привилегии и минимизиране на данните 
Интеграцията на FastComments LTI 1.3 следва принципа на най-малките привилегии: използва само claims от стартирането (launch), необходими за идентифициране на потребителя, свързване на коментарите с правилния курс и ресурс, и прилагане на разрешения, базирани на роли.
Останалата част от тази страница описва всеки claim, който интеграцията използва, всяка услуга на LTI Advantage, която не изисква, и всяка категория данни, които не събира. Рецензенти по сигурност и обществени поръчки могат да извлекат отговорите директно от таблиците по-долу.
Получавани елементи на данни от LMS
Всяко LTI 1.3 стартиране носи подписан JWT от LMS. FastComments извлича следните claims от този JWT и не използва нищо друго:
| Поле | LTI claim | Предназначение | Задължителен | Съхранява се |
|---|---|---|---|---|
| Идентификатор на потребителя | sub | Идентифицира потребителя последователно при различни стартирания, така че едно и също лице да се съпоставя с един и същ FastComments SSO потребител | Да | Да, като част от стабилен вътрешен SSO ID |
| Показвано име | name | Приписване, показвано до коментарите на потребителя | Да (при липса се използва "LMS User") | Да |
| Имейл | email | Съпоставяне на акаунти, известия, модерация, кореспонденция с поддръжката | По избор (интеграцията работи и без него) | Да, когато е предоставен |
| URL на аватар | picture | Показва се до коментарите на потребителя | По избор | Само URL; FastComments не изтегля или прехранва изображението |
| Роли | https://purl.imsglobal.org/spec/lti/claim/roles | Определя дали потребителят е администратор, преподавател (модератор) или обучаем | Да | Изведени флагове isAdmin / isModerator в SSO сесията |
| Контекст на курса | https://purl.imsglobal.org/spec/lti/claim/context (id, title) | Свързва нишката с коментари с правилния курс в LMS | Да | Да, като част от разрешения идентификатор на страницата |
| Resource link | https://purl.imsglobal.org/spec/lti/claim/resource_link (id) | Свързва коментарите с правилната дейност или поставяне на инструмента в курса | Да, когато е наличен | Да, като част от разрешения идентификатор на страницата |
| Deployment ID | https://purl.imsglobal.org/spec/lti/claim/deployment_id | Насочва стартирането към правилната конфигурация на FastComments tenant | Да | Да, в записа на конфигурацията на FastComments LTI |
Claims и scopes, декларирани при регистрация
По време на LTI 1.3 Dynamic Registration, FastComments се регистрира с scope: "" (без допълнителни OAuth scopes) и декларира само следните OpenID Connect claims:
iss, sub, name, email, picture
Регистрира два типа съобщения:
LtiResourceLinkRequest- стандартното стартиране на курса в FastComments.LtiDeepLinkingRequest- позволява на преподавателите да поставят инструмента FastComments в курс.
Не се изискват допълнителни токени за достъп от LMS.
Услуги на LTI Advantage, които не се изискват
| Услуга / scope | Изисква ли се? | Причина |
|---|---|---|
| Names and Role Provisioning Services (NRPS) | Не | Интеграцията не се нуждае от списък на курса; идентичността на потребителя пристига с всяко стартиране |
| Assignment and Grade Services (AGS) - lineitem, score, result scopes | Не | Интеграцията не е съобразена с оценъчната книга |
| Deep Linking извън стандартното връщане при поставяне | Без допълнителни данни | Deep linking се използва само за поставяне на инструмента от преподавател; не се изброява съдържание на курса |
Данни, които не се събират
Освен самия LTI, FastComments не изисква и не получава следното от LMS или потребителя:
| Категория | Събира ли се? |
|---|---|
| Оценки на студентите | Не |
| Предадени работи по задания | Не |
| Записи за присъствие | Не |
| Пълни списъци на курса | Не |
| Правителствени идентификатори | Не |
| Дата на раждане | Не |
| Пощенски адрес или телефонен номер | Не |
| Финансова информация | Не |
| Идентификационни данни на LMS администратор | Не |
Границите на достъпа
- FastComments получава данни само в рамките на оторизирано LTI 1.3 стартиране, подписано с регистрираните ключове на LMS. Интеграцията не се обажда обратно към LMS за допълнителна информация.
- Токените за стартиране са за еднократна употреба и краткотрайни. Повторно използвани или изтекли токени се отхвърлят.
- LMS администраторите контролират къде се разполага инструментът в тяхната платформа. D2L Brightspace например поддържа обхват по org unit за всяко разполагане и настройки за сигурност за всяко разполагане, което позволява на администраторите да ограничат инструмента до конкретни курсове или org units, вместо да го направят глобално достъпен. Moodle, Blackboard, Sakai и Schoology предлагат еквивалентни контроли за всяко разполагане в своите LTI 1.3 реализации.
Съхранение и задържане
FastComments задържа данните, получени от LTI, за продължителността на активната услуга за коментиране и съгласно настроените от клиента настройки за задържане. Данните от коментарите се съхраняват в производствено хранилище, шифровано в покой. При прекратяване на акаунта или писмена заявка за изтриване FastComments изтрива или анонимизира данните на клиента съгласно приложимото споразумение.
За пълни подробности за съхранението и обработката на данните вижте Политиката за поверителност на FastComments.
Честота на преглед
Всяка нова LTI функция, която би изисквала допълнителни claims, scopes или услуги на LTI Advantage, се преглежда преди пускането, за да се потвърди, че исканият достъп е необходим и пропорционален на пусканата функция.
Кратко изявление за анкети за сигурност
FastComments прилага най-малките привилегии и минимизиране на данните в своята LTI 1.3 интеграция. Интеграцията използва само LTI claims от стартирането, необходими за автентикация на потребителя (
sub,name,picture), определяне на ролята му и идентифициране на курса и ресурса, към които принадлежат коментарите. FastComments не изисква Names and Role Provisioning Services, Assignment and Grade Services, данни от оценъчната книга, присъствие, пълни списъци или административен достъп до LMS. LMS администраторите запазват контрола върху това в кои org units, курсове и разполагания инструментът е достъпен.
Добавяне на анкети към вашия LMS курс 
След като FastComments е в курса ви в LMS, можете също да провеждате живи анкети директно в коментарите. Включете Enable Polls в настройките за персонализиране на вашия уиджет и бутон за анкета ще се появи в лентата с инструменти на коментара. Анкетите имат от 2 до 10 опции, резултатите се актуализират в реално време за всички на страницата, и вие избирате кой може да създава анкети и дали гласуването изисква влизане. Няма нищо друго за инсталиране в LMS.
Опитайте демонстрацията на живи анкети или прочетете Документацията за анкети за да ги настроите.