# Plugin Settings
You may override the default plugin settings by creating a /config/saml-sp.php
file.
View the settings you can override in your project at /vendor/flipboxfactory/saml-sp/src/models/Settings.php
. Each setting has a description of what it does and how to customize it.
# EntityID
Currently you can edit the EntityID system wide a couple ways. Note that the value can be an environmental variable so that might be something to consider.
# 1. Add a config file in config/saml-sp.php
.
This location lives right next to the general.php
. Below is an example file contents.
return [
'entityId' => 'https://my-entity-id',
];
# 2. Edit from the admin (Goto the plugin in craft, then click on the "Settings" menu item under the plugins sub nav).
Set the Entity ID there which will save it to the db
# Group Configuration/Group Assignment
# Group Attribute Name/Group Attribute Mapping
Many IdPs will send groups as an attribute within the SAML Response. When configured, the plugin use that attribute to
assign the user to the group properly. To achieve this, add a config/saml-sp.php
then use the
following configuration.
Example
return [
// change the value as needed
'groupAttributeNames' => [ 'groups' ]
];
Make sure the value matches the attribute name sent from the IdP.
# Auto-Create Groups Removed (version 2.3.0)
Due to the release of Craft CMS 3.5, the project config has become more prevalant. Therefore, we've decided
to remove the support for autoCreateGroups
in version 2.3.0. Production environments shouldn't be saving user
groups when following the project config workflow. This should be done at the lower level environments.
Please use an event as shown below.
# Managing Permissions
Managing permissions ** is not supported ** automatically. There are a few options on how to manually manage permissions:
- Create the groups before implementing the plugin. Make sure you know all of the groups needed to assign the users properly.
- Use an event! See the EVENT_AFTER_RESPONSE_TO_USER example.