LTI 1.3 経由で LMS にコメントを追加する

1. FastComments にサインインし、あなたの LTI 1.3 構成ページに移動します。
2. (オプション) 接続元のプラットフォームを Platform ドロップダウンから選択します - 表示ラベルが設定されますが、Auto-detect でも問題ありません。
3. Generate URL をクリックします。ワンタイムの Registration URL が表示されます（有効期限は30分、単回使用）。
4. LMS で LTI 1.3 の Dynamic Registration 画面を開き、URL を Tool initiation registration endpoint（または同等の）フィールドに貼り付けて送信します。
5. LMS が FastComments にコールバックし、鍵を交換して統合を作成します。完了するとポップアップは自動で閉じます。
6. 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 が利用可能な場合)

Dynamic Registration を備えた IMS LTI 1.3 Advantage 仕様を実装しているその他の LMS でも動作するはずです — 登録用 URL を生成する際はプラットフォームのドロップダウンから Other LTI 1.3 platform を選択してください（こちらで取得できます）。

Canvas LMS は別のセットアップ手順を使用します（Dynamic Registration の代わりに per-developer-key 構成の JSON を使用）。専用の Canvas LMS インストールガイドを参照してください。

LTI 1.3 設定に移動

FastComments にサインインし、LTI 1.3 設定ページに移動してください。

アカウントにまだ LTI アクセスがない場合は「LTI not enabled for this account」と表示されます。プランで有効にするにはサポートに連絡してください。

プラットフォームを選択（任意）

Generate a Dynamic Registration URL の下で、Platform ドロップダウンを使い、どの LMS に接続するかを FastComments に伝えます:

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

Auto-detect のままにしておくこともできます。登録中に LMS の openid-configuration からプラットフォームが読み取られます。ドロップダウンは生成される構成の表示ラベルを設定するためだけに使われます。

URL を生成する

Generate URL をクリックします。FastComments はワンタイム登録トークンを作成し、次のような URL を表示します:

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

コピーしてください。この URL は:

• は 単回使用 です — 一度 LMS が正常に呼び出すとトークンは消費されます。
• 使用されない場合、30 分後に期限切れになります。
• 非公開にしてください — URL を持っている人はその 30 分以内にあなたのテナントに対してツールを登録できます。

既存の構成

登録が正常に完了すると、新しい構成が同じページの 既存の構成 テーブルに表示され、プラットフォーム、Issuer、Client ID、およびステータスが確認できます。登録解除が必要になった場合は、このテーブルから構成を削除できます。

D2L Brightspace は LTI Advantage 管理インターフェースを通じて Dynamic Registration を公開しています。管理者アクセスが必要です。

登録画面を開く

1. 管理者として Brightspace インスタンスにサインインします。
2. Admin Tools > Manage Extensibility > LTI Advantage に移動します。
3. Register Tool をクリックします。（直接の URL は https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create です。）

URL を貼り付ける

登録フォームが表示されます。重要な項目は Tool initiation registration endpoint（一部の Brightspace バージョンでは "Tool Initiation Registration URL" と表記されます）です。

FastComments の登録 URL (ここで取得できます) をそのフィールドに貼り付けます。他のフィールドは空のままにしておいてください — 登録ハンドシェイク中に FastComments が自動的に入力します。

Register をクリックします。

ツールを承認する

Brightspace は FastComments と通信するポップアップを開き、キーを交換して確認画面を表示します。登録が完了するとポップアップは自動で閉じます。

新しいツールは LTI Advantage のツール一覧に表示されます。デフォルトでは Brightspace は新しいツールを disabled としてマークします — コースで使用できるようにトグルを enabled に切り替えてください。

デプロイメントを追加する

Brightspace では、LTI ツールがコースで使用される前に deployment が必要です:

1. 新しく登録した FastComments ツールを開きます。
2. View Deployments > New Deployment をクリックします。
3. デプロイメントに名前を付け（例: "FastComments - All Courses"）、利用可能にする組織単位を選択して保存します。

このデプロイメントを通じて最初に起動すると、FastComments は構成レコードに deployment_id を固定します — 同一クライアントの別のデプロイメントからのその後の起動は、再登録しない限り拒否されます。

Moodle を使っていますか？ FastComments は LTI 1.3 よりも緊密に統合された専用の Moodle プラグイン（成績同期フック、より詳細なアクティビティ報告、ネイティブな Moodle 設定 UI）も公開しています。Moodle プラグインインストールガイド を参照してください。以下の LTI 1.3 フローは、他の LMS もカバーする単一の登録を行いたい場合、または Moodle 管理者がサードパーティプラグインをインストールしない場合に適した選択です。

Moodle 4.0+ は External Tool プラグインを通じて LTI 1.3 の動的登録をサポートします。

ツール管理画面を開く

1. サイト管理者として Moodle にサインインします。
2. Site administration > Plugins > Activity modules > External tool > Manage tools に移動します。

URL を貼り付ける

Tool URL というラベルのカードが表示されます。テキストフィールドに FastComments の登録 URL (こちらから取得) を貼り付け、Add LTI Advantage をクリックします。

Moodle はツールの識別情報と要求している権限を表示する登録画面を開きます。内容を確認して Activate（Moodle のバージョンによっては Register）をクリックします。

登録が完了するとポップアップは閉じ、新しい FastComments ツールが Tools リストに Active ステータスで表示されます。

利用可能にする

デフォルトでは Moodle は新しいツールを「Course tools」リストに追加しますが、アクティビティピッカーには表示しません。コース全体で FastComments を表示するには:

1. FastComments タイルの歯車アイコンをクリックします。
2. Tool configuration usage の下で Show in activity chooser and as a preconfigured tool を選択します。
3. 保存します。

講師はこれで Add an activity or resource > FastComments から任意のコースに FastComments を追加できるようになります。

Blackboard Learn SaaS と Ultra は LTI 1.3 の動的登録（Dynamic Registration）をサポートしています。

ツールプロバイダ画面を開く

1. システム管理者として Blackboard にサインインします。
2. Administrator Panel > Integrations > LTI Tool Providers に移動します。
3. Register LTI 1.3 / LTI Advantage Tool をクリックします。

もし「Register LTI 1.1 Provider」のみが表示される場合、あなたの Blackboard バージョンはまだ LTI 1.3 をサポートしていません — アップグレードするか Blackboard サポートにお問い合わせください。

URL を貼り付ける

FastComments の登録用 URL (ここで取得できます) を Client ID / Registration URL フィールドに貼り付けます（Blackboard の表記はバージョンによって異なります）。送信します。

Blackboard が FastComments と登録のハンドシェイクを行い、確認画面を表示します。

承認と有効化

Blackboard は、新しく登録されたツールをデフォルトで Approved but excluded とマークします:

1. ツールプロバイダ一覧で FastComments のエントリを探します。
2. メニューを開き、Edit を選択します。
3. Tool Status を Approved に設定します。
4. Institution Policies の下で、どのユーザーデータが送信されるか（name, email, role）を確認します。保存します。

これで、講師がコースにコンテンツを追加する際にツールを利用できるようになります。

Sakai

Sakai は LTI Advantage を含むリリースで LTI 1.3 の Dynamic Registration をサポートしています。Administration Workspace から:

1. Sakai の管理者としてサインインし、Administration Workspace を開きます。
2. External Tools > Install LTI 1.3 Tool を選択します。
3. FastComments の登録用 URL（ここで取得）を貼り付けて送信します。
4. ハンドシェイクが完了したらツールを承認します。

ツールはその後 External Tools に表示され、サイトの管理者によってサイトに追加できます。

Schoology

Schoology の Enterprise インスタンスは LTI 1.3 をサポートしますが、Dynamic Registration の利用可否はデプロイによって異なります。Schoology のアカウントマネージャーに確認してください。

お使いの Schoology インスタンスで Dynamic Registration が利用できない場合、次のエンドポイントを使って統合を手動で設定する必要があります:

• 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 サポートへ連絡してください。

Other LTI 1.3 Platforms

IMS LTI 1.3 Advantage 仕様に準拠する任意の LMS は、同じ登録 URL（ここで取得）で動作するはずです。設定項目として "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint", またはそれに類する項目を探してください。

プラットフォームが手動での LTI 1.3 設定のみをサポートする場合は、上の Schoology セクションに記載された 4 つのエンドポイントを使用し、設定完了のためにサポートに連絡してください。

このページでは、管理者がツールを登録しデプロイメントを作成した後に、Brightspace コースに FastComments を追加する手順を説明します。ツールがまだ登録されていない場合は、まず D2L 登録ガイドを参照してください。

Brightspace のユニットトピックに埋め込まれた FastComments

Brightspace には 2 つのコンテンツ作成体験が含まれます: Classic Content（クラシックコンテンツ） と New Content Experience（新しいコンテンツ体験、Lessons とも呼ばれる）。どちらも FastComments を利用できますが、メニューのパスが異なります。以下の各セクションでは、分岐する箇所で両方を扱います。

FastComments ツールの場所を特定する

FastComments ツールは、コースのコンテンツエディタ内で次の 2 か所に表示されます:

1. モジュール/ユニットの Add Existing ボタン（古い Brightspace では Add Existing Activities と表示）からアクセスするアクティビティピッカー。現在の Brightspace ではピッカー内に直接 FastComments が表示されます。古いバージョンでは External Learning Tools サブメニューの下にネストされています。どちらの経路でも FastComments を独立したトピックとして追加します。
2. HTML エディタ内の Insert Stuff ダイアログの LTI Advantage の下。これにより LTI のディープリンクフローを通じて HTML トピック内に FastComments をインライン埋め込みできます。

どちらのピッカーにも FastComments が表示されない場合は、デプロイメントがそのコースを保持する組織ユニットに対して有効になっていません。Brightspace 管理者に依頼して、Admin Tools > Manage Extensibility > LTI Advantage > FastComments ツール > View Deployments を開き、デプロイメントを開いて Org Units の下にコースの組織ユニット（または親の組織ユニット）を追加してもらってください。

モジュールにトピックとして FastComments を追加する

Classic Content（クラシックコンテンツ）:

1. コースを開き、ナビバーの Content をクリックします。
2. ディスカッションを格納するモジュールを選択します（または Add a module で作成します）。
3. Add Existing をクリックします（古い Brightspace: Add Existing Activities > External Learning Tools）。
4. ピッカーで FastComments をクリックします。Brightspace がモジュールにトピックを作成し、コンテンツビューに戻ります。
5. 新しいトピックをクリックします。インラインタイトルエディタを使って、FastComments Discussion のような説明的な名前に変更します。

New Content Experience（Lessons）:

1. コースを開き、Content をクリックします。
2. ディスカッションを格納するユニットとレッスンを開きます。
3. Add > Existing Activity をクリックし、FastComments を選択します（古い Brightspace: External Learning Tools の下にネスト）。
4. アクティビティがレッスンに追加されます。
5. アクティビティのタイトルをクリックして名前を変更します。

どのユーザー（講師または学生）でもトピックを初めて開くと、FastComments はそのリソースリンク用のスレッドを初期化します。スレッドはリソースリンク ID に紐付けられるため、トピックの名前を変更したり移動したりしても読み込まれるスレッドは変わりません。

HTML トピック内に FastComments をインライン埋め込む

読み物、ビデオ、またはその他のコンテンツの下に同じトピックページ内でコメントを表示したい場合は、このフローを使用します（別トピックとしてではなく）。

