Konfiguracja wtyczki Integracja Credentium® dla Moodle

Ten przewodnik wyjaśnia wszystkie opcje konfiguracji wtyczki Integracja Credentium® na poziomie globalnym, kategorii i kursu.

Hierarchia konfiguracji

Wtyczka używa hierarchicznego systemu konfiguracji:

Ustawienia globalne (dla całej witryny)
    ↓
Ustawienia kategorii (opcjonalne, dla multi-tenant)
    ↓
Ustawienia kursu (per kurs)

Kursy mogą dziedziczyć dane API z kategorii nadrzędnej lub używać ustawień globalnych.

Ustawienia globalne

Lokalizacja: Administracja witryny > Wtyczki > Wtyczki lokalne > Integracja Credentium®

Włącz integrację Credentium

Gdy wyłączone:

• Żadne poświadczenia nie będą wystawiane
• Zdarzenia ukończenia kursu są ignorowane
• Istniejące konfiguracje są zachowane

Konfiguracja API

Format klucza API: Klucz składa się z dwóch części oddzielonych kropką:

• Publiczny identyfikator (przed kropką)
• Sekret (po kropce)

Bezpieczeństwo: Klucze API są przechowywane bezpiecznie i wyświetlane jako pola hasła.

Testuj połączenie

Kliknij Testuj połączenie, aby zweryfikować dane API:

• Otwiera nowe okno z wynikami testu
• Pokazuje liczbę dostępnych szablonów
• Wyświetla nazwy i ID szablonów
• Raportuje błędy połączenia

Tryb kategorii

Włącz dla:

• Wdrożeń multi-tenant (różne organizacje per kategoria)
• Działów z oddzielnymi kontami Credentium
• Konfiguracji testowych vs produkcyjnych

Po włączeniu trybu kategorii:

• Administratorzy kategorii mogą konfigurować dane API na poziomie kategorii
• Kursy mogą wybrać dziedziczenie danych z kategorii nadrzędnej
• Każda kategoria może łączyć się z inną organizacją Credentium

Logowanie debugowania

Włącz tymczasowo do rozwiązywania problemów. Logi zawierają:

• Szczegóły przetwarzania zdarzeń
• Informacje o żądaniach/odpowiedziach API
• Dane obliczeń ocen
• Szczegóły błędów

Uwaga: Wyłącz w produkcji, aby zmniejszyć objętość logów.

Okres przechowywania danych (Zgodność z RODO)

To ustawienie zapewnia zgodność z RODO poprzez wdrażanie zasad minimalizacji danych:

• Rekordy starsze niż skonfigurowany okres są trwale usuwane
• Zaplanowane zadanie działa codziennie o 2:00 w nocy (czas serwera), aby czyścić stare rekordy
• Usuwanie dotyczy wszystkich rekordów wydanych certyfikatów niezależnie od statusu (wydane, nieudane lub oczekujące)
• Dostępne jednostki: dni, tygodnie

Pełne szczegóły dotyczące prywatności, obsługi danych i zgodności z RODO znajdziesz w dedykowanym artykule Prywatność i zgodność z RODO.

Ustawienia kategorii

Lokalizacja: Kategoria > Ustawienia Credentium kategorii Wymaga: Tryb kategorii włączony globalnie Uprawnienie: local/credentium:managecategory

Włącz dla kategorii

Gdy włączone, kursy w tej kategorii (i podkategoriach) mogą używać tych danych API.

Dane API

Bezpieczeństwo: Klucze API kategorii są szyfrowane w spoczynku przy użyciu API szyfrowania Moodle.

Kontrole operacyjne

Wstrzymaj wystawianie:

• Oczekujące poświadczenia pozostają w kolejce
• Nowe ukończenia są kolejkowane, ale nie przetwarzane
• Przydatne podczas konserwacji lub dochodzenia

Limit częstotliwości:

• Zapobiega przeciążeniu API
• Nadmiarowe poświadczenia są kolejkowane do późniejszego przetworzenia
• Sprawdzany per kategoria

Dziedziczenie kategorii

Kategorie tworzą hierarchię. Podczas rozwiązywania konfiguracji:

