Mailing-List: contact rave-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: rave-dev@incubator.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1228199 - in
 /incubator/rave/site/trunk/content/rave/documentation:
 captcha-enabling.mdtext index.mdtext
Date: Fri, 06 Jan 2012 14:27:44 -0000
To: rave-commits@incubator.apache.org
From: mpierce@apache.org
Message-Id: <20120106142744.B8DCC2388980@eris.apache.org>

Author: mpierce
Date: Fri Jan  6 14:27:44 2012
New Revision: 1228199

URL: http://svn.apache.org/viewvc?rev=1228199&view=rev
Log:
(RAVE-134) Instructions on enabling CATCHA for new account creation if building from source.

Added:
    incubator/rave/site/trunk/content/rave/documentation/captcha-enabling.mdtext   (with props)
Modified:
    incubator/rave/site/trunk/content/rave/documentation/index.mdtext

Added: incubator/rave/site/trunk/content/rave/documentation/captcha-enabling.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/documentation/captcha-enabling.mdtext?rev=1228199&view=auto
==============================================================================
--- incubator/rave/site/trunk/content/rave/documentation/captcha-enabling.mdtext (added)
+++ incubator/rave/site/trunk/content/rave/documentation/captcha-enabling.mdtext Fri Jan  6 14:27:44 2012
@@ -0,0 +1,41 @@
+Title: Enabling CAPTCHA
+Notice:    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.
+
+RAVE administrators can optionally enable CAPTCHA protection on the new account creation page.   The steps for doing this in 
+the source release are the following:
+
+##1) Get reCAPTCHA Public and Private Keys
+You must sign up at the [reCAPTCHA][1] site to obtain public and private key strings for your host domain.  For testing purpose, you 
+use ''localhost'' as your domain.
+
+##2) Add Keys to RAVE
+Modify the file ''rave-portal-resources/src/main/resources/portal.properties''.  Change the portal.captcha.* properties to 
+
+     portal.captcha.enabled=true
+     portal.captcha.key.private=YOUR_PRIVATE_KEY_STRING
+     portal.captcha.key.public=YOUR_PUBLIC_KEY_STRING
+
+When building RAVE from source, you should also similarly modify the test property files 
+''rave-components/rave-core/src/test/resources/portal.properties'' and ''rave-portal/src/test/resources/portal.properties'' for 
+proper build testing. 
+
+##3) Build and Deploy RAVE
+Use ''mvn clean install'' as usual.  
+
+ 
+[1]http://www.google.com/recaptcha/whyrecaptcha
\ No newline at end of file

Propchange: incubator/rave/site/trunk/content/rave/documentation/captcha-enabling.mdtext
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: incubator/rave/site/trunk/content/rave/documentation/index.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/documentation/index.mdtext?rev=1228199&r1=1228198&r2=1228199&view=diff
==============================================================================
--- incubator/rave/site/trunk/content/rave/documentation/index.mdtext (original)
+++ incubator/rave/site/trunk/content/rave/documentation/index.mdtext Fri Jan  6 14:27:44 2012
@@ -38,6 +38,7 @@ Notice:    Licensed to the Apache Softwa
   - [Use Rave as OAuth consumer (OpenSocial)](oauth-consumer.html)
   - [Customize the look and feel](custom-gui.html)
   - [Translate the portal](translate-portal.html)
+  - [Enable CAPTCHA security for new account creation](captcha-enabling.html)
   
 ## Portal administration
   - [Portal admin interface](admin-interface.html)