You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by ta...@apache.org on 2008/11/26 02:26:41 UTC
svn commit: r720696 - in /portals/jetspeed-2/portal/trunk/src/site: site.xml
xdoc/applications/ xdoc/applications/index.xml
xdoc/applications/j2-admin.xml xdoc/applications/jsaudit.xml
xdoc/applications/mfa.xml
Author: taylor
Date: Tue Nov 25 17:26:40 2008
New Revision: 720696
URL: http://svn.apache.org/viewvc?rev=720696&view=rev
Log:
docs for jetspeed apps
Added:
portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/
portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/index.xml
portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/j2-admin.xml
portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/jsaudit.xml
portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/mfa.xml
Modified:
portals/jetspeed-2/portal/trunk/src/site/site.xml
Modified: portals/jetspeed-2/portal/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/site.xml?rev=720696&r1=720695&r2=720696&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/site.xml (original)
+++ portals/jetspeed-2/portal/trunk/src/site/site.xml Tue Nov 25 17:26:40 2008
@@ -42,7 +42,7 @@
<menu name="Essentials">
<item name="Features" href="features.html" />
<item name="Getting Started" href="getting-started.html" />
- <item name="Jetspeed for Developers" href="developers.html" />
+ <item name="Jetspeed for Developers" href="developers.html" />
</menu>
<menu name="Building">
<item name="From Source with Maven-2" href="maven-2-build.html" />
@@ -61,6 +61,7 @@
<item name="Jetspeed Tutorial - Maven-2 Custom Build" href="http://portals.apache.org/tutorials/jetspeed-2/" />
<item name="Jetspeed Tutorial - Ant Custom Build (incomplete)" href="http://portals.apache.org/tutorials/jetspeed-2-ant/" />
<item name="Jetspeed-2 API" href="http://portals.apache.org/jetspeed-2/apidocs/index.html" />
+ <item name="Jetspeed Applications" href="applications/index.html"/>
</menu>
<menu name="About Jetspeed-2">
<item name="For Jetspeed-1 Users" href="j1-users.html" />
Added: portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/index.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/index.xml?rev=720696&view=auto
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/index.xml (added)
+++ portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/index.xml Tue Nov 25 17:26:40 2008
@@ -0,0 +1,54 @@
+<?xml version="1.0"?>
+<!--
+ 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.
+-->
+<document>
+ <properties>
+ <title>Jetspeed Portlet Applications</title>
+ <subtitle>Welcome to Jetspeed Portlet Applications</subtitle>
+ <authors>
+ <person name="David Sean Taylor" email="taylor@apache.org" />
+ </authors>
+ </properties>
+ <body>
+ <section name="Overview of the Jetspeed Portlet Applications">
+ <p>Jetspeed is just a standalone portal server. Administration of the server is provided in a standard way: using standardized Java portlet applications.
+ Since these portlet applications require specific knowledge of the Jetspeed server in order to manage it, the applications are distributed from Jetspeed, and not from Apache Portals Applications (<a href='http://portals.apache.org/applications/'>APA</a>).
+ These applications make use of the Jetspeed API to manage the portal. For example, the administrative portlets manage security, users, portlet applications and more.
+ </p>
+ <subsection name='List of Applications'>
+<table>
+<tr>
+<th>Application</th>
+<th>Description</th>
+</tr>
+<tr>
+<td><a href="j2-admin.html">j2-admin</a></td>
+<td><b>Jetspeed Administration</b> - Manages the security and administration of a Jetspeed Portal</td>
+</tr>
+<tr>
+<td><a href="mfa.html">MFA</a></td>
+<td><b>Multifaceted Authentication</b> - Multi-faceted login portlet functionality including captcha and personal questions</td>
+</tr>
+<tr>
+<td><a href="jsaudit.html">jsaudit</a></td>
+<td><b>Audit Reports</b> - Audit reporting on the administrative usage of the portal</td>
+</tr>
+</table>
+</subsection>
+</section>
+</body>
+</document>
Added: portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/j2-admin.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/j2-admin.xml?rev=720696&view=auto
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/j2-admin.xml (added)
+++ portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/j2-admin.xml Tue Nov 25 17:26:40 2008
@@ -0,0 +1,193 @@
+<?xml version="1.0"?>
+<!--
+ 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.
+-->
+<document>
+ <properties>
+ <title>Jetspeed Administration Portlets</title>
+ <subtitle>Welcome to Jetspeed Administration and Security Portlet App</subtitle>
+ <authors>
+ <person name="David Sean Taylor" email="taylor@apache.org" />
+ </authors>
+ </properties>
+ <body>
+<section name="Catalog of Jetspeed Administrative Portlets">
+<p>This portlet application provides a rich set of portlets for administering and security a Jetspeed Portal.</p>
+<table>
+<tr>
+<th>Portlet</th>
+<th>Description</th>
+</tr>
+<tr>
+<td>AboutJetspeed</td>
+<td>Introductory information about Jetspeed for getting started with links to documentation.</td>
+</tr>
+<tr>
+<td>CategoryPortletSelector</td>
+<td>Portlet Selector for adding portlets to your page. Categories classify portlets by indexed keywords to help users find portlets.</td>
+</tr>
+<tr>
+<td>ChangePasswordPortlet</td>
+<td>Portlet for changing the password of the current, logged on user.</td>
+</tr>
+<tr>
+<td>ContentViewer</td>
+<td>Content Viewer displays the content of an HTML, PDF, or other file types from any where on the file system, or relative to the portlet application.</td>
+</tr>
+<tr>
+<td>CustomConfigModePortlet</td>
+<td>Provides common custom config mode edit portlet.</td>
+</tr>
+<tr>
+<td>DateTimePortlet</td>
+<td>Display the date and time in a simple string format.</td>
+</tr>
+<tr>
+<td>ForgottenPasswordPortlet</td>
+<td>Provides users with the ability to request a new password to be sent to their email address.</td>
+</tr>
+<tr>
+<td>ForgottenPasswordReturnPortlet</td>
+<td>Provides users with the ability to click and update their password automatically after completing the user registration process.</td>
+</tr>
+<tr>
+<td>GroupBrowser</td>
+<td>The Group Browser displays a list of groups managed in this portal. From here you can select Groups for editing. Place this portlet on the same page as the Group Details portlet.</td>
+</tr>
+<tr>
+<td>GroupDetailsPortlet</td>
+<td>The Group Details portlet displays a groups details in a tabbed view. From here you can add, edit, and delete Group information. Place this portlet on the same page as the Group Browser portlet.</td>
+</tr>
+<tr>
+<td>GroupChooser</td>
+<td>A Popup portlet for selecting a single group from a list of groups. Usually not placed on a page directly, but accessed by Jetspeed over the portlet pipeline in a popup window.</td>
+</tr>
+<tr>
+<td>JetspeedDeveloper</td>
+<td>Introductory information about developing with Jetspeed for getting started with links to development documentation.</td>
+</tr>
+<tr>
+<td>LocaleSelector</td>
+<td>Locale Selector is a portlet to select your preferred locale (language).</td>
+</tr>
+<tr>
+<td>LoginPortlet</td>
+<td>Logs a user on to the Jetspeed portal by entering a username and password. Authenticates using full Jetspeed Active Authentication.</td>
+</tr>
+<tr>
+<td>LoginPortletForXHTMLBasic</td>
+<td>Login with Active Authentication (XHTML Basic)</td>
+</tr>
+<tr>
+<td>PortalLoginPortlet</td>
+<td>Logs a user on to the Jetspeed portal by entering a username and password. Authentication bypasses JAAS and active authentication.</td>
+</tr>
+<tr>
+<td>PortalSchemaExporter</td>
+<td>The Portal Data Importer, import and export the jetspeed data from jetspeed schema. From here you import/export the users,group,roles and jetspeed objects</td>
+</tr>
+<tr>
+<td>PortalSiteManager</td>
+<td>The Portal Site Manager displays a hierarchical view of the entire portal site. From here you can add, edit, and delete folders, links, and pages.</td>
+</tr>
+<tr>
+<td>PortletApplicationLifecyleManager</td>
+<td>The PALM (Portlet Application Lifecycle Manager) manages the lifecyle of portlet applications. From here you can start, stop, undeploy and delete portlet applications</td>
+</tr>
+<tr>
+<td>PortletApplicationBrowser</td>
+<td>The PAM (Portlet Application Manager) Portlet Application Browser displays a list of portlet applications deployed to this portal. From here you can add, edit, and delete portlet applications. Place on same page as Portlet Application Details</td>
+</tr>
+<tr>
+<td>PortletApplicationDetail</td>
+<td>The PAM (Portlet Application Manager) Portlet Application Detail displays a specific portlet application deployed to this portal. From here you can add, edit, and delete portlet applications. Place on same page as Portlet Application Browser</td>
+</tr>
+<tr>
+<td>PortletTracking</td>
+<td>Portlet Tracking Manager to track the state of portlets that are not being responsive. Allows you to disable the rendering of specific portlets.</td>
+</tr>
+<tr>
+<td>ProfilerAdmin</td>
+<td>The Profiler Admin portlet is used to administer profiling rules. You can create new rules, edit rules and delete rules and criterion.</td>
+</tr>
+<tr>
+<td>RoleBrowser</td>
+<td>The Role Browser displays a list of roles managed in this portal. From here you can select Roles for editing. Place this portlet on the same page as the Role Details portlet.</td>
+</tr>
+<tr>
+<td>RoleChooser</td>
+<td>A Popup portlet for selecting a single role from a list of roles. Usually not placed on a page directly, but accessed by Jetspeed over the portlet pipeline in a popup window.</td>
+</tr>
+<tr>
+<td>RoleDetailsPortlet</td>
+<td>The Role Details portlet displays a roles details in a tabbed view. From here you can add, edit, and delete Role information. Place this portlet on the same page as the Role Browser portlet.</td>
+</tr>
+<tr>
+<td>RoleMultiChooser</td>
+<td>A Popup portlet for selecting one or more roles from a list of roles. Usually not placed on a page directly, but accessed by Jetspeed over the portlet pipeline in a popup window.</td>
+</tr>
+<tr>
+<td>RPADPortlet</td>
+<td>Remote Portlet Application Deployer for Jetspeed. Deploy portlets from remote locations on the internet into this portal</td>
+</tr>
+<tr>
+<td>SecurityConstraintsPortlet</td>
+<td>Declartive Security Constraint editor. Manages PSML global security constraints to grant or deny access to pages and folders.</td>
+</tr>
+<tr>
+<td>SecurityPermissionsPortlet</td>
+<td>Policy Editor for managing the Jetspeed JAAS Security Policy. The policy is a standard Java security policy (JAAS), stored in a database. Portlet, page, and folder permissions are managed here.</td>
+</tr>
+<tr>
+<td>SSOBrowserPortlet</td>
+<td>SSO Sites Browser displays a list of all configured SSO sites in the portal. From here you can select SSO Sites for editing. Place this portlet on the same page as the SSO Details portlet.</td>
+</tr>
+<tr>
+<td>SSODetailsPortlet</td>
+<td>The SSO Site Details portlet edits the credentials and site location for a single SSO Site. Place this portlet on the same page as the SSO Browser portlet.</td>
+</tr>
+<tr>
+<td>StatisticsPortlet</td>
+<td>Provides statistics about portal access hits by page, portlet, and by user. Statistical results are sorted by highest hit rate.</td>
+</tr>
+<tr>
+<td>UserBrowserPortlet</td>
+<td>The User Browser displays a list of users managed in this portal. From here you can select users for editing. Place this portlet on the same page as the User Details portlet.</td>
+</tr>
+<tr>
+<td>UserDetailsPortlet</td>
+<td>The User Details portlet displays a users details in a tabbed view. From here you can add, edit, and delete User information. Place this portlet on the same page as the User Browser portlet.</td>
+</tr>
+<tr>
+<td>UserChooser</td>
+<td>A Popup portlet for selecting a single user from a list of users. Usually not placed on a page directly, but accessed by Jetspeed over the portlet pipeline in a popup window.</td>
+</tr>
+<tr>
+<td>UserMultiChooser</td>
+<td>A Popup portlet for selecting one or more users from a list of users. Usually not placed on a page directly, but accessed by Jetspeed over the portlet pipeline in a popup window.</td>
+</tr>
+<tr>
+<td>UserRegistrationPortlet</td>
+<td>Provides users with the ability register as a new user with the portal.</td>
+</tr>
+<tr>
+<td>WelcomeToJetspeed</td>
+<td>Information about the current release of Jetspeed.</td>
+</tr>
+</table>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/jsaudit.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/jsaudit.xml?rev=720696&view=auto
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/jsaudit.xml (added)
+++ portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/jsaudit.xml Tue Nov 25 17:26:40 2008
@@ -0,0 +1,85 @@
+<?xml version="1.0"?>
+<!--
+ 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.
+-->
+<document>
+ <properties>
+ <title>Jetspeed Auditing Reports</title>
+ <subtitle>Welcome to Jetspeed Auditing Reports App</subtitle>
+ <authors>
+ <person name="David Sean Taylor" email="taylor@apache.org" />
+ </authors>
+ </properties>
+ <body>
+<section name="Catalog of Jetspeed Auditing Reports">
+<p>This portlet application provides a set of report portlets for querying information gathering during administrative operations of the portal.</p>
+<table>
+<tr>
+<th>Portlet</th>
+<th>Description</th>
+</tr>
+<tr>
+<td>AdminActivityReport</td>
+<td></td>
+</tr>
+<tr>
+<td>AdminStatusReport</td>
+<td></td>
+</tr>
+<tr>
+<td>PasswordResetReport</td>
+<td></td>
+</tr>
+<tr>
+<td>SSOSystemSecurityReport</td>
+<td></td>
+</tr>
+<tr>
+<td>SSOSuccessLoginReport</td>
+<td></td>
+</tr>
+<tr>
+<td>SSOOptOutReport</td>
+<td></td>
+</tr>
+<tr>
+<td>SSOLockedUserReport</td>
+<td></td>
+</tr>
+<tr>
+<td>SSOFailedLoginReport</td>
+<td></td>
+</tr>
+<tr>
+<td>SSOUserStatusReport</td>
+<td></td>
+</tr>
+<tr>
+<td>SystemSecurityReport</td>
+<td></td>
+</tr>
+<tr>
+<td>UserCreationReport</td>
+<td></td>
+</tr>
+<tr>
+<td>UserDeletionReport</td>
+<td></td>
+</tr>
+</table>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/mfa.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/mfa.xml?rev=720696&view=auto
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/mfa.xml (added)
+++ portals/jetspeed-2/portal/trunk/src/site/xdoc/applications/mfa.xml Tue Nov 25 17:26:40 2008
@@ -0,0 +1,204 @@
+<?xml version="1.0"?>
+<!--
+ 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.
+-->
+<document>
+ <properties>
+ <title>Jetspeed MFA Portlet App</title>
+ <subtitle>Welcome to Jetspeed Portlet Application Multifaceted Authentication</subtitle>
+ <authors>
+ <person name="David Sean Taylor" email="taylor@apache.org" />
+ </authors>
+ </properties>
+ <body>
+ <section name="Using the Jetspeed MFA Portlet">
+ <p>This portlet application provides multi-faceted login portlet functionality including captcha and personal questions. Since this is a login portlet, it has minimal hooks to authenticate against Jetspeed. You should be able to easily adapt this portlet application to other portals by changing the authentication code.</p>
+ <subsection name='Usage with Jetspeed'>
+ <p>There is one portlet found in the portlet.xml: <b>MFALogin</b>. This portlet is configured in the portlet.xml with the following init parameters:</p>
+<table>
+<tr>
+<th>param name</th>
+<th>default value</th>
+<th>description</th>
+</tr>
+<tr>
+<td>cookieLifetime</td>
+<td>345600</td>
+<td>The lifetime of the stored cookie in seconds (4 days)</td>
+</tr>
+<tr>
+<td>maxNumberOfAuthenticationFailures</td>
+<td>5</td>
+<td>Maximum number of authentication failures before disabling a user</td>
+</tr>
+<tr>
+<td>randomQuestions</td>
+<td>What was the first and last name of our favorite teacher? In what city did you get married? ...</td>
+<td>A list of 24 personal questions which will be displayed to the user in random order separated by question marks (?)</td>
+</tr>
+</table>
+<p><b>IMPORTANT</b>The Jetspeed web.xml must be modified. The <i>LoginProxyServlet</i> servlet must have its <i>credentialsFromRequest</i> init param set to false:</p>
+<source><![CDATA[
+<servlet>
+ <servlet-name>LoginProxyServlet</servlet-name>
+ <servlet-class>org.apache.jetspeed.login.LoginProxyServlet</servlet-class>
+ <init-param>
+ <param-name>credentialsFromRequest</param-name>
+ <param-value>false</param-value>
+ </init-param>
+</servlet>
+]]></source>
+ </subsection>
+ <subsection name='Captcha'>
+<p>
+The following Captcha properties are configured in the mfa.properties found in the WEB-INF directory of your web application.
+</p>
+<h2>Property File</h2>
+<table border='1'>
+<tr>
+<th>Property</th>
+<th>Default Value</th>
+<th>Description</th>
+<tr>
+<td>captcha.directory</td>
+<td>/captchas</td>
+<td>The directory where all captchas will be stored when generated. For web applications, this directory should be a in a public viewable area.
+The directory name is relative to either the running program, or in the case of a web application, relative to the root of the web application</td>
+</tr>
+<tr>
+<td>captcha.effects.noise</td>
+<td>false</td>
+<td>Turn on the default noise generation for a capcha. Noise generation is not yet configurable to a fine grain but instead enables a set of general noise algorithms including
+drawing an XORed oval behind the text, and generating gray noise throughout the image.
+This feature is turned off by default and should not be used with an image background.</td>
+</tr>
+<tr>
+<td>captcha.image.background</td>
+<td>images/jetspeedlogo98.jpg</td>
+<td>Uses an image file as the background for the capcha image. The default provide is a company logo that has been run through a matte effect.</td>
+</tr>
+<tr>
+<td>captcha.image.background.use</td>
+<td>true</td>
+<td>Enable or disable using the background image defined in the captcha.image.background property.</td>
+</tr>
+<tr>
+<td>catcha.image.format</td>
+<td>.jpg</td>
+<td>The image format of the output captcha file. Known supported formats are .jpg and .png</td>
+</tr>
+<tr>
+<td>captcha.font.antialiasing</td>
+<td>true</td>
+<td>Enable or disable antialiasing. By enabling, you will generate a clearer image at the cost of slower rendering times.</td>
+</tr>
+<tr>
+<td>captcha.font.size</td>
+<td>36</td>
+<td>The point size of the font.</td>
+</tr>
+<tr>
+<td>captcha.font.style</td>
+<td>0</td>
+<td>The style of the font. Valid values are: PLAIN == 0, BOLD == 1, ITALIC == 2, BOLD_ITALIC == 3</td>
+</tr>
+<tr>
+<td>captcha.font.names</td>
+<td>Times</td>
+<td>A comma-separated list of font names. Make sure your server supports all listed fonted. When more than one font listed, fonts will be randomized.</td>
+</tr>
+<tr>
+<td>captcha.scanrate.seconds</td>
+<td>300</td>
+<td>Configures the cleanup thread for removal of captchas images. The cleanup thread will run by default every 300 seconds.</td>
+</tr>
+<tr>
+<td>captcha.timetolive.seconds</td>
+<td>120</td>
+<td>Configures the lifetime of a captcha image. Default is 120 seconds before it is deleted.</td>
+</tr>
+<tr>
+<td>captcha.text.maxlength</td>
+<td>8</td>
+<td>The maximum number of characters generated for the captcha string. Randomly used with captcha.text.minlength to vary the size of the captcha string.</td>
+</tr>
+<tr>
+<td>captcha.text.margin.left</td>
+<td>2</td>
+<td>The left-side margin where to start drawing the captcha string in in a device-independent coordinates.</td>
+</tr>
+<tr>
+<td>captcha.text.margin.bottom</td>
+<td>10</td>
+<td>The bottom margin where to start drawing the captcha string in in a device-independent coordinates.</td>
+</tr>
+<tr>
+<td>captcha.text.minlength</td>
+<td>6</td>
+<td>The minimum number of characters generated for the captcha string. Randomly used with captcha.text.maxlength to vary the size of the captcha string.</td>
+</tr>
+<tr>
+<td>captcha.text.rise.range</td>
+<td>30</td>
+<td>The rise from the bottom margin where to start drawing the captcha string. Setting to zero turns off the rising feature.
+If a positive number is used, the rise will randomly vary between the bottom margin and maximum rise value.</td>
+</tr>
+<tr>
+<td>captcha.text.rotation</td>
+<td>10</td>
+<td>Sets the rotation (vertical alignment variance) of a glyph to control this. The value is in radians.
+Value should be a positive number or zero. For example, setting to 35, will rotate the glyph randomly between -35 and 35 radians.
+Setting this value to 0 will turn off rotation.
+</td>
+</tr>
+<tr>
+<td>captcha.text.shear</td>
+<td>0</td>
+<td>Shearing slides one edge of an image along the X or Y axis, creating a parallelogram.
+The default value is 0, turning off all shearing effects. Shearing effects can make it more difficult for non-human readers to read the image.
+Shear values are specified in radians, with values closer to 1.0 creating a more drastic shearing effect.</td>
+</tr>
+<tr>
+<td>captcha.text.spacing</td>
+<td>2</td>
+<td>The space between captcha characters in device-independent coordinates. 0 is a valid value, but can make it difficult to read glyphes when combined with rotations.</td>
+</tr>
+<tr>
+<td>captcha.timestamp</td>
+<td>true</td>
+<td>Boolean value to enable printing a timestamp at the bottom of the captcha image in a small monospaced font.</td>
+</tr>
+<tr>
+<td>captcha.timestamp.24hr</td>
+<td>true</td>
+<td>Boolean value set to true when using 24 hour clock on timestamp, otherwise 12 hour clock.</td>
+</tr>
+<tr>
+<td>captcha.timestamp.tz</td>
+<td>America/New_York</td>
+<td>The Time Zone ID (TZID). The timestamp will be displayed for this timezone. You can also use timezone abbreviations such as EDT (Eastern Daylight Time).</td>
+</tr>
+<td>captcha.timestamp.font.size</td>
+<td>8</td>
+<td>The font size of the timestamp.</td>
+</tr>
+
+</table>
+
+ </subsection>
+ </section>
+ </body>
+</document>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org