1. Sprawdź, czy kurs ma inherit_category = 1
2. Przejdź w górę drzewa kategorii, aby znaleźć pierwszą włączoną konfigurację
3. Jeśli nie znaleziono, użyj ustawień globalnych

Przykład:

Wydział Inżynierii (włączony, ma konfigurację API)
└── Katedra Informatyki (nie skonfigurowana)
    └── Kurs Python (inherit_category = 1)
        → Używa danych API Wydziału Inżynierii

Ustawienia kursu

Lokalizacja: Kurs > Więcej > Ustawienia Credentium Uprawnienie: local/credentium:managecourse

Krok po kroku: Włącz Credentium dla kursu

Wykonaj poniższe kroki, aby włączyć automatyczne wystawianie poświadczeń dla konkretnego kursu:

Krok 1: Przejdź do ustawień kursu

1. Przejdź do swojego kursu w Moodle
2. Kliknij menu Więcej w nawigacji kursu
3. Wybierz Ustawienia Credentium

Krok 2: Włącz integrację

1. Zaznacz Włącz Credentium dla tego kursu
2. To aktywuje automatyczne wystawianie poświadczeń po ukończeniu kursu przez studentów

Krok 3: Wybierz szablon certyfikatu

1. Z listy rozwijanej Szablon certyfikatu wybierz szablon do użycia
2. Jeśli nie widzisz żadnych szablonów, kliknij Odśwież szablony, aby załadować je z Credentium
3. WAŻNE: Wybieraj tylko szablony oznaczone jako obsługiwane. Szablony z etykietą "(nieobsługiwane)" nie mogą być używane, ponieważ mają wiele oświadczeń Oceny Edukacyjnej (Learning Assessment)

Krok 4: Skonfiguruj wysyłanie oceny (opcjonalne)

1. Zaznacz Wyślij ocenę z certyfikatem, jeśli chcesz dołączyć końcową ocenę kursu studenta
2. Ocena zostanie wysłana do Credentium i dołączona do certyfikatu

Krok 5: Zapisz zmiany

1. Kliknij Zapisz zmiany, aby aktywować konfigurację
2. Od teraz studenci kończący ten kurs automatycznie otrzymają swoje poświadczenie

Dokumentacja ustawień kursu

Gdy włączone, studenci otrzymują poświadczenia automatycznie po ukończeniu kursu.

Szablon certyfikatu

Ważne uwagi:

• Szablony są ładowane z API Credentium
• Wyświetlane są tylko aktywne szablony
• Szablony z wieloma Ocenami Edukacyjnymi są oznaczone "(nieobsługiwane)" i nie mogą być wybrane - ponieważ Moodle wysyła jedną ocenę kursu, która może być zmapowana tylko na jedno oświadczenie Oceny Edukacyjnej
• Kliknij Odśwież szablony, aby zaktualizować listę

Dziedziczenie kategorii

Pokazywane tylko gdy tryb kategorii jest włączony. Gdy zaznaczone:

• Dane API są rozwiązywane z hierarchii kategorii
• Pokazuje, która konfiguracja kategorii będzie używana

Opcje ocen

Gdy włączone:

• Końcowa ocena studenta jest wysyłana do Credentium
• Ocena jest pobierana po ukończeniu kursu
• Wtyczka czeka na agregację ocen, jeśli potrzeba

Obsługa ocen:

• Wysyłana jako surowe punkty (nie procent)
• Credentium konwertuje do odpowiedniego formatu na podstawie szablonu
• Wysyłana tylko jeśli student ma końcową ocenę

Przewodnik wyboru szablonu

Jakie szablony są dostępne?

Szablony pochodzą z Twojej organizacji Credentium:

• Utworzone w Credentium Issuer
• Muszą mieć status "Aktywny"
• Buforowane przez 1 godzinę (kliknij Odśwież, aby zaktualizować)

Wymagania szablonu

Dla integracji z Moodle, szablony powinny:

• Mieć co najwyżej jedną Ocenę Edukacyjną (do mapowania ocen)
• Być oznaczone jako Aktywne w Credentium
• Mieć wszystkie wymagane pola skonfigurowane

Szablony z wieloma ocenami

