Kommunikation mit dem ZSS

In der Anwendung ASV gibt es fachliche Situationen, in der eine Verbindung zum Zentralsystem hergestellt werden muss (z. B. ASV-Installation auf Aktualität prüfen). Sie benötigen dafür Ihre Schulnummer (Kennung für das Schulportal/OWA-Portal) und das Schulpasswort (OWA-Passwort).

Für zentrale ASV-Betreiber (z.B. IT-Betrieb der Stadt) wurde eine eigene Kennung (in der Art asv.meinestadt) und ein Zertifikat erstellt. In diesem Fall können Sie sich auch mit dieser Kennung und dem zugehörigen Passwort anmelden.

Wenn Sie die Verbindung zum Zentralsystem nicht herstellen können, dann versuchen Sie es erneut, um zu prüfen, ob das Passwort richtig geschrieben wurde.

Wenn Wartungsarbeiten oder technische Störungen des Zentralsystems oder der zentralen Infrastruktur vorliegen, werden diese auf der Startseite von https://www.asv.bayern.de vermerkt. Versuchen Sie es in diesen Fällen später wieder, eine Verbindung zum Zentralsystem aufzubauen.

Wenn Sie das Schulportal aufrufen dürfen, dann versuchen Sie sich mit der Schulnummer und dem OWA-Passwort anzumelden. Wenn es nicht funktioniert, dann klären Sie bitte ab, ob das OWA-Passwort geändert wurde. Wenn Sie das Schulportal nicht aufrufen dürfen, dann wenden Sie sich bitte an Ihre Schulleitung. Weitere Informationen erhalten Sie auf der Hilfeseite des Schulportals.

Es muss die aktuelle ASV-Version verwendet werden. Wenn die aktuelle Version nicht installiert ist, dann wenden Sie sich an Ihren ASV-Systembetreuer der Schule bzw. des zentralen Betreibers. Die Wertelisten müssen auf dem aktuellen Stand sein. Führen Sie im Zweifelsfall ein Wertelisten-Update durch. Dafür muss aber die grundsätzliche Kommunikation mit dem Zentralsystem vorhanden sein.

Im Rahmen der Zertifikatserneuerung sind die häufigsten Fehler, die zu Verbindungsproblemen führen:

• Es wurde für die Zertifikatsinstallation ein veraltetes Installationspaket verwendet.
• Der ASV-Server (DSS) wurde nicht neu gestartet.

Evtl. wurden Netzwerkkomponenten (z.B. Firewall oder Proxy) verändert. Der häufigste Fehler ist die fehlende Proxy-Konfiguration. Wenn in Ihrer Netzwerkinfrastruktur ein Proxy verwendet wird, dann prüfen Sie die aktuelle Konfiguration in der Installation des ASV-Servers gemäß der Proxy-Dokumentationsseite.

Überprüfen Sie die Verbindung vom ASV-Server (DSS) mittels Browser.

Sollte der Zugriff im Browser nicht funktionieren, dann besteht ein Netzwerkproblem zwischen ASV-Server und ZSS.

1. Diese Netzwerkprobleme müsssen zuerst beseitigt werden.
2. Dafür müssen insbesondere Firewall und Proxy geprüft werden.
3. Falls die Kommunikation über das ByBN laufen soll, aber aktuell nicht funktioniert, dann prüfen Sie, ob die Kommunikation über das Internet funktioniert. Ggf. kann die Internetverbindung genutzt werden, bis die Probleme mit dem ByBN beseitigt sind.

Wenn der Zugriff im Browser funktioniert und in ASV nicht, dann prüfen Sie den Ordner certs im Installationsverzeichnis des DSS. In diesem Ordner sollte eine Datei mit dem Namen client.keystore liegen und ca. 54 kB groß sein. Wenn das nicht der Fall ist, dann führen Sie mit Hilfe des aktuellen Updateinstallers eine Zertifikatinstallation durch und starten den DSS neu.

Falls es immer noch nicht funktioniert, ergänzen Sie bitte folgende Zeilen in der Datei configuration/config.local.ini des ASV-Servers:

config.local.ini

#
# log settings
#
javax.net.debug=ssl:handshake:verbose
log4j.conf.file=log4j-debug.xml

Anschließend ASV-Server und ASV-Client neu starten und erneut versuchen, die Schule anzulegen. Es wird wieder nicht funktionieren, aber die Log-Dateien sollten deutlich umfangreicher sein. Die Logdateien vom ASV-Server packen Sie bitte in einen zip-komprimierten Ordner und senden diesen per E-Mail an Ihren Multiplikator. Falls dieser nicht selbst helfen kann, wird ein ASV-Ticket erstellt, welches dann vom Projektteam bearbeitet wird. Die Datei asv-server-stdout.txt enthält die Informationen zum SSL-Handshake.

Die Betreiber aus dem Bayerischen Behördennetz (BYBN) sollen auch bei der Installation ein eigenes Schulportal-Zertifikat verwenden. Es muss nur die Adresse des ZSS https://asv-zss-isa.schulen.bayern.de:443/svp angepasst werden. Für den Parallelbetrieb muss die Adresse https://asv-zss-para-isa.schulen.bayern.de:443/svp verwendet werden.

Dafür legen Sie die Datei config.local.ini im Verzeichnis configuration an bzw. ergänzen folgende Zeilen:

config.local.ini

#ZSS
remote.server.url=https://asv-zss-isa.schulen.bayern.de:443/svp

Das IT-Dienstleistungszentrum als Betreiber des bayerischen Behördennetzes weist darauf hin, dass versucht wird, die IP-Adressen der Server stabil zu halten, dass sich aber aus betrieblichen Gründen die IP-Adressen der Server ändern können.

Zuletzt hat sich die IP-Adresse dieser Server im BYBN am 20.11.2015 geändert auf 10.173.244.19. Falls bei Ihnen direkt die IP-Adresse im ASV-Server oder in der Firewall konfiguriert ist, müssen diese Einstellungen angepasst werden.

In der folgenden Tabelle können Sie den für Sie passenden Eintrag für den Zugriff auf den ZSS ermitteln:

remote.server.url=https://asv-zss-extern.schulen.bayern.de:443/svp

remote.server.url=https://asv-zss-isa.schulen.bayern.de:443/svp

remote.server.url=https://asv-zss-para-extern.schulen.bayern.de:443/svp

remote.server.url=https://asv-zss-para-isa.schulen.bayern.de:443/svp

remote.server.url=https://asv-zss-anfo-extern.schulen.bayern.de:443/svp

remote.server.url=https://asv-zss-anfo-isa.schulen.bayern.de:443/svp