1. モジュール/レッスンで HTML トピックを開くか作成します。
2. Edit HTML をクリックして Brightspace の HTML エディタを開きます。
3. コメントスレッドを表示したい位置にカーソルを置きます。
4. エディタツールバーのパズルピースアイコン（Insert Stuff ボタン）をクリックします。
5. Insert Stuff ダイアログで LTI Advantage にスクロールし、FastComments をクリックします。
6. FastComments がディープリンクピッカーを開きます。配置を確認します（デフォルトオプションはコンテンツディスカッションに適しています）。Insert または Continue をクリックします。
7. Brightspace はプレースホルダーブロックを伴って HTML エディタに戻します（LTI ランチを表すもの）。トピックで Save and Close をクリックします。

トピックが読み込まれると、Brightspace はプレースホルダーを iframe に置き換え、LTI 経由で自動的に FastComments を起動します。学生はインラインでディスカッションスレッドを見ることができます。

単一の HTML トピックには複数のディープリンクされた FastComments 埋め込みを保持できます。各埋め込みはそれぞれ固有のスレッドを持ちます。各ディープリンクは異なるリソースリンク ID を生成するためです。

モジュールトピック vs インライン クイックリンク

次の場合は「モジュールトピック」アプローチを選んでください:

• そのモジュールのステップにおいてディスカッションが主要なアクティビティである場合。
• Brightspace の目次、完了トラッキング、および Class Progress にトピックを表示したい場合。

次の場合は「インライン埋め込み」アプローチを選んでください:

• コメントを同じページ内の他のコンテンツの下に配置したい場合。
• 目次に別の完了トラッカブルな項目を表示したくない場合。

可視性、ドラフト、リリース条件

新しい FastComments トピックはデフォルトで学生に表示されます。セットアップ中に非表示にするには:

1. コンテンツエディタでトピックタイトルをクリックします（Classic）またはアクティビティの三点メニューをクリックします（New Content Experience）。
2. ステータスを Draft に設定する（Classic）か、Visibility をオフに切り替えます（New Content Experience）。

ドラフトトピックは学生には表示されません。講師と TA は「Draft」バッジ付きで引き続き表示できます。

特定のグループやセクションにトピックを制限するには:

1. トピックを開きます。
2. トピックタイトルメニュー > Edit Properties In-place（Classic）または Edit > Restrictions（New Content Experience）をクリックします。
3. Release Conditions の下で Create をクリックします。
4. Group enrollment または Section enrollment を選択し、グループ/セクションを指定して保存します。

リリース条件は FastComments の独自のロールマッピングと組み合わされます。トピックを表示できない学生は LTI ランチを受け取りません。

学生の初回起動時に表示されるもの

学生がトピックをクリックする（または埋め込みのある HTML トピックを読み込む）と:

1. Brightspace がバックグラウンドで LTI 1.3 のランチを実行します。
2. FastComments は学生の名前、メール、アバター URL、LMS ロールを受け取り、自動的にサインインします。FastComments のログイン画面は表示されません。
3. そのリソースリンク用のコメントスレッドが Brightspace の iframe 内にレンダリングされます。

ランチ時のロールマッピング:

• Brightspace の Administrator はスレッドに対して FastComments の管理者（admin）になります（完全なモデレーション、削除、追放、設定アクセス）。
• Brightspace の Instructor は FastComments のモデレーター（moderator）になります（ピン、非表示、削除、追放）。
• その他すべてのロール（Learner、TeachingAssistant など）は標準のコメント投稿者になります。

コメントは学生の Brightspace アカウントに帰属します。学生が Brightspace で名前やアバターを編集した場合、次回の LTI ランチで変更が同期されます。

公開アクセスを制限する（推奨）

デフォルトでは、FastComments のコメントデータは公開で読み取り可能です。スレッドの URL や API エンドポイントを推測できる人は、Brightspace 以外からでもコメントを閲覧できます。コースのディスカッションでは、履修学生のみに閲覧を制限するのがほとんどの場合望ましいです。

自分の widget customization page を開き、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 経由で読み込まれていることを確認してください。Brightspace の postMessage リスナーは混在コンテンツのフレームを拒否します。
• ブラウザ拡張機能が postMessage チャネルをブロックしていないことを確認してください。
• HTML トピック内のインライン埋め込みの場合、親の HTML が iframe を固定高さのコンテナでラップしていないことを確認してください。親要素の inline な style="height: ..." を削除してください。

Brightspace 固有のトラブルシューティング

Add Existing ピッカーにツールが表示されない。 デプロイメントがこのコースの組織ユニットに対して有効になっていません。管理者がデプロイメントの Org Units リストに組織ユニット（または親）を追加する必要があります。ツールの登録だけでは不十分です。デプロイメントがどのコースがツールを表示できるかを制御します。

ランチ時の deployment_id の不一致。 FastComments は登録時に最初に見た deployment_id を TOFU 的にピン留めします。管理者が元のデプロイメントを削除して新しいものを作成した場合、新しいデプロイメントからのランチはデプロイメント不一致エラーで拒否されます。修正方法は FastComments を再登録することです（新しい登録 URL を生成して（ここで取得できます）Dynamic Registration を再実行します）；古い構成レコードは置き換えられます。

ツールは起動するが「Invalid LTI launch」と表示される。 コースがデプロイメントがカバーするテナント/組織構造と異なる、または登録後にデプロイメントが無効化された可能性があります。Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled トグルとデプロイメントの組織ユニットリストを再確認してください。

FastComments 内で名前やロールが欠落している。 Brightspace は Names and Role Provisioning Services（NRPS）クレームを含む LTI ランチを送信します。コースが古い LTI 1.1 リンクからアップグレードされた場合、ランチに name と email クレームが欠けていることがあります。FastComments トピックを再度 Add Existing で追加してください（古いリンクを移行しないでください）。そうすることでランチが LTI 1.3 を使用します。

