Integracja z USOS
USOS Credentium Connector
Automatyczne wystawianie cyfrowych poświadczeń akademickich na podstawie wyników z systemu USOS — bez ręcznej pracy po stronie uczelni.
Jak to działa?
Trzy kroki od konfiguracji do automatycznego wystawiania poświadczeń.
Uczelnia definiuje reguły
Administrator konfiguruje reguły mapujące przedmioty USOS na szablony poświadczeń Credentium. Reguły mogą uwzględniać:
- Zaliczenie przedmiotu — poświadczenie po uzyskaniu zaliczenia
- Minimalna ocena — np. poświadczenie tylko dla oceny 4.0+
- Kierunek studiów — ograniczenie do konkretnego programu
- Termin egzaminu — ograniczenie do konkretnej sesji
Connector synchronizuje oceny
Co 15 minut (konfigurowalne) Connector odpytuje API systemu USOS o najnowsze oceny. Dla każdego studenta spełniającego warunki reguły tworzone jest zlecenie wystawienia poświadczenia.
Credentium wystawia i doręcza
Connector wysyła do API Credentium minimalne dane: identyfikator szablonu, imię i nazwisko studenta, adres e-mail oraz ocenę (jeśli wymaga szablon). Credentium wystawia poświadczenie i automatycznie doręcza je studentowi.
Architektura: prywatność danych na pierwszym miejscu
Connector działa w infrastrukturze uczelni. Credentium nigdy nie ma dostępu do systemu USOS.
Rozdzielenie odpowiedzialności
Kluczowe funkcje
Panel administracyjny
Webowy panel z trzema rolami: administrator (pełna konfiguracja), operator (reguły, kolejka) i audytor (dostęp tylko do odczytu).
Kolejka z obsługą błędów
Każde zlecenie przetwarzane niezależnie. Błędy tymczasowe — automatyczne ponowienie. Trwałe — oznaczone do ręcznej interwencji.
Idempotentność
Każde poświadczenie wystawiane dokładnie raz. Klucz: reguła + student + przedmiot + termin. Bez duplikatów nawet przy wielokrotnej synchronizacji.
System alertów
Powiadomienia e-mail o problemach: błędy połączenia, nieudane wystawienia, wygasłe tokeny. Konfigurowalne progi i wyciszanie.
Pełny ślad audytowy
Rejestracja każdej operacji: logowania, zmiany reguł, wystawienia, błędy. Logi przechowywane w bazie Connectora, w infrastrukturze uczelni.
Bezpieczeństwo
Szyfrowanie sekretów (Fernet), hashowanie haseł (Argon2), ochrona CSRF, kontrola dostępu, sesje z limitem czasu, komunikacja wyłącznie po TLS.
Wymagania techniczne
Connector jest gotowy do pracy w ciągu kilku minut po wdrożeniu.
Infrastruktura uczelni
- Docker i Docker Compose
- PostgreSQL 16 (dostarczany w zestawie kontenerów)
- Dostęp sieciowy do API USOS (w sieci uczelni)
- Dostęp do API Credentium (HTTPS, port 443)
Konta i klucze
- Konto API Credentium z kluczem dostępu
- Konto API USOS z tokenami OAuth
Zainteresowany integracją z USOS?
USOS Credentium Connector jest darmowy dla klientów platformy Credentium. Skontaktuj się z nami, aby omówić wdrożenie na Twojej uczelni.
Informacja prawna
USOS (Uniwersytecki System Obsługi Studiów) jest projektem prowadzonym przez Międzyuniwersyteckie Centrum Informatyzacji (MUCI) — stowarzyszenie uczelni powołane do życia na Konferencji Rektorów Uniwersytetów Polskich. USOS stanowi zintegrowany system do obsługi spraw studiów, który powstał dzięki współpracy polskich uczelni i którego rozwój jest finansowany ze składek uczelni członkowskich.
Credentium oraz Cloud Team nie są w żaden sposób powiązane, afiliowane ani wspierane przez USOS, MUCI ani żadną uczelnię wchodzącą w skład stowarzyszenia. Użycie nazwy USOS na tej stronie ma charakter wyłącznie informacyjny i służy opisaniu kompatybilności technicznej oprogramowania USOS Credentium Connector.
USOS Credentium Connector jest niezależnym oprogramowaniem opracowanym przez Cloud Team, korzystającym z publicznie dostępnego API systemu USOS. Żadna część tego oprogramowania nie jest autoryzowana, certyfikowana ani w inny sposób zatwierdzona przez twórców systemu USOS.
USOS Credentium Connector jest udostępniany bezpłatnie klientom posiadającym aktywną subskrypcję platformy Credentium. Więcej informacji o systemie USOS: www.usos.edu.pl.