Szablony z wieloma Ocenami Edukacyjnymi są oznaczone "(nieobsługiwane)", ponieważ:

• Moodle wysyła jedną ocenę kursu
• Nie można mapować na wiele oświadczeń ocen
• Użyj szablonów z jedną oceną dla kursów Moodle

Przykłady konfiguracji

Przykład 1: Prosta konfiguracja (jedna organizacja)

Ustawienia globalne:

• Włącz integrację Credentium: Tak
• URL API: https://issuer.credentium.com/api
• Klucz API: cred_abc123.xyz789
• Włącz tryb kategorii: Nie

Ustawienia kursu:

• Włącz Credentium dla tego kursu: Tak
• Szablon: "Certyfikat ukończenia kursu"
• Wyślij ocenę: Tak

Przykład 2: Konfiguracja multi-tenant (wiele działów)

Ustawienia globalne:

• Włącz integrację Credentium: Tak
• Włącz tryb kategorii: Tak

Kategoria: Szkoła Biznesu:

• Włącz Credentium dla tej kategorii: Tak
• URL API: https://issuer.credentium.com/api
• Klucz API: cred_business.key123

Kategoria: Inżynieria:

• Włącz Credentium dla tej kategorii: Tak
• URL API: https://issuer.credentium.com/api
• Klucz API: cred_engineering.key456

Kurs w Szkole Biznesu:

• Włącz Credentium dla tego kursu: Tak
• Użyj poświadczeń API kategorii: Tak
• Szablon: "Certyfikat MBA"

Przykład 3: Konfiguracja testowa

Kategoria: Kursy testowe:

• Włącz Credentium dla tej kategorii: Tak
• URL API: https://issuer.credentium.com/api
• Klucz API: (użyj oddzielnego testowego klucza API)
• Limit częstotliwości: 10 (limit do testów)

Kategorie produkcyjne:

• Użyj produkcyjnych danych API
• Bez limitu częstotliwości

Najlepsze praktyki

Zarządzanie kluczami API

• Używaj oddzielnych kluczy API do różnych celów
• Rotuj klucze okresowo
• Nie udostępniaj kluczy między środowiskami

Organizacja szablonów

• Twórz dedykowane szablony dla kursów Moodle
• Używaj opisowych nazw szablonów
• Utrzymuj szablony proste (jedna ocena per szablon)

Testowanie

• Najpierw przetestuj z jednym kursem
• Zweryfikuj, że poświadczenia pojawiają się w Credentium
• Sprawdź, czy wartości ocen są prawidłowe
• Dokładnie przetestuj kryteria ukończenia

Monitorowanie

• Włącz logowanie debugowania podczas początkowej konfiguracji
• Regularnie sprawdzaj raporty wystawień
• Monitoruj nieudane wystawienia
• Niezwłocznie przeglądaj komunikaty o błędach

Często zadawane pytania

Dlaczego nie widzę żadnych szablonów?

1. Sprawdź, czy dane API są prawidłowe
2. Kliknij "Testuj połączenie", aby zweryfikować
3. Upewnij się, że szablony są Aktywne w Credentium
4. Kliknij "Odśwież szablony", aby zaktualizować bufor

Czy mogę używać różnych szablonów dla tego samego kursu?

Nie, każdy kurs jest skonfigurowany z jednym szablonem. Aby oferować wiele poświadczeń:

• Utwórz oddzielne kursy
• Lub użyj ręcznego wystawiania w Credentium dla dodatkowych poświadczeń

Co się dzieje, gdy zmienię szablon?

• Przyszłe ukończenia używają nowego szablonu
• Już wystawione poświadczenia nie są dotknięte
• Oczekujące wystawienia używają szablonu z momentu ukończenia

Jak przetestować bez wystawiania prawdziwych poświadczeń?

Opcje:

• Użyj testowego środowiska Credentium z oddzielnymi danymi API
• Utwórz kategorię testową z limitowaniem częstotliwości
• Użyj testowego konta studenta

Potrzebujesz pomocy?

Jeśli masz pytania dotyczące konfiguracji, skontaktuj się z:

Wsparcie Credentium Email: support@credentium.com

Ostatnia aktualizacja: Styczeń 2026