Installation / Upgrading

Option 1: Composer

Composer is a simple, straight forward installation. Simply run the following command from your project root:

composer require flipboxfactory/saml-sp

Option 2: Plugin Store

Within your Craft CMS project admin panel, navigate to the 'Plugin Store' and search for SAML SSO Service Provider. Installation is a button click away.

Once the plugin is installed, head over to configure the plugin.

Upgrading to 2.0

There are a lot of breaking changes in 2.0. Upgrading is seamless if there is not any custom code that hooks into the SAML SP plugin.

When Changes are Needed

You will need to refactor some of the code if you are doing any of the following:

1. Hooking into the plugin with Craft/Yii2 Events. See a list of the events.
2. Are using callables/anonymous functions with the responseAttributeMap config within config/saml-sp.php.
3. Have any references to lightsaml/lightsaml (opens new window) package. We have switch from using this package to using simplesamlphp/saml2 (opens new window)

TIP

Search for LightSaml within your project to find items that need to be refactored.

Be Diligent with this Upgrade!

1. Backup the production database
2. Test the upgrade on a dev instance
3. Test Login/SSO and Logout/SLO (if logout is used)

Submit an Issue (opens new window) or Contact us (opens new window) if you are running into any problems.