shoucheng3/apache__jspwiki_cve-2019-10076_2-11-0-m3Piattaforma wiki basata su Java con integrazione della sicurezza JAAS, controllo degli accessi e audit dettagliato della configurazione. Include documentazione per installazione, aggiornamento e gestione delle politiche.
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.
Il file di licenza si trova in LICENSE.
JSPWiki è un clone semplice (beh, non più) di WikiWiki, scritto in Java e JSP. Un WikiWiki è un sito web che consente a chiunque di partecipare al suo sviluppo. JSPWiki supporta tutte le caratteristiche tradizionali di wiki, oltre a un controllo degli accessi molto dettagliato e all'integrazione della sicurezza utilizzando JAAS.
Ok, quindi vuoi un Wiki? Avrai bisogno delle seguenti cose:
REQUIRED:
Un motore JSP che supporti Servlet API 3.1. Raccomandiamo Tomcat da http://tomcat.apache.org/ per un'installazione davvero facile. È supportato Tomcat 8.x o successivo.
Una certa esperienza precedente di amministrazione... Se hai mai installato Apache o un altro server web, dovresti essere a posto.
E ovviamente un server su cui eseguire il motore JSP.
JDK 8+
OPTIONAL:
Questa sezione è pensata per te, se vuoi solo un'installazione molto rapida senza troppe preoccupazioni. Se desideri un'installazione più complicata (con maggiore controllo su come fare le cose), consulta la sezione "Installazione" di seguito.
A partire da JSPWiki 2.1.153, JSPWiki viene fornito con un motore di installazione molto semplice. Procedi come segue:
Installa Tomcat da http://tomcat.apache.org/ (o qualsiasi altro contenitore servlet)
Rinomina il file JSPWiki.war scaricato e ridenominalo in base al
tuo URL desiderato (se lo vuoi diverso da /JSPWiki). Ad esempio,
se vuoi che il tuo URL sia http://.../wiki, rinominalo in wiki.war.
Questo nome verrà indicato come di seguito.
Posiziona questo WAR nella cartella $TOMCAT_HOME/webapps e poi avvia Tomcat.
Punta il browser su http://<myhost>/<appname>/Install.jsp
Rispondi a un paio di semplici domande
Riavvia il contenitore
Punta il browser su http://<myhost>/<appname>/
Tutto qui!
Nella cartella $TOMCAT_HOME/lib (o equivalente in base al contenitore servlet),
posiziona un file jspwiki-custom.properties, che può contenere qualsiasi sovrascrittura al
file predefinito ini/jspwiki.properties nel JAR di JSPWiki. Per qualsiasi valore non
inserito nel file jspwiki-custom.properties, JSPWiki farà affidamento sul file predefinito.
Esamina il file predefinito per cercare valori che potresti voler sovrascrivere nel file
personalizzato. Alcuni valori comuni da sovrascrivere nel file personalizzato includono
jspwiki.xmlUserDatabaseFile, jspwiki.xmlGroupDatabaseFile,
jspwiki.fileSystemProvider.pageDir, jspwiki.basicAttachmentProvider.storageDir,
e log4j.appender.FileLog.File. I commenti nel file predefinito suggeriranno
valori appropriati con cui sovrascriverli.
Il file personalizzato può anche essere posizionato nella cartella WEB-INF/ del WAR, ma archiviare
questo file in $TOMCAT_HOME/lib ti consente di aggiornare il WAR di JSPWiki senza dover
reinserire le personalizzazioni.
Decomprimi il contenuto di jspwiki-corepages.zip nella directory appena creata.
Puoi trovare il resto della documentazione nel file JSPWiki-doc.zip.
(Ri)avvia Tomcat.
Punta il browser su http://<dove è installato Tomcat>/MyWiki/. Dovresti vedere la pagina principale del Wiki. Vedi la sezione successiva se vuoi modificare le pagine =).
Il file WEB-INF/jspwiki.policy viene utilizzato per modificare i permessi di accesso per
il Wiki.
Controlla il sito web di Apache JSPWiki e la documentazione del progetto per suggerimenti aggiuntivi su configurazione e impostazione.
Si prega di leggere ReleaseNotes e il documento UPGRADING disponibile con questa distribuzione.
Le domande possono essere rivolte ai membri del team di JSPWiki e agli altri utenti tramite la mailing list jspwiki-users: Vedi http://jspwiki.apache.org/community/mailing_lists.html. Si prega di utilizzare la mailing list degli utenti invece di contattare direttamente i membri del team, e poiché questa è una lista pubblica conservata in archivi pubblici, assicurati di evitare di includere informazioni sensibili (password, dati, ecc.) nelle tue domande.