埋め込みが自動 SSO ではなくログイン画面を表示する。 HTML トピックが Insert Stuff > LTI Advantage を経由せず、FastComments を直接指す通常の <iframe> として挿入されている可能性があります。通常の iframe は LTI ランチをスキップし、ユーザーを公開向けの FastComments ページに送ります。iframe を削除し、Insert Stuff フローで再挿入してください。

このガイドでは、サイト管理者がツールを登録してアクティビティ選択で表示するように設定した後に、Moodle 4.x コースに FastComments を追加する方法を説明します。FastComments がまだ登録されていない場合は、まず Moodle 登録ガイドを参照してください。

コースを編集モードで開く

1. コースの編集教師（またはそれ以上）の権限で Moodle にサインインします。
2. コースを開きます。
3. コースヘッダー右上のスイッチで 編集モード をオンに切り替えます。

Moodle 4.x は 3.x の「アクティビティまたはリソースを追加」ドロップダウンを廃止し、フルスクリーンのアクティビティ選択ダイアログに置き換えました。Moodle 4.5 は同じ選択ダイアログを保持し、上部にスター付き／お気に入り行を追加しているので、一度 FastComments をピン留めしておくと後で見つけやすくなります。

FastComments アクティビティを追加する

1. ディスカッションを配置したいコースのセクション（トピックまたは週）までスクロールします。
2. そのセクションの下部にある アクティビティまたはリソースを追加 をクリックします。
3. 選択ダイアログで FastComments を選択します。表示されない場合は、以下の「トラブルシューティング」セクションを参照してください。

アクティビティ設定フォームが開きます。重要なフィールドは次のとおりです:

• Activity name（必須）。コースページと成績簿に表示されます。例: Week 3 Discussion。
• Activity description。コメントスレッドの上に表示される任意の導入テキスト。
• Show description on course page。アクティビティを開かなくても説明を表示したい場合はチェックします。
• Preconfigured tool。FastComments に設定します（選択ダイアログから起動すると自動選択されます）。変更しないでください。
• Launch container。New window に設定します。いくつかの Moodle 配備で「Same window」が動作しない理由はトラブルシューティングを参照してください。
• Tool URL, Public key, Shared secret, Custom parameters。空欄のままにします。これらはサイトレベルでの動的登録が処理しています。

下までスクロールして Save and return to course（またはすぐにアクティビティを開く場合は Save and display）をクリックします。

アクティビティは該当セクションに FastComments アイコン付きの行として表示されます。学生はその行をクリックしてコメントスレッドを開きます。

エディタ内に FastComments をインライン埋め込む

Page、Book の章、Lesson、または Atto や TinyMCE エディタを使用するその他のリソース内にスレッドを埋め込む場合:

1. リソースを編集モードで開きます。
2. スレッドを表示したい位置にカーソルを置きます。
3. エディタのツールバーで LTI / External tool ボタンをクリックします。Atto では「Insert LTI Advantage content」と表示されます。TinyMCE（Moodle 4.3+ のデフォルト）では More メニューの中の External tools にあります。
4. ツール一覧から FastComments を選びます。
5. FastComments がディープリンクのピッカーを開きます。スレッドタイトルを確認して Embed をクリックします。
6. エディタは LTI プレースホルダーブロックを挿入します。リソースを保存します。

埋め込まれた各インスタンスはディープリンクのコンテンツアイテム ID をキーとする個別のスレッドなので、1つの Page に FastComments の埋め込みが 3 つある場合は独立した 3 つのスレッドになります。

アクセス制限とグループ設定

FastComments アクティビティには標準の Moodle アクティビティ設定が適用されます:

• Common module settings > Group mode。これを Separate groups または Visible groups に設定しても、FastComments が自動的にグループごとのスレッドに分割されるわけではありません。Moodle のグループモードは成績簿とメンバーリストをフィルタリングするだけです。グループごとに別々のスレッドを運用するには、各グループごとに FastComments アクティビティを追加し、Restrict access で各アクティビティの対象範囲を制限してください。
• Restrict access > Add restriction。標準の Moodle 条件（Date, Grade, Group, Grouping, User profile, およびネストされた制限セット）に対応しています。特定のグループに FastComments アクティビティをロックするには Group を使用します。
• Activity completion。完了トラッキングを有効にしたい場合は Students must view this activity to complete it に設定します。現時点で FastComments は起動以外の完了イベントを Moodle に返しません。

ロールマッピング

FastComments は Moodle が起動時に送信する LTI の roles クレームを読み取り、次のようにマップします:

• Moodle Manager または Site administrator -> FastComments admin
• Moodle Editing teacher または Non-editing teacher -> FastComments moderator
• Moodle Student -> FastComments commenter
• Moodle Guest -> 読み取り専用

管理者は任意のコメントを削除したり、ユーザーを禁止したり、スレッド設定を編集できます。モデレーターは起動したスレッド内でコメントの削除や承認が可能です。カスタム Moodle ロールは、それがクローンされたアーキタイプのマッピングを継承します。

学生が見るもの

学生は FastComments アクティビティをクリックするか（または Page や Book 内の埋め込みブロックまでスクロールします）。Moodle は起動時に LTI を通じて学生の識別情報を FastComments に送ります:

• ログイン画面は表示されません。FastComments は Moodle アカウントを使って学生をサインインさせます。
• 表示名、メールアドレス、アバターは Moodle から取得されます。
• スレッドは (Moodle site, course, resource link ID) にスコープされるため、同じアクティビティを別のコースに複製すると新しいスレッドが作成されます。
• スレッド形式の返信、投票、通知はスタンドアロンの FastComments スレッドと同じように動作します。

公開アクセスを制限する（推奨）

デフォルトでは、FastComments のコメントデータは公開で読み取り可能です。スレッドの URL や API エンドポイントを推測できる人は、Moodle 外部からでもコメントを閲覧できます。コースディスカッションでは、登録済みの学生だけが閲覧できるように制限するのがほとんどの場合望ましいでしょう。

