475
Bearbeitungen
Signieren von Applets: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Signieren von Applets (Quelltext anzeigen)
Version vom 7. Juni 2021, 13:53 Uhr
, 13:53, 7. Jun. 2021→Erstellung des Zertifikatsschlüssels
| (20 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
= Einleitung = | = Einleitung = | ||
Die Verwendung von Java-Applets ist eine der ältesten Möglichkeiten Interaktivität in eine Web-Seite zu bringen (und war aus diesem Grund in den 90er Jahren ein Grund für die schnelle Verbreitung von Java). Hinter einem Applet steckt Java-(Byte-)Code, der über das HTTP-Protokoll auf den Rechner des Benutzers geladen und dort ausgeführt wird. Aufgrund der mit diesem Verfahren verbundenen Risiken, wurden die Sicherheitsbestimmungen der Java Runtime Engine in den letzten Jahren immer stärker erhöht, womit gleichzeitig die reibungslose Ausführung des Applets erschwert wird. | |||
''' | Ein Ausweg aus dieser immer enger werden Zwickmühle ist die Möglichkeit ''Applets'' mit Hilfe eines Zertifikats zu ''signieren''. Die folgende Beschreibung zeigt die hierfür nötigten Schritte. | ||
= Liste der benötigten Zutaten = | = Liste der benötigten Zutaten = | ||
| Zeile 14: | Zeile 14: | ||
= Erstellung des Signatur-Zertifikats = | = Erstellung des Signatur-Zertifikats = | ||
Zur Signatur des Applets wird vorab ein Sicherheits-Zertifikat benötigt, welches sich Mitarbeitende der FernUniversität über die hochschulweite ''Certification Authority'' (CA) ausstellen lassen können. Die | Zur Signatur des Applets wird vorab ein Sicherheits-Zertifikat benötigt, welches sich Mitarbeitende der FernUniversität über die hochschulweite ''Certification Authority'' (CA) ausstellen lassen können. Die im weiteren Verlauf gezeigten Arbeitsschritte müssen glücklicherweise nur ''einmal'' durchgeführt werden, d.h. ein auf diese Weise erstelltes Zertifikat kann für die Signierung mehrerer Applets verwendet werden. | ||
So | So wird's gemacht: | ||
== Erstellung des Zertifikatsschlüssels == | == Erstellung des Zertifikatsschlüssels == | ||
| Zeile 31: | Zeile 31: | ||
[Unknown]: GRP: CodeSigning ''Abt. Basisanwendungen'' | [Unknown]: GRP: CodeSigning ''Abt. Basisanwendungen'' | ||
Wie lautet der Name Ihrer organisatorischen Einheit? | Wie lautet der Name Ihrer organisatorischen Einheit? | ||
[Unknown]: ''Zentrum fuer | [Unknown]: ''Zentrum fuer Digitalisierung und IT'' | ||
Wie lautet der Name Ihrer Organisation? | Wie lautet der Name Ihrer Organisation? | ||
[Unknown]: FernUniversitaet in Hagen | [Unknown]: FernUniversitaet in Hagen | ||
| Zeile 40: | Zeile 40: | ||
Wie lautet der Ländercode (zwei Buchstaben) für diese Einheit? | Wie lautet der Ländercode (zwei Buchstaben) für diese Einheit? | ||
[Unknown]: DE | [Unknown]: DE | ||
Ist CN=GRP: CodeSigning Abt. Basisanwendungen, OU=Zentrum fuer | Ist CN=GRP: CodeSigning Abt. Basisanwendungen, OU=Zentrum fuer Digitalisierung und IT, O=FernUniversitaet in Hagen, L=Hagen, | ||
ST=Nordrhein-Westfalen, C=DE richtig? | ST=Nordrhein-Westfalen, C=DE richtig? | ||
[Nein]: Ja | [Nein]: Ja | ||
| Zeile 46: | Zeile 46: | ||
'''Zu beachten!''' | '''Zu beachten!''' | ||
* Als Vor- und Nachname (CN) verwenden Sie in jedem Fall die Zeichenkette | * Als Vor- und Nachname (CN) verwenden '''Sie in jedem Fall die Zeichenkette ''GRP: CodeSigning''''' gefolgt vom Namen Ihrer Abteilung oder Ihres Lehrgebiets. | ||
* Als organisatorische Einheit (OU) versenden Sie den Namen Ihrer zentralen Einrichtung oder Ihrer Fakultät. | * Als organisatorische Einheit (OU) versenden Sie den Namen Ihrer zentralen Einrichtung oder Ihrer Fakultät. | ||
| Zeile 60: | Zeile 60: | ||
== Ausstellung des Zertifikats == | == Ausstellung des Zertifikats == | ||
Zur Ausstellung des Zertifikats | Zur Ausstellung des Zertifikats öffnen Sie in Ihrem Webbrowser die Seite [https://pki.pca.dfn.de/fernuni-hagen-ca-g2/pub https://pki.pca.dfn.de/fernuni-hagen-ca-g2/pub]. | ||
* Klicken Sie auf die Karteikarte '''Serverzertifikat'''. | * Klicken Sie auf die Karteikarte '''Serverzertifikat'''. | ||
| Zeile 66: | Zeile 66: | ||
* Füllen Sie das auf dieser Seite befindliche Formular aus, und wählen Sie als '''Zertifikatsprofil''' den Eintrag '''User'''! | * Füllen Sie das auf dieser Seite befindliche Formular aus, und wählen Sie als '''Zertifikatsprofil''' den Eintrag '''User'''! | ||
Der | Der Ausstellungsprozess endet mit der Erstellung eines PDF-Dokuments, welches '''persönlich''' (d.h. ausgedruckt und unterschrieben) bei unserer Certification Authority (Herr Heikamp / Herr Löffler, ''Zentrum für Digitalisierung und IT, AVZ, Raum A212'') abgegeben werden muss. Dieser ändert den Eintrag User auf "Code-Signing". | ||
Weisen Sie die Kollegen bei der Gelegenheit sicherheitshalber nochmal darauf hin, dass das Zertifikat für ''Code-Signing'' benötigt wird. Das Zertifikat wird Ihnen im Anschluss per E-Mail zugeschickt. | Weisen Sie die Kollegen bei der Gelegenheit sicherheitshalber nochmal darauf hin, dass das Zertifikat für ''Code-Signing'' benötigt wird. Das Zertifikat wird Ihnen im Anschluss per E-Mail zugeschickt. | ||
== Import der CA-Zertifikate in den Keystore == | |||
Laden Sie über die Seite [https://pki.pca.dfn.de/fernuni-hagen-ca-g2/pub https://pki.pca.dfn.de/fernuni-hagen-ca-g2/pub] jeweils das Wurzelzertifikat, das DFN-PCA-Zertifikat, und das DFN-CA-Global-G2-Zertifikat einzeln als .cer Dateien herunter. | |||
Anschließend werden die Zertifikate über den folgenden Befehl einzeln in den Keystore eingebunden: | |||
keytool –import –alias <Name> -file <Dateipfad>.cer | |||
Die Abfragen nach der Vertrauenswürdigkeit werden mit "Ja" beantwortet. | |||
Erst nach diesem Schritt ist es möglich das eigene Zertifikat mit dem ausgestellten Zertifikat zu verbinden. | |||
== Import des Zertifikats == | == Import des Zertifikats == | ||
Der Import des ausgestellten Zertifkats in den Java-Zertifikatsspeicher ist | Der Import des ausgestellten Zertifkats in den Java-Zertifikatsspeicher ist dafür relativ trivial. | ||
keytool -import -alias ''meinZertifikat'' -trustcacerts -file ''cert.p7b'' | keytool -import -alias ''meinZertifikat'' -trustcacerts -file ''cert.p7b'' | ||
| Zeile 78: | Zeile 89: | ||
erzeugt die Verbindung des neuen Zertifikats (aus der Datei ''cert.p7b'') mit dem mittlerweile bekannten Alias ''meinZertifikat''. | erzeugt die Verbindung des neuen Zertifikats (aus der Datei ''cert.p7b'') mit dem mittlerweile bekannten Alias ''meinZertifikat''. | ||
= | = Signieren der Applet-Datei = | ||
* Stellen Sie sicher, dass sich Ihre Applet-Datei, in unserem Beispiel (s.o.) ''MeinApplet.jar'', in einem ansonsten leeren Verzeichnis befindet. | |||
* | * Erstellen Sie in diesem Verzeichnis eine neue Datei ''manifest-addons'' mit den folgendem zwei Zeilen als Inhalt: | ||
Application-Name: ''Applet-Name'' | |||
Permissions: all-permissions | |||
''Application-Name'' ein frei wählbarer Name, der dem Benutzer später beim Start des Applets angezeigt wird. Möglich wäre bspw. ein Eintrag wie ''Mein Applet (FernUni-signiert)''. | |||
Über ''Permissions'' bestimmen Sie die Rechte-Matrix Ihres Applets | Über ''Permissions'' bestimmen Sie die Rechte-Matrix Ihres Applets. ''all-permissions'' lässt dem Applet dabei alle möglichen Freiheiten, u.a. die Möglichkeit einer Netzwerkverbindung zu externen Servern, sowie den Zugriff auf das lokale Datei-System des Rechners, auf dem es ausgeführt wird! | ||
Erweitern Sie nun Ihre Applet-Datei durch die | Erweitern Sie nun Ihre Applet-Datei ''MeinApplet.jar'' durch die oben festgelegten Manifest-Ergänzungen | ||
jar ufm ''MeinApplet.jar'' manifest-addons | jar ufm ''MeinApplet.jar'' manifest-addons | ||
Als letzte Maßnahme wird das Gesamt-Paket | Als letzte Maßnahme wird das Gesamt-Paket nun signiert und in einer neuen Datei ''MeinAppletSigned.jar'' abgelegt. | ||
jarsigner -verbose -tsa <nowiki>http://zeitstempel.dfn.de/</nowiki> -signedjar ''MeinAppletSigned.jar'' MeinApplet.jar ''meinZertifikat'' | jarsigner -verbose -tsa <nowiki>http://zeitstempel.dfn.de/</nowiki> -signedjar ''MeinAppletSigned.jar'' MeinApplet.jar ''meinZertifikat'' | ||
Das Einfügen eines Timestamps über die Option ''-tsa'' birgt den Vorteil, dass dem zum signieren benutzten Zertifikat die Gültigkeit zum Zeitpunkt der Applet-Signierung bescheinigt wird. Hierdurch entfällt ein evtl. später regelmäßig benötigtes <nowiki>"nachsignieren"</nowiki>. Die Bereitstellung des Timestamp übernimmt freundlicherweise der DFN-Verein als Service unter der o.a. Adresse. | |||
= Änderungen in der HTML-Umgebung = | |||
Ersetzen Sie auf Ihrem Server nun die Datei ''MeinApplet.jar'' durch die signierte Variante ''MeinAppletSigned.jar''. | |||
Suchen Sie jetzt in der korrespondierenden HTML-Datei die Stelle, an der das Applet eingebunden wird. Prinzipiell sollte sie ungefähr folgendes Aussehen haben: | |||
<applet code="MeinApplet.class" | |||
archive="''MeinApplet.jar''" | |||
codebase="..."> | |||
(...) | |||
</applet> | |||
Passen Sie diese Umgebung nun an die signierte Applet-Datei an. | |||
* Ändern Sie den Wert des ''archive''-Parameters in ''MeinAppletSigned.jar''. | |||
* Fügen Sie die Zeile | |||
<param name="Permissions" value="all-permissions"> | |||
in die <applet>-Umgebung ein. Der ''value''-Wert muss dabei mit der Angabe in der o.a. Datei ''manifest-addons'' identisch sein, in unserem Fall also auf ''all-permissions'' gesetzt werden. | |||
Das Ganze noch einmal im Überblick zusammengefasst: | |||
<applet code="MeinApplet.class" | |||
archive="''MeinAppletSigned.jar''" | |||
codebase="..."> | |||
<param name="Permissions" value="all-permissions"> | |||
(...) | |||
</applet> | |||
Laden Sie nun die o.a. HTML-Seite in Ihren Webbrowser, und kontrollieren Sie, ob das signierte Applet wie gewünscht geladen wird. | |||
[[Kategorie:Internet-Dienste]] | [[Kategorie:Internet-Dienste]] | ||
[[Kategorie:Lehren_Weitere_Werkzeuge]] | [[Kategorie:Lehren_Weitere_Werkzeuge]] | ||
[[Kategorie:Zertifikate]] | [[Kategorie:Zertifikate]] | ||