Open-Xchange servlet for external login masks: Difference between revisions

From Open-Xchange
(Redirected page to OXSessionFormLogin)
 
(29 intermediate revisions by 5 users not shown)
Line 1: Line 1:
= Open-Xchange servlet for external login masks  =
#REDIRECT [[OXSessionFormLogin]]
 
== 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
 
=== Example ===
With GET enabled and above configuration, this link will directly login the user
"example" with password "test" on the Open-Xchange server "oxserver":
http://oxserver/servlet/easylogin?login=example&password=test

Latest revision as of 06:18, 18 July 2013

Redirect to: