Difference between revisions of "Open-Xchange servlet for external login masks"

(TODO)
Line 1: Line 1:
= TODO =
+
= Open-Xchange servlet for external login masks  =
 +
 
 +
== who should read this document ==
 +
This description is ment for web developers who would lile to create a login mask for the Open-Xchange server which also can be on an external server (not directly located on the Open-Xchange machines) or administrators who install and configure Open-Xchange.
 +
 
 +
== Description ==
 +
The package open-xchange-easylogin provides a servlet which expects a user name and password via GET or POST. For security reasons, GET is disabled by default and can be turned on via configuration.
 +
 
 +
=== Installation ===
 +
The package open-xchange-easylogin, available in the Open-Xchange community version, needs to be installed using the os package maintaining tools (e.g. dpkg, rpm). After installation, the groupware process has to be restarted:
 +
/etc/init.d/open-xchange restart
 +
 
 +
=== Configuration ===
 +
Configuratino file is:
 +
/opt/open-xchange/etc/groupware/easylogin.properties
 +
 
 +
following configuration options are available (the groupware must be restarted to make changes effective):
 +
# easylogin configuration field
 +
 +
# GET/POST variable name for the password
 +
com.openexchange.easylogin.passwordPara = password
 +
 +
# GET/POST variable name for the login name
 +
com.openexchange.easylogin.loginPara = login
 +
 +
# AJAX root path on the Open-Xchange server
 +
# do not change unless you know what you are doing
 +
com.openexchange.easylogin.AJAX_ROOT = /ajax
 +
 +
# the relative path to the Open-Xchange GUI
 +
com.openexchange.easylogin.OX_PATH_RELATIVE = ../
 +
 +
# enable GET for the servlet
 +
# possible parameters: true/false
 +
com.openexchange.easylogin.doGetEnabled = true

Revision as of 13:54, 30 March 2009

Open-Xchange servlet for external login masks

who should read this document

This description is ment for web developers who would lile to create a login mask for the Open-Xchange server which also can be on an external server (not directly located on the Open-Xchange machines) or administrators who install and configure Open-Xchange.

Description

The package open-xchange-easylogin provides a servlet which expects a user name and password via GET or POST. For security reasons, GET is disabled by default and can be turned on via configuration.

Installation

The package open-xchange-easylogin, available in the Open-Xchange community version, needs to be installed using the os package maintaining tools (e.g. dpkg, rpm). After installation, the groupware process has to be restarted:

/etc/init.d/open-xchange restart

Configuration

Configuratino file is:

/opt/open-xchange/etc/groupware/easylogin.properties

following configuration options are available (the groupware must be restarted to make changes effective):

# easylogin configuration field

# GET/POST variable name for the password
com.openexchange.easylogin.passwordPara = password 

# GET/POST variable name for the login name
com.openexchange.easylogin.loginPara = login 

# AJAX root path on the Open-Xchange server 
# do not change unless you know what you are doing
com.openexchange.easylogin.AJAX_ROOT = /ajax

# the relative path to the Open-Xchange GUI
com.openexchange.easylogin.OX_PATH_RELATIVE = ../

# enable GET for the servlet 
# possible parameters: true/false
com.openexchange.easylogin.doGetEnabled = true