ウィジェットカスタマイズページを開き、Require SSO To View Comments を有効にしたルールを作成し、セキュリティレベルを Secure SSO に設定して、スレッドが署名された LTI 起動を通じてのみ読み込まれるようにします。

完全な手順（単一サインオンでのスレッド保護方法、ドメインやページ単位でルールをスコープする方法を含む）は、Protecting Comment Threads With Single-Sign-On を参照してください。

Moodle のトラブルシューティング

アクティビティ選択に FastComments が表示されない。 サイト管理者がツールを登録したが、Tool configuration usage を Show in activity chooser and as a preconfigured tool に設定していません。これを修正するには Site administration > Plugins > Activity modules > External tool > Manage tools > FastComments タイルのギアアイコンの順に進んでください。

「Same window」に設定すると起動に失敗するか空白のフレームが表示される。 Moodle のセッションクッキーはデフォルトで SameSite=Lax を使用しており、ブラウザによっては LTI 1.3 が FastComments から戻る際に行うクロスサイト POST でこれらのクッキーが削除されます。アクティビティの Launch container を New window に設定してください。エディタに埋め込まれた FastComments では、エディタ内の起動パスが常に新しいウィンドウをポップアップするため、これはハード要件です。

iss クレームはテナント ID ではなく Moodle サイトの URL です。 FastComments は LTI の発行者として Moodle サイトの URL（wwwroot 設定値）を使用します。Moodle インスタンスを新しいドメインに移動するか wwwroot を変更すると、既存の FastComments スレッドは古い発行者に紐づいたままになり、新しい起動と一致しなくなります。必要に応じてツールを新しい URL で再登録し、FastComments 管理画面でスレッドを移行してください。

アクティビティのバックアップと復元。 コースをバックアップして別のコースに復元すると、新しいリソースリンク ID が作成されるため、復元された FastComments アクティビティは空のスレッドで開始されます。元のコースは元のスレッドを保持します。これは意図された動作でありバグではありません。

Moodle 4.5 の TinyMCE デフォルト。 Moodle 4.5 では新規インストールに対して TinyMCE がデフォルトのエディタとして搭載されています。External tool ボタンの位置はメインツールバーではなく More（...）メニューの下になります。4.1 からアップグレードした古いサイトは、管理者がデフォルトを切り替えていない限り Atto のままです。

管理者が FastComments を LTI 1.3 Advantage ツールとして登録し、機関ポリシーを承認すると、教員は標準の Blackboard 配置ポイントを通じてコースに追加できます。Ultra Course View と Original Course View で手順が異なるため、両方を以下に示します。

Ultra Course View

Ultra Course View は 2026 年時点の Blackboard Learn SaaS のデフォルトです。

1. コースを開き、Course Content ページに移動します。
2. アウトライン内でコメントスレッドを配置したい場所にホバーまたはタップし、紫の +（Add content）ボタンをクリックします。
3. Content Market を選択します。Content Market パネルには、機関で承認されたすべての LTI ツールと Building Block 配置が一覧表示されます。
4. FastComments タイルを見つけてクリックします。Blackboard は + メニューを開いた位置にコンテンツアイテムを作成します。
5. アイテムはデフォルトでアウトラインに「学生に表示」として配置されます（個人のデフォルトで Hide from students がオフになっている講師の場合）。デフォルトが Hidden の場合、アイテムは非表示で作成され、準備ができたらアイテム行の表示切替で表示に変更します。
6. アイテム名を変更するには、アウトラインのタイトルをクリックして新しいラベルを入力します。学生がアウトラインで見るタイトルは FastComments のスレッド識別子とは独立しているため、いつでも安全に名前を変更できます。

Content Market がオプションに表示されない場合、機関側でその配置が非表示になっています。同じ + メニューの LTI Tools グループにある More tools からも同じピッカーにアクセスできます。

Original Course View

Original Course View は Learn SaaS で引き続きサポートされており、セルフホストの Learn 9.1（Q4 2024 CU リリースライン）では主要な体験として残っています。

1. コースを開き、Content Area（例：コースメニューのデフォルト Information または Content エリア）に入ります。
2. 右上のトグルで Edit Mode をオンにします。
3. アクションバーで Build Content をクリックします。
4. Learning Tools サブメニューの下で FastComments をクリックします。Learning Tools サブメニューは、管理者がツールを登録した後の LTI 1.3 ツール配置から構成されます。表示されない場合は下の「注意点」セクションを参照してください。
5. Create FastComments フォームで次を設定します:
   • Name: 学生がコンテンツエリアで見るラベル。
   • Description: 埋め込まれたスレッドの上に表示される任意のテキスト。
   • Permit Users to View this Content: 可用性の Yes/No トグル。
   • Track Number of Views: Blackboard のアイテムごとの閲覧統計を取得したい場合に有効化。FastComments は独自に解析を実行します。
   • Date and Time Restrictions: 任意の Display After / Display Until ウィンドウ。
6. 送信します。ツールがコンテンツエリアにクリック可能なアイテムとして表示されます。

アイテムやドキュメント内への埋め込み

両方のコースビューで、講師はコンテンツエディタの LTI Advantage ボタンを使って、Item、Document、または任意のリッチテキストフィールド内に FastComments をインラインで埋め込みます。

Ultra Course View:

1. Document を作成または編集します。
2. スレッドを表示したいドキュメント本文内で Add content をクリックします。
3. エディタのツールバーで Insert content メニューを開き、Content Market（LTI Advantage / Deep Linking のエントリーポイント）をクリックします。
4. FastComments を選択します。FastComments は deep-link ペイロードを返し、Blackboard はドキュメント本文のカーソル位置に埋め込みブロックを挿入します。
5. ドキュメントを保存します。学生はスクロールしてその位置を通過すると、スレッドがインラインで表示されます。

Original Course View:

