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.

Portal 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 Apache 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 Apache 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 Apache Rave
Use `mvn clean install` as usual.

 
[1]: http://www.google.com/recaptcha/whyrecaptcha