SAML configuration
Admin Console: People > Settings > Single Sign On > SAML
Understanding SSO with
SAML
CAUTION:
Before you configure SSO, make sure you have a migration strategy for any existing Jive users. Implementing SSO without migrating your users to your new authentication provider will orphan existing user accounts, so users can't access their community content.
You can use the SAML settings dialog to set up single sign-on with an SAML identity provider,
or to enable, disable, or tweak a configured SAML SSO configuration.
Setting Up the IdP Connection
To begin setting up
the connection between Jive and your identity provider, use the following steps:
- Enter the metadata URL for your SAML provider and click Load. (If
you don't have a metadata URL, you can click Edit Metadata to paste
in the XML containing the connection metadata.)
- Optionally, edit the metadata if it contains any non-conforming code and click
Save Settings to load it.
- Map the user attributes in the Jive profile to your IdP's attributes. For more
information about this topic, see User Attribute Mapping. Note that importing or saving your metadata
populates the General tab with a list of attributes from your IdP, so you can use it as a
reference when you specify the attributes you want to map.
- If you want to assign users to groups by passing a special group attribute from your IdP
to Jive, select Group Mapping Enabled.
- Click Save Settings.
- Go to your Jive instance URL and append /saml/metadata to the end. The browser will display the required SP metadata for configuring your IdP. Use this information to complete the configuration on your end.
User Attribute Mapping
User Attribute Mapping
is used to identify fields in the Jive profile that you plan to populate from the IdP profile
by synchronizing them on login. To map a field, specify the IdP attribute used to identify it
in the text box and select the
Federated check box. Any fields you
don't map will be user-configurable in the Jive profile settings. (A field that you specify,
but do not mark as federated, will be populated with the specified value but still
configurable.) By default, Jive uses the NameID property as the key unique identifier for a
user. You can select
Override Subject NameID for Username and specify a
different attribute if you want to use a different key identifier.
Group Mapping
You can assign users to security groups automatically by
passing a special group attribute from the IdP to Jive. Select Group Mapping
Enabled to enable this functionality and provide the group mapping attribute.
The group mapping attribute will be used to get security group names from each assertion. If
the corresponding groups with these names don't exist, they will be created when you
synchronize, and users will be added to these groups.
Advanced Settings
The following settings on the Advanced tab control some less commonly used SSO configuration.
- Debug Mode
- Enable to provide detailed logging for troubleshooting authentication problems. You
should disable this setting in production.
- Sync user profile on login
- Enable to update users based on the remote user profile each time they log in. This
setting is enabled by default and should not be disabled unless you seeded the Jive
community with users before enabling SSO.
- Credential Store Enabled
- Enable to persist storage of login information during a session. You should enable
this setting if you want to implement single signoff.
- Single Sign Off Enabled
- Enable to allow a unified signoff, so users log off all service providers when
they log out of Jive.
- Logout URL
- Specifies the URL of the page where users arrive after logging off.
- Response Skew
- Specifies the maximum permitted time between Jive's request and the IdP
response.