VBSSO

Provides universal Secure Single Sign-On between vBulletin and different popular platforms like MediaWiki.

= Compatibility =

MediaWiki 1.19.x - 1.25.x. vBulletin 4.0, 4.1, 4.2.

= About =

Think about it: how many accounts do you have out there on the internet? 10? 20? 50? Seriously? Can you imagine trying to remember dozens of passwords? Secure? Yes. Easy? No way.

Luckily there is a way out of this awkward situation. It is using the SSO technology.

So, what what is vBSSO?

vBSSO is a vBulletin plugin that helps you connect to different software platforms like content management systems, blogs, and online stores using a secure Single Sign-On (or SSO). It gives you an opportunity to access control of multiple related, but independent software systems. With this property a user logs in once and gains access to all systems without being prompted to log in again at each of them. And conversely, vB Single Sign-Off is the property whereby a single action of signing out terminates access to multiple software systems.

The vBSSO system has two components:

✓First, there’s a vBulletin plugin. vBulletin platform acts as a Master platform and creates an interface for authenticating, controlling access, and managing user profile data.

✓The second component is plugin for other platform (or Slave platform - like WordPress, Prestashop, Magento etc.) that teach it to talk to vBulletin and exchange data.

When users attempt to access a Slave platform, the vBSSO plugin redirects the user to the Master platform, where the user signs in. After successful authentication the web browser redirects back to the requested web application, and the user can access the application or web content

When an already authenticated user accesses another web application, the vBSSO on the Slave platform retrieves the user's validated credentials, thus eliminating any need for the user to sign on again.

The vBSSO is multifaceted plugin and allows you to connect as many accounts and platforms as you have - allows control of 1 account across multiple platforms.

Plugin doesn't share any user related information with any third party side. It strongly synchronizes the information between your own platforms connected personally to your vBulletin instance.

Plugin doesn't revert already sync data back to its original state if you decide to disable plugin later.

More details are available at https://www.vbsso.com/product-vbsso-connect-mediawiki-1-x

= Installation =

1. Download MediaWiki vBSSO.

2. Unzip and upload everything to `/extensions/` directory of your MediaWiki installation.

3. Open `LocalSettings.php` file in the root of MediaWiki installation and add `require_once( "$IP/extensions/vbsso/vbsso.php" );`.

4. Log in to MediaWiki as administrator, navigate to "Special pages > vBSSO" or "Toobox > vBSSO" to configure vBSSO.

5. Make sure that *.conf files are writable.

= Uninstallation =

1. Open `LocalSettings.php` file in the root of MediaWiki installation and remove `require_once( "$IP/extensions/vbsso/vbsso.php" );`

2. [Optional] Remove /extensions/vbsso` directory.

= Configuration =

1. Log in to your vBulletin control panel as administrator.

2. Navigate to `vBSSO` section.

3. Expand section and click on the `Connect Platforms` link.

4. Copy `Platform Url` and `Shared Key` fields from MediaWiki installation to vBulletin (you can find them in `Special pages -> vBSSO`).

5. Click on `Connect` button to connect your new platform.

More details are available at http://www.vbsso.com/

= Changelog =

= 1.0.2 =
 * Added Mediawiki 1.23.x support.
 * Fixed "Usergroups Associations" section if platform is disconnected.
 * Fixed "Login Through vBulletin Page" option.
 * Enhancements and bugs fixes.
 * [Updated November 6, 2014]

= 1.0.1 =
 * Added Mediawiki 1.22.x support.
 * Implemented editing user credentials.
 * Implemented Roles managing (usergroups sync).
 * Implemented vBSSO Authorization without redirecting to vBulletin.
 * Fixed Register issue on MediaWiki 1.22.x
 * Added menu item into Toolbox.
 * Enhancements and bugs fixes.
 * [Updated June 10, 2014]

= 1.0 =
 * Initial version released.
 * [Released December 3, 2012]

Have fun!