Author: brett
Date: Thu Nov 22 19:57:20 2007
New Revision: 597537
URL: http://svn.apache.org/viewvc?rev=597537&view=rev
Log:
move the security configuration
Added:
maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/customising-security.apt
Removed:
maven/archiva/trunk/archiva-docs/src/site/apt/guides/security-configuration.apt
Modified:
maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/security.apt
maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/standalone.apt
maven/archiva/trunk/archiva-docs/src/site/site.xml
Added:
maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/customising-security.apt
URL:
http://svn.apache.org/viewvc/maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/customising-security.apt?rev=597537&view=auto
==============================================================================
---
maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/customising-security.apt
(added)
+++
maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/customising-security.apt
Thu Nov 22 19:57:20 2007
@@ -0,0 +1,51 @@
+ -----
+ Archiva Security Configuration
+ -----
+
+Archiva Security Configuration
+
+ Security properties and password rules can be configured in the
+ <<<security.properties>>> file, which by default is searched for in:
+
+ * <<<~/.m2/security.properties>>>
+
+ * <<<$ARCHIVA_HOME/conf/security.properties>>>
+
+ []
+
+ (In the above list, <<<~>>> is the home directory of the user who is running
+ Archiva, and <<<$ARCHIVA_HOME>>> is the directory where Archiva is installed,
+ such as <<</opt/archiva-1.0-SNAPSHOT>>>.)
+
+~~TODO: Link to plexus-redback documentation when available
+
+ Following are some of the properties you can modify. For a complete list,
+ consult the default properties file in Redback's svn repo:
+
{{{http://svn.codehaus.org/redback/redback/trunk/redback-configuration/src/main/resources/org/codehaus/plexus/redback/config-defaults.properties}
+ config-defaults.properties}}
+
++-----+
+# Security Policies
+#security.policy.password.encoder=
+security.policy.password.previous.count=6
+security.policy.password.expiration.days=90
+security.policy.allowed.login.attempt=3
+
+# Password Rules
+security.policy.password.rule.alphanumeric.enabled=false
+security.policy.password.rule.alphacount.enabled=true
+security.policy.password.rule.alphacount.minimum=1
+security.policy.password.rule.characterlength.enabled=true
+security.policy.password.rule.characterlength.minimum=1
+security.policy.password.rule.characterlength.maximum=8
+security.policy.password.rule.musthave.enabled=true
+security.policy.password.rule.numericalcount.enabled=true
+security.policy.password.rule.numericalcount.minimum=1
+security.policy.password.rule.reuse.enabled=true
+security.policy.password.rule.nowhitespace.enabled=true
++-----+
+
+ <<Note:>> If installed standalone, Archiva's list of configuration files is
<itself> configurable, and
+ can be found in:
+
<<<$ARCHIVA_HOME/apps/archiva/webapp/WEB-INF/classes/META-INF/plexus/application.xml>>>
+
Modified: maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/security.apt
URL:
http://svn.apache.org/viewvc/maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/security.apt?rev=597537&r1=597536&r2=597537&view=diff
==============================================================================
--- maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/security.apt
(original)
+++ maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/security.apt Thu
Nov 22 19:57:20 2007
@@ -9,6 +9,8 @@
* {{{roles.html} Roles in Archiva}}
+ * {{{customising-security.html} Customising Security}}
+
[]
~~TODO: LDAP
Modified:
maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/standalone.apt
URL:
http://svn.apache.org/viewvc/maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/standalone.apt?rev=597537&r1=597536&r2=597537&view=diff
==============================================================================
--- maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/standalone.apt
(original)
+++ maven/archiva/trunk/archiva-docs/src/site/apt/adminguide/standalone.apt Thu
Nov 22 19:57:20 2007
@@ -29,6 +29,54 @@
Note that the configuration can be edited, but only when Archiva is not
running as it will not reload a changed configuration file, and will save over
it
if something is changed in the web interface.
+* Database
+
+ By default, Archiva uses embedded {{{http://db.apache.org/derby}Apache Derby}}
+ to store the user information. It can be configured to use an external
database
+ by providing a JDBC driver and editing the <<<plexus.xml>>> file.
+
+ [[1]] Place the jar containing the JDBC driver in <<<$ARCHIVA_HOME/core>>>.
+
+ [[2]] Edit <<<$ARCHIVA_HOME/conf/plexus.xml>>>, providing the JDBC driver
class
+ name, and the database url, username, and password.
+
+ []
+
+ For example:
+
++------+
+<!--
+ Datasources
+-->
+<resource>
+ <name>jdbc/users</name>
+ <type>javax.sql.DataSource</type>
+ <properties>
+ <property>
+ <name>driverClassName</name>
+ <value>org.apache.derby.jdbc.ClientDriver</value>
+ </property>
+ <property>
+ <name>url</name>
+ <value>jdbc:derby://localhost:1527/archiva-users;create=true</value>
+ </property>
+ <property>
+ <name>username</name>
+ <value>user1</value>
+ </property>
+ <property>
+ <name>password</name>
+ <value>user1</value>
+ </property>
+ </properties>
+</resource>
++------+
+
+ More information about using Derby Network Server as an external user database
+ for Archiva can be found on the wiki:
+
{{{http://docs.codehaus.org/display/MAVENUSER/Archiva+User+DB+on+Derby+Network+Server}
+ Archiva User DB on Derby Network Server}}
+
{Upgrading Archiva}
Modified: maven/archiva/trunk/archiva-docs/src/site/site.xml
URL:
http://svn.apache.org/viewvc/maven/archiva/trunk/archiva-docs/src/site/site.xml?rev=597537&r1=597536&r2=597537&view=diff
==============================================================================
--- maven/archiva/trunk/archiva-docs/src/site/site.xml (original)
+++ maven/archiva/trunk/archiva-docs/src/site/site.xml Thu Nov 22 19:57:20 2007
@@ -52,6 +52,7 @@
<item name="Databases" href="/adminguide/databases.html"
/>
<item name="Security" href="/adminguide/security.html"
collapse="true">
<item name="Roles" href="/adminguide/roles.html" />
+ <item name="Customising"
href="/adminguide/customising-security.html" />
<!-- TODO: for a future version
<item name="Using LDAP" href="/adminguide/ldap.html" />
-->
@@ -74,7 +75,6 @@
<menu name="Old Menu (deprecated)">
<item name="FAQ"
href="http://docs.codehaus.org/display/MAVENUSER/Archiva+FAQ"/>
<item name="Maven Configuration"
href="/guides/maven-configuration.html"/>
- <item name="Security Configuration"
href="/guides/security-configuration.html"/>
<item name="Hacking Archiva" href="/hacking/index.html"/>
</menu>
</body>
