Prerequisites
Before configuring role mappings, you need:- An active SAML SSO connection (configured by the Strada team)
- A SAML attribute in your IdP that sends group or role information
Configuring Your IdP
To use role mapping, your IdP must include a group or role attribute in the SAML assertion. This attribute tells Strada which groups the authenticating user belongs to.Attribute Mapping
Add a Group Attribute Statement in your IdP’s SAML application configuration. The attribute name must be set tostradaRole.
The exact steps to add a group attribute vary by identity provider. See the provider-specific examples
below.
Okta
- Open your Strada SAML app in the Okta Admin Console
- Go to General > SAML Settings > Edit
- In the Group Attribute Statements section, add:
This sends all of the user’s Okta groups in the SAML assertion. You can use a more specific filter (e.g.,
Starts with Strada) to limit which groups are sent.
OneLogin
- Open your Strada SAML app in the OneLogin Admin Portal
- Go to Parameters
- Click Add Parameter (or the + icon)
- Set the Field name to
stradaRole - Check Include in SAML assertion
- Set the Value to the user’s role or group field (e.g.,
User Rolesor a custom field) - Save
Microsoft Entra ID
- Open your Strada Enterprise Application in the Azure Portal
- Go to Single sign-on > Attributes & Claims
- Click Add a group claim
- Select which groups to include (e.g., Groups assigned to the application)
- Under Advanced options, check Customize the name of the group claim
- Set the Name to
stradaRole - Save
Other Providers
For any SAML 2.0 compatible IdP, add an attribute statement that:- Has the name
stradaRole - Returns the user’s group or role name as a string value
- Is included in the SAML response sent to Strada
Mapping Groups to Roles
Once your IdP is sending thestradaRole attribute:
- Navigate to Settings > Organization > Provisioning
- Select the SSO tab
- Under SAML Group-to-Role Mapping, click Add Mapping
- Enter the IdP group/role name exactly as it appears in your IdP (case-sensitive)
- Select the Strada role to assign
- Click Save Mappings