Authentifizierung und Konfiguration

Im BKT-Manager gibt es eine Option, die es ermöglicht, die Authentifizierung zu deaktivieren. Die Authentifizierung erfolgt standardmäßig über das Schulportal von kompetenztest.de (KT-Schulportal), sodass keine separate Anmeldung im BKT-Manager erforderlich ist. Diese Funktionalität funktioniert jedoch nur innerhalb des KT-Schulportals. Wird die Authentifizierung deaktiviert, entfällt die Anmeldung komplett, und der BKT-Manager kann auch in anderen Portalen angesehen und getestet werden.

1. Authentifizierung aktivieren oder deaktivieren

Die Authentifizierung kann über die Konfiguration im .env-File gesteuert werden. Die relevanten Umgebungsvariablen sind:

• DUMMY_AUTH_SERVICE: Aktiviert oder deaktiviert die Authentifizierung über das KT-Schulportal.
• DUMMY_SCHOOL_ID: Optional. Schul-ID, die bei deaktivierter Authentifizierung verwendet wird. Ist die Variable nicht gesetzt, wird die Schul-ID 1345 verwendet.

Beispiel für .env-Einträge:

DUMMY_AUTH_SERVICE=true
DUMMY_SCHOOL_ID=1234

Wenn DUMMY_AUTH_SERVICE auf false gesetzt ist, erfolgt die Anmeldung über das Schulportal von Kompetenztest. Wenn DUMMY_AUTH_SERVICE auf true gesetzt ist, entfällt die Anmeldung, und der BKT-Manager kann ohne Authentifizierung genutzt werden. Dabei wird jeder übergebene API-Token akzeptiert und alle Anfragen werden der Schule mit der in DUMMY_SCHOOL_ID angegebenen ID zugeordnet. Diese Option ist nur für Entwicklungs- und Demozwecke gedacht und darf im Produktionsbetrieb nicht verwendet werden.

2. Anpassungen für Schulportale

Wenn Schulportale den BKT-Manager in ihr System integrieren möchten und dabei die Authentifizierung aktivieren wollen, sind Anpassungen am Code erforderlich, um die Integration mit den spezifischen Anforderungen des jeweiligen Schulportals zu ermöglichen. Der BKT-Manager verwendet derzeit eine Logik, bei der der AuthKey vom KT-Schulportal übergeben wird. Dieser AuthKey wird dann durch eine Schnittstelle von KT überprüft, um sicherzustellen, dass der Authentifizierungsstatus aktuell ist.

Um den BKT-Manager in ein anderes Schulportal zu integrieren, sind folgende Änderungen erforderlich:

• Der AuthKey des Schulportals muss beim Einbinden der Webkomponente übergeben werden, z. B. als Attribut der Komponente oder Cookie.
• Das Backend muss so angepasst werden, dass es den AuthKey auslesen und validieren kann, z.B. durch eine Schnittstelle oder Validierungslogik des Schulportals