=== JaSSO ===
Joomla Single Sign-On for Kayako V4
WARNING: This project is still in development and is currently not ready for production use. Please install at your own risk.
Once placed within the Kayako script directory, this creates an authorisation script which will allow a single sign-on between Kayako and Joomla. While Kayako's LoginShare already has the ability for one-way addition (from Joomla to Kayako in our case), this extends the LoginShare functionality by providing the second direction (from Kayako to Joomla) and synchronisation between the two. Additionally, this provides a wrapper script which will automatically log a user into Kayako when the user visits the Kayako site and is logged into Joomla (to minimise the frequency of a second login) by sharing the session information between Joomla and Kayako. All of this is accomplished without editing core files, thereby maintaining their independence and integrity.
Requires Joomla 1.6 or greater.
== Long and Boring Details == JaSSO covers the following situations: A. User can log into Joomla with (Joomla) username (Standard Joomla login) [1] B. User can log into Joomla with (Joomla) email (JaSSO-Auth plugin for Joomla) [1] C. User can log into Joomla with (Kayako) email (JaSSO-Auth plugin for Joomla) [1], [4], [5] D. User can log into Kayako with (Joomla) username (JaSSO LoginShare) [2], [3] E. User can log into Kayako with (Joomla) email (JaSSO-Auth plugin for Joomla) [2], [3], [5] F. User can log into Kayako with (Kayako) email (JaSSO LoginShare) [2], [4], [5] G. User can update information in Joomla [5] H. User can update information in Kayako [5]
Notes: [1] JaSSO-User plugin will attempt to log user into Kayako as well [2] JaSSO Kayako hook will attempt to log user into Joomla as well [3] Kayako creates a user in its database from the Joomla information (standard LoginShare action) [4] JaSSO-Auth creates user in Joomla from the Kayako information (Joomla username will be primary email address) [5] JaSSO-User will match email and (original) password first before modifying user or adding user
== Installation ==
- Edit /jasso/joomla.php and set JPATH_BASE to your Joomla installation (e.g. /home/USER/public_html/joomla/)
- Upload the /jasso/ and /__swift/ directories to your Kayako root directory (e.g. /home/USER/public_html/kayako/)
- Set up Kayako to use http://example.com/kayako/jasso/auth.php for the LoginShare URL
- Optionally, set up the Staff LoginShare to use http://example.com/kayako/jasso/auth.php?site=staff
- Optionally, install the Joomla plugins to keep Kayako user data in sync with Joomla's (options are available in the Joomla admin area)
== Changelog ==
= 0.8.7 =
- Second beta release
- Login through Kayako works and syncs users in Joomla and Kayako
- Added authentication plugin for Joomla to allow logins by email address
= 0.8.5 =
- First beta release
- Autologin hook into Kayako
- Added Community Builder
= 0.8.0 =
- Public alpha release
- Basic Joomla authentication