Erudis dla zespołów technicznych — API organizacji, webhooki, SSO i LTI 1.3

Klucz API w Erudis tworzy koordynator przyciskiem „Utwórz klucz API”: nadaje mu opisową nazwę i opcjonalną datę wygaśnięcia, a w zakładce „Ograniczenia” zawęża jego uprawnienia i adresy, z których wolno go używać. Klucz jest tożsamością integracji, nie człowieka — odwołanie klucza nie odbiera nikomu dostępu do aplikacji.

• 45 zakresów uprawnień

  Uprawnienia klucza wybiera się z 45 zakresów, więc integracja czytająca raporty nie musi mieć prawa zakładania kont. Zasada najmniejszych uprawnień jest tu wykonalna, a nie tylko deklarowana.

• Lista dozwolonych adresów

  Klucz można ograniczyć do zakresów adresów IP w wersji IPv4 i IPv6. Żądanie spoza listy nie zostanie obsłużone, nawet jeśli klucz wyciekł poza Twoją sieć.

• Wygasanie i audyt użycia

  Data wygaśnięcia jest opcjonalna, ale zalecana przy integracjach projektowych. Użycie klucza jest rejestrowane, więc widać, która integracja z niego korzysta i kiedy przestała.

Erudis wysyła dokładnie dwa zdarzenia webhook: „course.completed”, gdy uczestnik ukończy wszystkie opublikowane części kursu — w interfejsie nosi ono nazwę „Kurs ukończony” — oraz „assessment.completed” po zakończonym sprawdzianie. To nie jest katalog kilkudziesięciu zdarzeń i nie udajemy, że jest: dwa zdarzenia pokrywają najczęstszy przypadek, czyli zapis ukończenia w systemie kadrowym lub dziekanatowym.

• Podpis HMAC-SHA256 i ochrona przed powtórzeniem

  Każda dostawa jest podpisana sekretem webhooka algorytmem HMAC-SHA256, a odbiorca może odrzucić żądanie powtórzone przez osobę trzecią. Sekret podajesz przy tworzeniu punktu końcowego.

• Ponowienia z narastającym odstępem

  Nieudana dostawa jest ponawiana z rosnącym odstępem, do ustawionej maksymalnej liczby prób. Log dostaw pokazuje każdą próbę wraz z odpowiedzią Twojego punktu końcowego.

• Endpoint testowy i włącznik per kurs

  Punkt końcowy da się sprawdzić testową dostawą przed uruchomieniem. Uwaga na drugi przełącznik: kurs wysyła zdarzenia dopiero po włączeniu opcji „Wysyłaj webhooki dla tego kursu” w jego ustawieniach.

Erudis występuje po stronie narzędzia LTI 1.3, więc wpina się w Twój istniejący system nauczania — na przykład w Moodle — zamiast go zastępować. Najkrótsza droga to „Generuj URL rejestracji” i wklejenie adresu w panelu LMS-a; platformy bez rejestracji dynamicznej podłączysz ręcznie, kopiując komplet danych narzędzia: adres inicjujący logowanie, adres przekierowania i adres zestawu kluczy publicznych.

• Deep Linking

  Prowadzący wybiera konkretny kurs lub lekcję Erudis wprost z panelu swojego LMS-a. Wybór treści działa w ramce systemu nauczania.

• Zwrot ocen (AGS)

  Wyniki uzyskane w Erudis wracają do dziennika ocen systemu nauczania, więc prowadzący nie prowadzi dwóch list ocen równolegle.

• Synchronizacja listy uczestników (NRPS)

  Skład grupy pobierany jest z systemu nauczania, dzięki czemu uczestnicy nie muszą być zapisywani do kursu Erudis osobno.

• Uczciwe zastrzeżenie o ramce

  Pełne uruchomienie treści w ramce LMS-a kończy się przyciskiem „Continue in a new tab” — kurs otwiera się w nowej karcie. Nie obiecujemy pełnego osadzenia w ramce.

Poza API Erudis wymienia dane w kilku formatach plikowych i przez integracje dostawców. Import kursu z Moodle czyta plik .mbz, kopia zapasowa kursu Erudis ma rozszerzenie .ecb, terminy trafiają do kalendarza przez subskrypcję ICS, a egzaminy zewnętrzne i mikropoświadczenia obsługują odrębne systemy CloudTeam i partnerów. Każdą z tych integracji włącza koordynator organizacji.

• Import .mbz z Moodle PRO

  Import przenosi treści kursu. Nie przenosi kont ani ocen, a pytania quizów trafiają jako tekst do bazy wiedzy, nie jako natywne sprawdziany — mówimy o tym wprost przy planowaniu migracji.

• Kopia zapasowa .ecb

  Kopia kursu Erudis jest podpisana i przenośna między organizacjami tej samej platformy, a z konstrukcji nie zawiera danych studentów. To format wewnętrzny Erudis, nie standard branżowy.

• Eksport kalendarza ICS

  Terminy zaliczeń i sprawdzianów student subskrybuje w swoim kalendarzu przez adres ICS, więc nie trzeba przepisywać dat do systemu kalendarzowego organizacji.

• Examena i Credentium

  Egzaminy z proktoringiem prowadzi zewnętrzna Examena, a mikropoświadczenia wystawia Credentium. Integrację włącza się danymi API dostawcy; łączność sprawdza przycisk „Testuj połączenie”.