Đưa Học liệu AI vào LMS của trường

LTI 1.3 giúp giáo viên chọn học liệu ngay trong khoá học, học sinh làm bài và điểm tự về sổ điểm.

LTI 1.3

Bắt đầu nhanh (3 bước)

1Đăng nhập hoclieu.org → Hồ sơ → Kết nối LMS.
2Sao chép “đường dẫn tự đăng ký” và dán vào LMS: CatBus/Canvas → Developer Keys → + Developer Key → LTI Registration; Moodle → Manage tools → Tool URL. LMS không có đăng ký tự động thì thêm kết nối thủ công.
3Thử thêm một học liệu vào khoá học.

Ghi chú

Cần đăng nhập để có đường dẫn riêng gắn với tài khoản; không cần khoá bí mật nào.

Hướng dẫn theo LMS

CatBus / Canvas tự cài

Cách A — tự động (khuyên dùng)

1Trên hoclieu.org: Hồ sơ → Kết nối LMS → bấm Sao chép đường dẫn tự đăng ký.
2Trên CatBus: Admin → Developer Keys → + Developer Key → chọn LTI Registration (KHÔNG chọn “LTI Key”).
3Dán đường dẫn vào ô Registration URL → Continue. Cửa sổ hoclieu.org hiện ra và tự đăng ký, báo “Đã đăng ký Học liệu AI với LMS của bạn”.
4Xem lại quyền (scopes) → Install / Enable. Trong danh sách Developer Keys, bật khoá mới sang ON nếu chưa bật.
5Kiểm tra: Hồ sơ → Kết nối LMS trên hoclieu.org có thêm một dòng kết nối mới. Không phải nhập Client ID hay Deployment ID.

Không thấy mục “LTI Registration”?

Bản CatBus/Canvas đó chưa hỗ trợ đăng ký tự động — dùng Cách B. Đừng dán đường dẫn tự đăng ký vào mục “LTI Key”: khoá vẫn được tạo nhưng hoclieu.org không được báo, khi mở bài sẽ gặp lỗi unknown_platform.

Cách B — thủ công (khi LMS không có “LTI Registration”)

1Admin → Developer Keys → + Developer Key → LTI Key.
2Method “Enter URL” → dán https://hoclieu.org/lti/config.json → Lưu → bật ON.
3Copy số Client ID (cột Details).
4Admin → Settings → Apps → + App → Configuration Type “By Client ID” → dán → Install.
5Lấy Deployment ID: Apps → bánh răng cạnh “Học liệu AI” → Deployment Id.
6BẮT BUỘC: hoclieu.org → Hồ sơ → Kết nối LMS → Thêm kết nối thủ công → chọn CatBus/Canvas tự cài, nhập địa chỉ LMS, Client ID, Deployment ID. Thiếu bước này LMS sẽ báo unknown_platform vì theo chuẩn LTI, cách thủ công không gửi Client ID về cho công cụ.

Canvas (Instructure cloud)

Giống CatBus / Canvas tự cài: ưu tiên Cách A (Developer Keys → + Developer Key → LTI Registration → dán đường dẫn tự đăng ký). Nếu dùng Cách B (LTI Key), nhớ thêm kết nối thủ công ở Hồ sơ, chọn loại “Canvas (Instructure cloud)”.

Moodle 4.x

1Quản trị trang → Plugins → Hoạt động → External tool → Manage tools.
2Dán đường dẫn tự đăng ký vào “Tool URL”.
3“Add LTI Advantage” → Activate.
4(Tuỳ chọn) bật “Supports Deep Linking”.

Nếu cần thủ công: Configure a tool manually với các URL ở mục 4.

Cách dùng sau khi cài

1Giáo viên thêm hoạt động/bài tập.
2Chọn “Học liệu AI”.
3Chọn học liệu.
4Học sinh làm bài, điểm về sổ điểm (quiz/H5P).

Thông số công cụ

Base: https://hoclieu.org

Thông số	URL đầy đủ	Mô tả
Login	`https://hoclieu.org/lti/login`	Nền tảng gọi khi mở tool.
Launch / Redirect	`https://hoclieu.org/lti/launch`	Nhận id_token, xác minh, mở học liệu.
JWKS	`https://hoclieu.org/lti/jwks`	Khoá công khai RSA để LMS xác minh JWT.
Cấu hình JSON	`https://hoclieu.org/lti/config.json`	Dán vào LMS để tự nhận thông số.
Đường dẫn tự đăng ký	`lấy trong Hồ sơ → Kết nối LMS`	Đường dẫn riêng gắn với tài khoản của bạn.

Lỗi thường gặp

Mở học liệu báo lỗi / trang trắng

Kiểm tra đã thêm kết nối trong Hồ sơ, Client ID và Deployment ID đúng. Xem “lần mở gần nhất” trong Hồ sơ để biết lỗi.

“Không tìm thấy nền tảng”

Issuer hoặc Client ID chưa khớp. Canvas tự cài thường dùng issuer https://canvas.instructure.com.

Điểm không về sổ điểm

Developer Key / tool phải bật dịch vụ điểm (AGS: lineitem + score). Chỉ quiz/H5P có chấm điểm.

Mở link đăng ký thấy trang hướng dẫn

Đúng, link dùng để dán vào LMS, không phải để mở bằng trình duyệt.

Cần hỗ trợ

Nhấn nút trợ giúp ở góc phải màn hình để liên hệ đội hỗ trợ.