1. リッチテキスト本文を持つ任意のアイテムを編集します。
2. コンテンツエディタのツールバーで Add Content のプラスアイコンをクリックし、Content Market（古い Q4 2024 CU では Add Content from External Tool と表示）を選択します。
3. FastComments を選択します。エディタは deep-linked リソースを参照するプレースホルダーブロックを挿入します。
4. アイテムを送信します。

各 deep-link 埋め込みはそれぞれ独立した FastComments スレッドを生成するため、1 つのアイテムに FastComments ブロックが 2 つ埋め込まれていれば、コメントストリームは 2 つになります。

表示、公開条件、およびグループ制限

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 ランチは発生せず、モデレータビューにも表示されません。

成績表の挙動

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) を選び、必要に応じて Column Organization の下で Hide from Instructor View を選択します。

学生が見るもの

学生が FastComments アイテムを開くか、埋め込まれたブロックまでスクロールすると:

1. Blackboard は FastComments に LTI 1.3 メッセージを送信してランチします。学生は Blackboard の識別情報（名前、メール、アバター、役割）を使って SSO によりサインインし、ログインフォームを見ることはありません。
2. スレッドは iframe 内でレンダリングされます。スレッド化、返信、メンション、リアクションは、FastComments で設定されたコメントウィジェットの設定に基づいて利用可能になります。
3. 彼らのコメントは Blackboard アカウントに紐づけられます。もし学生が後で Blackboard で名前や写真を編集した場合、次回のランチで FastComments のプロフィールが更新されます。

Blackboard から FastComments への役割マッピング:

• System Administrator と Course Builder は FastComments の admin にマップされます。
• Instructor と Teaching Assistant は FastComments の moderator にマップされます。
• Student, Guest, および Observer は FastComments の commenter にマップされます。

モデレータはスレッド内のすべてのコメントに対して（ピン、非表示、バン、削除などの）モデレーションコントロールをインラインで表示します。

公開アクセスの制限（推奨）

デフォルトでは、FastComments のコメントデータは公開読み取り可能です。スレッドの URL や API エンドポイントを推測できる誰でも、そのコメントを Blackboard の外部でも閲覧できます。コースのディスカッションでは、登録された学生のみに閲覧を制限するのがほとんどの場合望ましいです。

あなたの ウィジェットカスタマイズページ を開き、Require SSO To View Comments を有効にしたルールを作成し、セキュリティレベルを Secure SSO に設定してください。これによりスレッドは署名された LTI ランチ経由でのみ読み込めるようになります。

単一ドメインまたはページにルールをスコープする方法を含む完全な手順は、Protecting Comment Threads With Single-Sign-On を参照してください。

スレッドのスコーピング

FastComments は各スレッドを (Blackboard host, course ID, resource link ID) によってスコープします。同じコース内の 2 つの FastComments アイテムは 2 つのスレッドを生成します。同じアイテムを 2 つのコースシェルにコピーした場合（たとえばコースコピーを通じて）、コピー時に Blackboard が新しい resource link ID を発行するため 2 つのスレッドが生成されます。コースコピー間で共有スレッドを維持するには、コピーを開始する前に FastComments で明示的なスレッド URN を設定した Deep Linking を使用してください。

Blackboard 固有の注意点

Build Content メニュー（Original）や Content Market（Ultra）に FastComments タイルが表示されない。 管理者はツールを承認したが、関連する配置をブロックする機関ポリシーを残しています。Administrator Panel > Integrations > LTI Tool Providers に移動して FastComments エントリを編集し、Course Content Tool（Original）および Course Content Tool - allow students / Deep Linking content tool（Ultra）配置の両方が有効になっていることを確認してください。保存してコースページをリフレッシュします。

起動時に「Tool not configured for this context」または「Tool is not deployed」エラーが出る。 動的登録時に登録されたデプロイメントスコープが、コースが属する機関コンテキストと一致していません。Blackboard のツールプロバイダエントリで Deployment ID がこのテナントの FastComments の LTI 1.3 Configuration ページに表示されているものと一致するか確認してください。もし異なる場合は、配置を削除して新しい登録 URL（ここで取得）から動的登録を再実行してください。

Iframe の高さが固定されている、またはコンテンツが切れる。 一部の Blackboard テナントはデフォルトの LTI iframe-resize postMessage をブロックする厳格な Content Security Policy を導入しています。互換性を最大化するために FastComments は Canvas スタイルの lti.frameResize メッセージと IMS 仕様形式の org.imsglobal.lti.frameResize メッセージの両方を送信しますが、テナントレベルの CSP 上書きが親リスナーをブロックしている場合があります。管理者に *.fastcomments.com が LTI ツールの許可リストに含まれていることと、カスタム CSP ヘッダが postMessage イベントを削っていないことを確認してもらってください。そうすれば追加設定なしにリサイズが動作します。

コースコピーがスレッドを複製する。 Blackboard のコースコピーは LTI 配置に対して新しい resource link ID を発行するため、コピーされたコースは空のスレッドで開始します。これは想定された動作です。コピーしたコースが元のスレッドを継承する必要がある場合は、コピー前に明示的なスレッド URN を設定した Deep Linking を設定するか、FastComments サポートに連絡してスレッド ID を一括で再マップしてください。

学生が起動時に一般的な Blackboard エラーを見る。 原因は欠落または古くなった email クレームです。FastComments の機関ポリシーで User Fields to Send の下に Role, Name, Email Address が有効になっていることを確認してください。保存後、新しいブラウザセッションで再度起動してください。

Once FastComments is registered with the platform, instructors add it to course content using the platform's standard external tool flows. This page covers Sakai 23.x and Schoology Enterprise.

Lock Down Public Access (Recommended)

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

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

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

Sakai

1. Add FastComments to a site

The site maintainer enables the tool on a per-site basis:

