shoucheng3/apache__jspwiki_cve-2019-10076_2-11-0-m3Java-basierte Wiki-Plattform mit JAAS-Sicherheitsintegration, Zugriffskontrolle und detaillierter Konfigurationsprüfung. Enthält Dokumentation für Installation, Upgrade und Richtlinienverwaltung.
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
Die Lizenzdatei finden Sie in LICENSE.
JSPWiki ist ein einfacher (nun ja, nicht mehr so einfacher) WikiWiki-Klon, der in Java und JSP geschrieben ist. Ein WikiWiki ist eine Website, die es jedem ermöglicht, an ihrer Entwicklung teilzunehmen. JSPWiki unterstützt alle traditionellen Wiki-Funktionen sowie eine sehr detaillierte Zugriffskontrolle und Sicherheitsintegration über JAAS.
Okay, Sie möchten also ein Wiki? Sie benötigen die folgenden Dinge:
ERFORDERLICH:
Eine JSP-Engine, die Servlet API 3.1 unterstützt. Für eine wirklich einfache Installation empfehlen wir Tomcat von http://tomcat.apache.org/. Unterstützt wird Tomcat 8.x oder höher.
Einige Erfahrung mit Administration... Wenn Sie schon einmal Apache oder einen anderen Webserver installiert haben, sind Sie gut aufgestellt.
Und natürlich einen Server, auf dem die JSP-Engine läuft.
JDK 8+
OPTIONAL:
Dieser Abschnitt ist für Sie gedacht, wenn Sie eine wirklich schnelle Installation ohne viel Aufwand wünschen. Wenn Sie eine kompliziertere Installation möchten (mit mehr Kontrolle darüber, wie die Dinge erledigt werden), schauen Sie sich weiter unten den Abschnitt „Install" an.
Seit JSPWiki 2.1.153 verfügt JSPWiki über eine wirklich einfache Installations-Engine. Gehen Sie einfach wie folgt vor:
Installieren Sie Tomcat von http://tomcat.apache.org/ (oder einem anderen Servlet-Container)
Benennen Sie die heruntergeladene Datei JSPWiki.war anhand Ihrer gewünschten URL um
(falls sie sich von /JSPWiki unterscheiden soll). Wenn Ihre URL beispielsweise
http://.../wiki lauten soll, benennen Sie sie in wiki.war um. Dieser Name wird
im Folgenden als bezeichnet.
Platzieren Sie diese WAR-Datei in Ihrem Ordner $TOMCAT_HOME/webapps und starten
Sie dann Tomcat.
Rufen Sie mit Ihrem Browser http://<myhost>/<appname>/Install.jsp auf
Beantworten Sie ein paar einfache Fragen
Starten Sie Ihren Container neu
Rufen Sie mit Ihrem Browser http://<myhost>/<appname>/ auf
Das war's!
Legen Sie im Ordner $TOMCAT_HOME/lib (oder dem entsprechenden Ordner Ihres
Servlet-Containers) eine Datei jspwiki-custom.properties ab, die beliebige
Überschreibungen der Standarddatei ini/jspwiki.properties im JSPWiki-JAR enthalten
kann. Für alle Werte, die nicht in der Datei jspwiki-custom.properties festgelegt
sind, greift JSPWiki auf die Standarddatei zurück. Lesen Sie die Standarddatei, um
Werte zu finden, die Sie in der benutzerdefinierten Datei überschreiben möchten.
Einige häufige Werte, die Sie in Ihrer benutzerdefinierten Datei überschreiben können,
sind jspwiki.xmlUserDatabaseFile, jspwiki.xmlGroupDatabaseFile,
jspwiki.fileSystemProvider.pageDir, jspwiki.basicAttachmentProvider.storageDir
und log4j.appender.FileLog.File. Die Kommentare in der Standarddatei schlagen
geeignete Werte für die Überschreibung vor.
Die benutzerdefinierte Datei kann auch im Ordner WEB-INF/ des WAR abgelegt werden.
Wenn Sie diese Datei jedoch in $TOMCAT_HOME/lib speichern, können Sie das
JSPWiki-WAR aktualisieren, ohne Ihre Anpassungen erneut einfügen zu müssen.
Entpacken Sie den Inhalt von jspwiki-corepages.zip in Ihr neu erstelltes
Verzeichnis. Die restliche Dokumentation finden Sie in der Datei JSPWiki-doc.zip.
Starten Sie Tomcat (neu).
Rufen Sie mit Ihrem Browser http://<wo Ihr Tomcat installiert ist>/MyWiki/ auf. Sie sollten die Haupt-Wiki-Seite sehen. Wenn Sie die Seiten bearbeiten möchten, lesen Sie den nächsten Abschnitt =).
Die Datei WEB-INF/jspwiki.policy wird verwendet, um die Zugriffsrechte für das Wiki
zu ändern.
Weitere Einrichtungs- und Konfigurationsvorschläge finden Sie auf der Apache-JSPWiki-Website und in der Projektdokumentation.
Bitte lesen Sie die ReleaseNotes und das UPGRADING-Dokument, die dieser Distribution beiliegen.
Fragen können an die Mitglieder des JSPWiki-Teams und andere Benutzer über die Mailingliste jspwiki-users gestellt werden: Siehe http://jspwiki.apache.org/community/mailing_lists.html. Bitte nutzen Sie die Benutzer-Mailingliste, anstatt Teammitglieder direkt zu kontaktieren. Da es sich um eine öffentliche Liste handelt, die in öffentlichen Archiven gespeichert ist, vermeiden Sie es, vertrauliche Informationen (Passwörter, Daten usw.) in Ihren Fragen anzugeben.