shoucheng3/apache__jspwiki_cve-2019-10076_2-11-0-m3Plateforme wiki basée sur Java avec intégration de sécurité JAAS, contrôle d'accès et audit détaillé de la configuration. Comprend une documentation pour l'installation, la mise à niveau et la gestion des politiques.
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.
The license file can be found in LICENSE.
JSPWiki est un clone de WikiWiki simple (enfin, plus tout à fait), écrit en Java et JSP. Un WikiWiki est un site web qui permet à quiconque de participer à son développement. JSPWiki prend en charge toutes les fonctionnalités wiki traditionnelles, ainsi qu'un contrôle d'accès très détaillé et une intégration de sécurité utilisant JAAS.
OK, vous voulez un Wiki ? Vous aurez besoin des éléments suivants :
OBLIGATOIRE :
Un moteur JSP compatible avec Servlet API 3.1. Nous recommandons Tomcat depuis http://tomcat.apache.org/ pour une installation très simple. Tomcat 8.x ou ultérieur est pris en charge.
Une certaine expérience préalable en administration... Si vous avez déjà installé Apache ou tout autre serveur web, vous devriez être bien loti.
Et bien sûr, un serveur pour faire tourner le moteur JSP.
JDK 8+
OPTIONNEL :
Cette section est pour vous, si vous voulez simplement une installation très rapide sans trop de soucis. Si vous souhaitez une installation plus compliquée (avec plus de contrôle sur la façon de faire), consultez la section « Install » ci-dessous.
Depuis JSPWiki 2.1.153, JSPWiki est livré avec un moteur d'installation très simple. Suivez simplement les étapes suivantes :
Installez Tomcat depuis http://tomcat.apache.org/ (ou tout autre conteneur de servlets)
Renommez le fichier JSPWiki.war du téléchargement en fonction de l'URL souhaitée
(si vous voulez quelque chose de différent de /JSPWiki). Par exemple,
si vous voulez que votre URL soit http://.../wiki, renommez-le en wiki.war.
Ce nom sera référencé comme ci-dessous.
Placez ce WAR dans votre dossier $TOMCAT_HOME/webapps puis démarrez Tomcat.
Pointez votre navigateur sur http://<myhost>/<appname>/Install.jsp
Répondez à quelques questions simples
Redémarrez votre conteneur
Pointez votre navigateur sur http://<myhost>/<appname>/
Et voilà !
Dans le dossier $TOMCAT_HOME/lib (ou équivalent selon votre conteneur de servlets),
placez un fichier jspwiki-custom.properties, qui peut contenir toutes les surcharges du
fichier par défaut ini/jspwiki.properties dans le JAR JSPWiki. Pour toute valeur non
placée dans le fichier jspwiki-custom.properties, JSPWiki s'appuiera sur le fichier par défaut.
Consultez le fichier par défaut pour rechercher les valeurs que vous pourriez souhaiter surcharger dans le fichier
personnalisé. Certaines valeurs courantes à surcharger dans votre fichier personnalisé incluent
jspwiki.xmlUserDatabaseFile, jspwiki.xmlGroupDatabaseFile,
jspwiki.fileSystemProvider.pageDir, jspwiki.basicAttachmentProvider.storageDir,
et log4j.appender.FileLog.File. Les commentaires dans le fichier par défaut suggéreront
des valeurs appropriées pour les surcharger.
Le fichier personnalisé peut également être placé dans le dossier WEB-INF/ du WAR, mais stocker
ce fichier dans $TOMCAT_HOME/lib vous permet de mettre à niveau le WAR JSPWiki sans avoir besoin
de réinsérer vos personnalisations.
Décompressez le contenu de jspwiki-corepages.zip dans votre répertoire
nouvellement créé. Vous trouverez le reste de la documentation dans le
fichier JSPWiki-doc.zip.
(Re)démarrez tomcat.
Pointez votre navigateur sur http://<là où votre Tomcat est installé>/MyWiki/. Vous devriez voir la page principale du Wiki. Voir la section suivante si vous souhaitez modifier les pages =).
Le fichier WEB-INF/jspwiki.policy est utilisé pour modifier les permissions d'accès au
Wiki.
Consultez le site Web d'Apache JSPWiki et la documentation du projet pour des suggestions supplémentaires d'installation et de configuration.
Veuillez lire les ReleaseNotes et le document UPGRADING fournis avec cette distribution.
Les questions peuvent être posées aux membres de l'équipe JSPWiki et aux autres utilisateurs via la liste de diffusion jspwiki-users : voir http://jspwiki.apache.org/community/mailing_lists.html. Veuillez utiliser la liste de diffusion des utilisateurs plutôt que de contacter directement les membres de l'équipe, et comme il s'agit d'une liste publique archivée dans des archives publiques, assurez-vous d'éviter d'inclure toute information sensible (mots de passe, données, etc.) dans vos questions.