1. Open the site and click Site Info in the left navigation.
2. Click Manage Tools.
3. Scroll to the External Tools list and toggle FastComments on.
4. Click Continue, review the tool list, then click Finish.

FastComments now appears as a left-nav item in the site.

2. Reorder the left-nav entry

Go to Site Info > Tool Order. Drag FastComments to the desired position and click Save. You can also rename the nav label and hide it from students from this screen.

3. Embed inline in a Lessons page

To place FastComments directly inside a Lessons page rather than as a standalone left-nav tool:

1. Open the Lessons tool in the site.
2. Click Add Content > Add External Tool.
3. Select FastComments from the list.
4. If FastComments advertised Deep Linking during registration, Sakai opens the tool's content selector so you can pick or label the thread. If Deep Linking wasn't advertised, Sakai inserts a default launch link.
5. Save the Lessons item.

Each embedded instance gets its own thread, scoped to that resource link.

4. Permission tweaks for student access

Sakai gates external tool launches through Realms. To confirm students can launch FastComments:

1. Sign in as a Sakai admin and open Administration Workspace > Realms.
2. Open the relevant realm (for example, !site.template.course or the specific site realm).
3. Confirm the access role has lti.launch enabled and that the role permissions in the external.tools group are granted.
4. Save the realm.

For site-level overrides, the maintainer can adjust per-role tool visibility from Site Info > Tool Order by hiding or showing FastComments per role.

5. What students see

Students click the FastComments left-nav item (or scroll to the embedded Lessons block) and land directly in the threaded comment view. SSO is automatic: Sakai sends the user's identity in the LTI launch and FastComments signs them in under their Sakai account.

Role mapping:

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

6. Sakai gotchas

• Tool not visible in Manage Tools. If FastComments doesn't appear in the External Tools list, the Sakai admin needs to open the tool registry (Administration Workspace > External Tools > FastComments) and set Stealthed to false. Stealthed tools are hidden from the per-site Manage Tools picker.
• Launches breaking in shared-session browsers. Sakai's portal CSRF token is bound to the browser session. If a student is signed in to two Sakai sites in different tabs or has a stale session, the launch returns a 403. Fix: close other Sakai tabs, sign out, sign back in, and relaunch. Admins can also raise sakai.csrf.token.cache.ttl if this happens cluster-wide.
• Frame embedding. Confirm lti.frameheight in sakai.properties is large enough (600 or higher) so the comment thread isn't clipped inside a Lessons page.

Schoology

Schoology Enterprise has two installation scenarios. Confirm which one applies before adding the tool to a course.

1. Two installation scenarios

• (a) Enterprise-level install. The Schoology System Administrator installed FastComments at the organization level and assigned it to all courses or to specific course templates. Instructors skip installation and go straight to "Add Materials".
• (b) Instructor self-install. The instructor installs the tool into a single course from Course Options > External Tools > Install LTI Apps. Self-install requires the System Administrator to have approved the FastComments app at the org level first.

2. Add FastComments as a course material

Inside the course:

1. Open the course and go to Materials.
2. Click Add Materials > Add File/Link/External Tool.
3. Choose External Tool.
4. Select FastComments from the registered tools list.
5. Set a Name (this is what students see in the materials list) and an optional Description.
6. Leave Enable Grading (grade passback) OFF. FastComments does not report grades back to Schoology, so enabling grade passback creates an empty gradebook column.
7. Click Submit.

The material now appears in the course materials list and opens the FastComments thread when clicked.

3. Inline embedding via the Rich Text editor

If the System Administrator enabled Deep Linking placement for FastComments during registration, instructors can embed the comment thread inside any Rich Text field (assignment instructions, page bodies, discussion prompts):

1. Open the Rich Text editor on the target page.
2. Click the External Tool (puzzle piece) icon in the toolbar.
3. Choose FastComments.
4. Configure the embed in the deep-linking dialog and click Insert.
5. Save the page.

If the External Tool button doesn't appear in the Rich Text editor, Deep Linking is disabled for this tool on this tenant. See the gotchas below.

4. Visibility and section assignments

Schoology scopes tool availability per section through Course Options:

1. From the course, click Course Options > External Tools.
2. For each installed LTI app, you control whether it's available to all sections in the course or to specific sections.
3. To restrict FastComments to certain sections, uncheck the sections that should not see the tool.
4. Section-level access also gates which sections see the Add Materials > External Tool entry for FastComments.

5. What students see

Students click the FastComments material (or scroll to the inline embed) and land in the threaded discussion. SSO is automatic via the Schoology LTI launch under their Schoology account.

Role mapping:

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

6. Schoology gotchas

• Enterprise-only. Personal and free Schoology accounts cannot install LTI 1.3 tools. If your tenant is on the free tier, the External Tools option is absent from Course Options. Upgrade to Schoology Enterprise to use FastComments.
• Deep Linking disabled by tenant default. Some Schoology tenants restrict Deep Linking placement at the org level. When this is the case, instructors see only the Add Materials > External Tool flow and not the External Tool button in the Rich Text editor. To enable inline embedding, the System Administrator goes to System Settings > Integration > LTI 1.3 > FastComments and enables the Content Item / Deep Linking placement, then saves.
• Per-section assignment override. If FastComments is assigned at the enterprise level but the instructor cannot see it in Add Materials, the course's section is excluded in the org-level assignment. Ask the System Administrator to add the section to the FastComments app assignment.
• Material name vs. thread identity. Renaming the material in Schoology does not move the comment thread. Threads are keyed on the LTI resource link ID, so a rename keeps the same thread; deleting and recreating the material creates a new, empty thread.

"登録トークンが見つからない、期限切れ、または既に使用されています"

あなたの登録用URL（ここで取得できます）内のトークンは30分間有効で、1回しか使用できません。LMS の処理にそれ以上時間がかかった場合、または登録が成功した後に再試行された場合、トークンは拒否されます。FastComments の LTI 1.3 設定ページで新しい URL を生成して最初からやり直してください。

