Die Zugangsdaten für die Webservices von BAMF InGe-Online müssen je Benutzer erfasst werden. Die Benutzeraccounts selbst werden im Web-Portal „Delegierte Benutzerverwaltung” (DeBeV) des BAMF verwaltet, die Zugangsdaten anschließend in KuferSQL unter Einstellungen / Benutzerverwaltung / Module hinterlegt.
Was ist die Delegierte Benutzerverwaltung (DeBeV)?
Die Delegierte Benutzerverwaltung (DeBeV) ist das vom BAMF bereitgestellte Web-Portal, mit dem ein autorisierter Administrator des Kursträgers Benutzeraccounts für InGe-Online anlegt, löscht oder die Passwörter bestehender Accounts ändert. Die Verwaltung der Zugangsdaten im DeBeV erfolgt in Eigenverantwortung des Kursträgers.
Das Web-Portal ist unter folgenden Links erreichbar:
- Produktiv-Umgebung: https://benutzer.migra.bamf.de/debev
- Test-Umgebung: https://benutzer.test.migra.bamf.de/debev — für Abnahmetests der Schnittstelle.
Benutzer im DeBeV-Portal anlegen
Der Prozess „Benutzer anlegen” erfordert eine Authentifizierung durch einen Administrator einer Organisationsart (z. B. einen Kursträger-Administrator), der über den vorgelagerten Prozess „Online-Zugang beantragen” eingerichtet wurde.
Nach erfolgreicher Authentifizierung werden die folgenden Benutzerdaten in eine Web-Maske eingegeben. Pflichtangaben sind mit einem Stern (*) gekennzeichnet:
- E-Mail-Adresse (*) — wird zugleich als Benutzername verwendet
- Familienname (*)
- Vorname
- Telefonnummer (*)
- Passwort () inklusive Passwort Wiederholung ()
Erfolgsmeldung der Delegierten Benutzerverwaltung (DeBeV) nach erfolgreichem Anlegen eines Benutzeraccounts
Nach erfolgreichem Anlegen quittiert das DeBeV-Portal mit „Erfolgreich!” und dem Hinweis, dem neuen Anwender Benutzernamen und Passwort auf einem sicheren Weg mitzuteilen — also nicht per unverschlüsselter E-Mail im selben Mail-Verlauf, sondern beispielsweise per Telefon, persönlichem Übergabezettel oder über ein Passwort-Manager-Sharing.
Authentifizierung und Verifikationskennung
Bevor ein Administrator überhaupt Benutzer anlegen kann, muss er selbst einen Antrag auf Zulassung zum Online-Verfahren stellen. Dieser Prozess läuft so ab:
- Ein autorisierter Mitarbeiter des Kursträgers ruft die vom BAMF bereitgestellte Internet-Web-Anwendung auf.
- Dort gibt er zunächst den Registrierungscode ein, den das BAMF per Post zugesandt hat.
- Auf die im Antrag angegebene Mail-Adresse erhält er eine Verifikationskennung.
- Die Antrags-Angaben werden mit dieser Verifikationskennung an das BAMF zur Bearbeitung weitergeleitet.
Erst nach Freigabe durch das BAMF ist der Antragsteller als Administrator authentifiziert und kann selbst weitere Benutzer (z. B. Sachbearbeiter, Sekretariat) im DeBeV anlegen.
Zugangsdaten je Benutzer in KuferSQL hinterlegen
Die im DeBeV erzeugten Zugangsdaten müssen anschließend in KuferSQL je KuferSQL-Anwender hinterlegt werden. Den Eintrag finden Sie unter Einstellungen → Benutzerverwaltung → Reiter Module.
Reiter „Module” in der Benutzerverwaltung — über die Schaltfläche „Einstellungen” werden die InGe-Online-Zugangsdaten je Benutzer gepflegt
Im Reiter Module klicken Sie neben dem Eintrag InGe-Online auf die Schaltfläche Einstellungen. Der Dialog Einstellungen für BAMF InGe-Online öffnet sich:
Benutzerbezogener Zugangsdaten-Dialog — Benutzername und Passwort sind DeBeV-Zugangsdaten, Mandant überschreibt nur bei Bedarf die zentrale Einstellung
Tragen Sie hier ein:
- Benutzer: Der DeBeV-Benutzername dieses KuferSQL-Anwenders — das ist seine im DeBeV hinterlegte E-Mail-Adresse.
- Passwort: Das DeBeV-Passwort dieses Anwenders.
- Mandant: Leer lassen, sofern dieser Benutzer nur die Standard-Trägerkennung aus den Zentralen Einstellungen verwendet. Nur bei Mandantenfähigkeit (mehrere Trägerkennungen je Träger-Installation) wird hier eine abweichende Trägerkennung eingetragen.
Optional: Kooperationsmodell Fahrtkosten je Benutzer überschreiben
Die Einstellungen zum Kooperationsmodell Fahrtkosten können bei Bedarf auch je Benutzer (Mandant) übersteuert werden:
- Zentrale Einstellungen übersteuern: Haken setzen, wenn dieser Benutzer/Mandant vom Träger-weiten Standard abweichen soll.
- Teilnahme am Kooperationsmodell Fahrtkosten: Haken setzen, wenn dieser Mandant am Kooperationsmodell teilnimmt.
- für Kurse mit Beginn von / bis: Datumsfenster, in dem das Kooperationsmodell gilt.
Ergebnis
Mit gepflegten DeBeV-Benutzern und korrekt hinterlegten Zugangsdaten je KuferSQL-Anwender sind die Webservice-Aufrufe technisch autorisiert: KuferSQL authentifiziert die Aufrufe der BAMF-Webservices mit den hinterlegten Zugangsdaten. Welche Felder im Teilnehmerstamm für das BAMF-Aktenzeichen gepflegt sein müssen, damit diese Datenflüsse personenbezogen zuordenbar sind, beschreibt der zugehörige Artikel.