# vBSSO

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

### Description

Provides universal Single Sign-On feature so that WordPress can use the vBulletin user database to manage authentication and user profile data.
The system has two components. First, there’s a vBulletin plugin that creates an interface for authenticating, controlling access, and managing user profile data. The second component is plugins for other platforms (like DokuWiki) that teach it to talk to vBulletin and exchange data.

Support is available at https://www.vbsso.com only.

This plugin is provided as is. Support and additional customizations are available at an hourly rate.
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

### Compatibility

| Product | PHP version  | Platform |
| ------- | --- | --- |
| vBSSO Dokuwiki 1.1.0 | 5.3, 5.4.45, 5.6.30, 7.0.19 | DokuWiki 2012 `Adora Belle`, DokuWiki 2013 `Weatherwax`, DokuWiki 2014 `Ponder Stibbons`, DokuWiki 2015 `Detritus`, DokuWiki 2016 `Elenor of Tsort`, DokuWiki 2017 `Frusterick Manners`|
| vBSSO Dokuwiki 1.0.0 | 5.2, 5.3 | DokuWiki 2012 `Adora Belle`, DokuWiki 2013 `Weatherwax`, DokuWiki 2014 `Ponder Stibbons` |

### Requirements

* Supported vBulletin versions: 4.0, 4.1 or 4.2.
* Supported PHP versions: 5.3, 5.4, 5.6, 7.0
* Installed PHP cURL, mCrypt extensions.
* Installed DokuWiki default auth plugin `authplain`.

### Install

Note please: It's best to put the site into Maintenance Mode first and take a backup, before you start making any other changes!

If your DokuWiki version lower then 2014-05-05 `Ponder Stibbons`:
1. Download DokuWiki vBSSO (Required).
2. Unzip and upload `vbsso` folder to the `/lib/plugins/` directory of your DokuWiki.

If your DokuWiki version is 2014-05-05 `Ponder Stibbons`:
1. Go to the `Admin` -> `Extension Manager` -> `Manual install`.
2. Upload the archive with extension.

### Upgrade

Note please: It's best to put the site into Maintenance Mode first and take a backup, before you start making any other changes!

1. Uninstall the old plugin installation (see Uninstall chapter).
2. Install the latest plugin version (see Install chapter).

### Uninstall

Note please: It's best to put the site into Maintenance Mode first and take a backup, before you start making any other changes!

1. Go to the `Admin` -> `Manage Plugins`.
2. Press `delete` or `uninstall` infront of `vBSSO`.

### Configuration

CONFIGURATION, CASE 1

1. Log in to your DokuWiki as administrator.
2. Navigate to `Admin` -> `vBSSO Settings`.
3. Modify your default Platform Shared Key by setting it to more secure unreadable phrase to encrypt exchanged data.
4. Save Changes.

CONFIGURATION, CASE 2

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 link and Shared Key field from WordPress installation to vBulletin.
5. Click on Connect button to connect your new platform.
6. Back to DokuWiki vBSSO Settings page and verify that API Connections fields are filled out.