"プラットフォームが登録を拒否しました"

あなたの LMS が登録ハンドシェイクを拒否しました。最も一般的な原因:

• 同じクライアント名ですでにツールが登録されています。 一部のプラットフォーム（特に D2L）は、前のものが削除されるまで「FastComments」の2回目の登録を拒否します。LMS で古いツールを削除してから再試行してください。
• LMS の誤ったフィールドに入力しています。 URL を registration / tool initiation registration endpoint フィールドに貼り付けたことを確認してください。launch URL や login URL のフィールドではありません。
• LMS が実際には Dynamic Registration をサポートしていません。 古い Moodle や Blackboard のバージョンは LTI 1.3 を謳っていますが、手動設定のみを許可します。プラットフォームのドキュメントを確認してください。

"プラットフォーム構成の取得に失敗しました"

FastComments があなたの LMS の openid-configuration ドキュメントを読み取れませんでした。これは稀で、通常は LMS が不正なまたは到達不能な discovery URL を提供したことを意味します。LMS サポートに連絡してください。

起動時に "設定が見つかりません" と表示される

FastComments の設定が削除されたか、起動が当社で認識していない iss/client_id の組み合わせから行われました。設定を削除して再登録した場合は、LMS に FastComments ツールを削除して再追加するよう指示し、新しい client_id を取得するようにしてください。

起動時に "デプロイメントが登録されていません" と表示される

最初に起動したものとは異なる Brightspace/Moodle/Blackboard のデプロイメントから FastComments を起動しました。FastComments はセキュリティチェックとして初回起動時に deployment_id を固定します。同じクライアントの下で新しいデプロイメントを追加するにはサポートに連絡してください — 我々が設定に deployment ID を追加します。

起動時に "message_type がサポートされていません" と表示される

LMS が FastComments が処理しない LTI メッセージを送信しました（例: LtiSubmissionReviewRequest）。FastComments は標準の resource-link launch と deep-linking flows のみをサポートします。特定の message type を追加してほしい場合はお問い合わせください。

iframe がリサイズされない

ほとんどの LMS は LTI iframe を自動でサイズ調整します。あなたの LMS がそうでない場合は、LMS の起動設定がツールから親フレームへの postMessage イベント送信を許可しているか確認してください。FastComments は Canvas スタイル（lti.frameResize）と IMS 仕様（org.imsglobal.lti.frameResize）の両方のリサイズメッセージを送出します。

FastComments の LTI 1.3 統合は最小特権の原則に従います: ユーザーを識別し、コメントを正しいコースとリソースに紐づけ、ロールベースの権限を適用するために必要なランチクレームのみを使用します。

このページの残りの部分では、統合が消費するすべてのクレーム、要求しないすべての LTI Advantage サービス、および収集しないすべてのデータカテゴリをマッピングしています。セキュリティおよび調達のレビュアーは、下の表から直接回答を抜き出すことができます。

LMS から受け取るデータ要素

すべての LTI 1.3 ランチは LMS からの署名付き JWT を伴います。FastComments はその JWT から以下のクレームを抽出し、それ以外は使用しません:

登録時に宣言されるクレームとスコープ

LTI 1.3 のダイナミック登録中に、FastComments は scope: ""（追加の OAuth スコープなし）で自身を登録し、次の OpenID Connect クレームのみを宣言します:

iss, sub, name, email, picture

次の 2 つのメッセージタイプを登録します:

• LtiResourceLinkRequest - FastComments への標準的なコースランチ。
• LtiDeepLinkingRequest - インストラクターがコース内に FastComments ツールを配置できるようにするもの。

LMS から追加のアクセストークンは要求しません。

要求しない LTI Advantage サービス

収集しないデータ

LTI 自体を超えて、FastComments は LMS またはユーザーから次のものを要求または受信しません:

アクセスの境界

• FastComments が受け取るデータは、LMS の登録鍵で署名された許可された LTI 1.3 ランチ内のデータのみです。統合は追加情報のために LMS にコールバックしません。
• ランチトークンは一度きりで短期間有効です。再生されたトークンや有効期限切れのトークンは拒否されます。
• LMS 管理者はツールがプラットフォーム内のどこに配置されるかを制御します。例えば D2L Brightspace はデプロイごとの org-unit スコーピングとデプロイごとのセキュリティ設定をサポートしており、管理者はツールをグローバルに利用可能にするのではなく、特定のコースや組織単位に限定できます。Moodle、Blackboard、Sakai、および Schoology もそれぞれの LTI 1.3 実装で同等のデプロイごとの制御を提供します。

保存と保持

FastComments はアクティブなコメントサービスの期間中および顧客が設定した保持設定に従って LTI 派生データを保持します。コメントデータは保存時に暗号化された本番ストレージに保存されます。アカウント終了または書面による削除要求があった場合、FastComments は適用される契約に従って顧客データを削除または匿名化します。

完全な保存およびデータ取り扱いの詳細については、FastComments プライバシーポリシー を参照してください。

レビューの頻度

追加のクレーム、スコープ、または LTI Advantage サービスを必要とする新しい LTI 機能は、要求されたアクセスが提供される機能に対して必要かつ比例的であることを確認するためにリリース前にレビューされます。

セキュリティ質問票向けの短い声明

FastComments は LTI 1.3 統合において最小特権とデータ最小化を適用します。統合はユーザーを認証するために必要な LTI ランチクレーム（sub, name, email, picture）、ユーザーの役割を判断するための情報、そしてコメントが属するコースとリソースを特定するための情報のみを使用します。FastComments は Names and Role Provisioning Services、Assignment and Grade Services、成績データ、出席情報、フルロスター、または LMS 管理者アクセスを要求しません。LMS 管理者はツールが利用可能な組織単位、コース、およびデプロイを引き続き制御します。