Single SignOn and SCIM Platform Setup

Single SignOn and SCIM Platform Setup

SecureFlag supports both SAML 2.0. SCIM 2.0 is also supported for the auto-provisioning of users and teams. Work with your Customer Success Manager to ensure the SSO configuration's correctness before diving into the training program. This guide will walk you through following Platform setup aspects:
  1. SAML Single Sign-On (SSO)
  2. SCIM 2.0 provisioning

SAML Single Sign-On (SSO)

  1. Navigate to the Management portal and select the Orgs tab.

  2. Click on Details to view organization details.

  3. Scroll down to find the Single Sign-On (SSO) section.

  4. Click on Single Sign-On & User Provisioning.



  5. A modal window will appear to set up SSO.
    1. Download SecureFlag’s Service Provider (SP) metadata file and install it on your Identity Management platform. 

    2. Once the app has been installed, download the IDP metadata file from your Identity Management platform. Click on Choose file, select the IDP metadata XML file, and upload it to the platform by clicking on Upload IDP Metadata.

    3. Observe that the fields will be automatically populated after a few seconds.

    4. Click on Save to save the SSO settings.

      5. Notes
      Note: This will not affect users who are on password-based authentication.
  6. Test/verify SSO authentication before enabling it for your entire user base:
    1. Do this by activating Single Sign-On (SSO) for a single user to test that everything is working correctly.

    2. Proceed to the Users tab, access the details of the required user by clicking on the corresponding Details button, and select the Edit option on the top-right corner of the user's profile page.

    3. A modal window will pop-up; from within the window, toggle the Single Sign-On button to Enabled.

    4. Then click on Update User.



    5. Inform the user that their profile has been updated and ask them to log in to the platform. When they do, they will be redirected to the SSO authentication page and authenticated through SSO. Once authenticated, they will be able to successfully log in to the platform.

  7. Once SSO has been verified, head over back to the Orgs Tab and click on Enable for all users under the Single Sign-On & User Provisioning section to enable SSO for all users.




SCIM 2.0 Provisioning

SecureFlag supports the SCIM 2.0 protocol for auto provisioning and deprovisioning users and teams. Work with your Customer Success Manager to ensure the SSO integration's correctness before diving into the SCIM configuration.


Alert
IMPORTANT!!!

SCIM integration must be tested before deployment to all accounts.

To test, create a small group of 1-2 accounts to be provisioned to SecureFlag. Once your Customer Success Manager confirms the integration, you may proceed to onboard the rest of the users.

If you are the integration engineer, request an email confirmation from a SecureFlag customer success engineer before pushing a group for testing or onboarding for the first time. You can reach them at success@secureflag.com.

Pushing to a large group of users may result in all accounts within the group receiving an email invite before the onboarding date, which will affect the program.

  1. To use SCIM 2.0 provisioning for your organisation, ensure that Single Sign-On has already been enabled.

  2. Generate a SCIM token by clicking on the Generate button. A modal window will appear with the your token. Make sure you save it, you won't be able to view it again and you will have to generate a new one.

  3. Switch the SCIM toggle to Enabled to start provisioning your users with SCIM.

  4. Add the SCIM token to your Identity Management platform.

User Deactivation and Deletion Process

When a user is removed from a group or app assignment in your identity management platform (e.g., Okta, Azure, etc.), the identity management platform automatically marks the user as inactive in SecureFlag.

This is the default behavior of the identity management system and cannot be modified or customized. Inactive users continue to count toward your active license quota, and their data remains stored unless manually deleted.

To permanently remove inactive users, refer to the platform-specific guides linked below.

Platform-Specific SSO and SCIM Guides

SSO and SCIM are supported across various platforms, including Azure, Okta, and OneLogin.

Notes
Note: If you manage multiple Organizations on the platform, please contact your Customer Success Manager for guidance on Single Sign-On configuration.

Azure
OKTA
OneLogin
Azure

Azure SAML 2.0 – Custom App Integration

When enabling Single Sign-On (SSO), work with your organization’s Integrations Engineer to ensure a smooth onboarding process before commencing the training program.

SecureFlag supports SAML 2.0 or OAuth 2.0 / OIDC protocols.

For the auto-provisioning of users and teams, SecureFlag also supports SCIM 2.0.

This guide provides instructions for setting up Single Sign-On on Azure via SAML using the Create your own application functionality.

Supported features

  1. SP-initiated SSO
  2. IDP-initiated SSO
  3. SCIM (documentation available in a separate document)

Requirements

  1. The Azure Single Sign-On integration is only available for the Enterprise and Business plans.

  2. Users will need to be set up on the SecureFlag platform. Make sure that the users’ emails exactly match their Azure accounts.

  3. Complete the steps below to set everything up.

Configuration Steps

  1. Go to https://portal.azure.com/ , and navigate to the Microsoft Entra ID menu, then to Enterprise Applications.



  2. Click on New Application.



  3. Select Create your own application.



  4. Fill in the user-facing app name, then click add.



  5. The app is now created.
    1. You can optionally set a logo.
    2. Click on Properties, and upload a SecureFlag logo. You can download it here.
    3. Click Save to save your changes.



  6. Click Configure single sign-on and select SAML.



  7. Click Upload Metadata File. Select the Service Provider metadata that was obtained from the SecureFlag platform (Click here for instructions on how to get the Metadata file).



  8. The configuration details will be automatically imported. Click on Save.



  9. When configuring the SAML claims, use the user email as the Name identifier format. The user email will likely be configured under user.mail although Windows based organizations may have this configured under user.userprincipalname.

    Confirm this with your Integrations Engineer.



  10. Download the ‘Federation Metadata XML’ to upload to the SecureFlag platform (Click here for instructions on how to upload the Federation Metadata file).



  11. You need to assign users to the newly created and configured application.

    This can be done on an individual level, or with groups. By default when a group is configured on Azure, this will populate in SecureFlag as a Team.



    If you do not want to manage teams in SecureFlag via Azure Groups, you can disable this behavior by adjusting the Attribute mappings.

    In the attribute mapping settings, set this to No.

Configure your SSO on SecureFlag

Once you have the required Federation Metadata XML file from Azure, navigate to the SAML Setup menu on the SecureFlag platform and upload it there. Refer to this article for more info.

For additional support please contact support at: https://www.secureflag.com/support.html

SCIM 2.0 – Custom App Integration

SecureFlag supports the SCIM 2.0 protocol for auto-provisioning and deprovisioning users and teams. Before implementing the SCIM configuration, work with your CSM to ensure the SSO integration's correctness.

This following guide provides instructions for setting up provisioning using SCIM 2.0.

Supported features

  1. Create users
  2. Update user attributes
  3. Deactivate users
  4. Group push

Requirements

  1. Users will need to be set up on the SecureFlag platform. Make sure that the users’ emails match those of their Azure accounts.

  2. Complete the steps below to configure SCIM.

Alert
IMPORTANT!!!

SCIM integration must be tested before deployment to all accounts.

To test, create a small group of 1-2 accounts to be provisioned to SecureFlag. Once your Customer Success Manager confirms the integration, you may proceed to onboard the rest of the users.

If you are the integration engineer, request an email confirmation from a SecureFlag customer success engineer before pushing a group for testing or onboarding for the first time. You can reach them at success@secureflag.com.

Pushing to a large group of users may result in all accounts within the group receiving an email invite before the onboarding date, which will affect the program.

Configuration Steps

  1. , and navigate to Microsoft Entra ID in the menu to your left, then on Enterprise Applications.



  2. Browse to the SecureFlag application. Click on Provisioning, then click on Get Started.



  3. Enter the SCIM endpoint URL https://api.secureflag.com/rest/scim/v2 and the Secret Token (see this article to get token).

    Click Test Connection to verify the correct setup.



Notes
Note: When a user is deactivated on Azure, the user's status is set to "Inactive" on SecureFlag. An inactive user still counts against the total number of active licenses, and their data is retained in the platform.

To delete users, set up a workflow in Azure to issue a request to the SCIM's DELETE endpoint.

User Deactivation and Deletion Process

When a user is removed from a group or app assignment, Azure marks them as “Inactive” in SecureFlag.

If a user is deleted from the Directory, Azure first marks them as “Inactive” in SecureFlag and, after 30 days, automatically sends a delete request to remove them permanently. This is standard Azure behavior and cannot be customized or configured.

Inactive users still count against your active license quota, and their data is retained unless deleted.

To remove inactive users sooner, you can either:
  1. Manually delete them from the SecureFlag management interface, or
  2. Set up a custom Azure workflow that sends a DELETE request to the SecureFlag SCIM endpoint.

Delete SCIM API Endpoint



OKTA

OKTA SAML 2.0

When enabling Single Sign-On (SSO), work with your organization’s Integrations Engineer to ensure a smooth onboarding process before commencing the training program.

SecureFlag supports SAML 2.0 or OAuth 2.0 / OIDC protocols.

For the auto-provisioning of users and teams, SecureFlag also supports SCIM 2.0.

This guide provides instructions for setting up Single Sign-On on OKTA via SAML using the SecureFlag App availabe on the OKTA Marketplace.

Supported Features

  1. SP-initiated SSO
  2. IDP-initiated SSO
  3. SCIM

Requirements

  1. Users will need to be setup on the SecureFlag platform. Make sure that the users’ emails match those of their Okta accounts.

  2. Complete the steps below to set everything up.

Configuration Steps

  1. Install the SecureFlag app from the OKTA marketplace Linked here.

  2. In the Okta admin page, click on the SecureFlag application.

  3. In the General tab, ensure the application visibility is set up as follows.



  4. In the Sign On tab, click on Identity Provider Metadata. Upload Identity Provider Metadata to Secureflag. Navigate to the SAML Setup menu on the SecureFlag platform and upload it there. Refer to this article for more info.



  5. Follow the relevant Okta guide to assign the App to Users or Groups.

For additional support please contact support from here. 

SCIM 2.0

SecureFlag supports the SCIM 2.0 protocol for auto-provisioning and deprovisioning users and teams. Work with your CSM to ensure the SSO integration's correctness before diving into the SCIM configuration.

The following guide provides instructions for setting up provisioning.

Supported features

  1. Create users
  2. Update user attributes
  3. Deactivate users
  4. Group push

Requirements

  1. Users require an account on the SecureFlag platform. Make sure that the users’ emails match those of their Okta accounts.

  2. Complete the steps below to set everything up.

Alert
IMPORTANT!!!
SCIM integration must be tested before deployment to all accounts.

To test, create a small group of 1-2 accounts to be provisioned to SecureFlag. Once your Customer Success Manager confirms the integration, you may proceed to onboard the rest of the users.

If you are the integration engineer, request an email confirmation from a SecureFlag customer success engineer before pushing a group for testing or onboarding for the first time. You can reach them at success@secureflag.com.

Pushing to a large group of users may result in all accounts within the group receiving an email invite before the onboarding date, which will affect the program.

Configuration Steps

  1. From the Okta admin page, click on the SecureFlag application.

  2. Switch to the Provisioning tab.

  3. Click on Configure API Integration.



  4. Enter the Secret Token (see this article to get token). Then click on Test API Credentials. Ensure you receive the message SecureFlag was verified successfully!.



  5. Click on the To App tab. Click on Edit and enable Create Users, Update User Attributes, and Deactivate Users. Then click on Save.

    User Deactivation and Deletion Process

    When a user is removed from a group, app assignment, or the Directory, Okta marks them as “Inactive” in SecureFlag. This is standard Okta behavior and cannot be customized or configured.

    Inactive users still count toward your active license total, and their data remains stored on the platform.

    To permanently delete these users, you can either:
    1. Manually remove them through the SecureFlag management interface, or
    2. Use an automated workflow in Okta (details below).

    A prebuilt SecureFlag workflow for removing inactive users is available on the OKTA Marketplace.

Delete SCIM API Endpoint

To delete users, set up a workflow in Okta to issue a request to the SCIM’s DELETE endpoint, To do so, follow the below steps:
  1. Go to the Okta Workflow Console. This can be found under Workflow > Workflows console from the main Okta page.



  2. From the Connections page, click New Connection. Then, find SecureFlag.



  3. In the New Connection dialog, add a string to the Name textfield. This is useful when creating multiple connections to share with your team.



  4. Paste the SCIM token created in the prerequisites section into the SCIM Authentication Token field. Click Create.



  5. Now, you have access to the Remove User License card as part of the SecureFlag Connector. Below is an example workflow that removes the SecureFlag license of a user when their account is deactivated.



SecureFlag Okta User Delete Workflow Connector

Authorization

Generate a SCIM token using the instructions here. Then, create a connection as follows:

  1. From the Connections page, click New Connection.

  2. In the New Connection dialog, add a string to the Connection Nickname dialog. This is useful when creating multiple connections to share with your team.

  3. Paste the SCIM token created in the prerequisites section into the SCIM Authentication Token field.

  4. Click Create.

Cards - Remove SecureFlag License

Removes a SecureFlag license corresponding to the given user email. Returns nothing unless an error occurs.

Inputs:
Label
Definition
Type
Required
User Email
User Email of the SecureFlag license to remove
Text
Yes

Outputs:
Label
Definition
Type
Status Code
Status code for SecureFlag to debug issues if any are reported
Number

You can find the example flow in Delete SCIM API Endpoint section.

Changelog

v4 Initial release.

OneLogin

OneLogin SSO and SCIM Guide

  1. Login to the OneLogin Admin console.

  2. In the Applications tab, select Applications.



  3. Click Add App.



  4. Search SCIM Provisioner with SAML.



  5. Select SCIM Provisioner with SAML (SCIM v2 Enterprise, full SAML).

  6. Use the following images that can be downloaded from the SecureFlag website:
    1. Square Icon: https://secureflag.com/assets/img/logo_small.png 
    2. Rectangular Icon: https://www.secureflag.com/assets/img/images/secureflag-logo.png 
    3. Description: SecureFlag Secure Coding Training & Threat Modeling



  7. Click on Save.

  8. Once saved, the left menu will be populated with additional tabs.

  9. Click on Configuration (left side menu).



  10. Enter the following details (leave all other fields with the default value)
    1. Recipient: https://www.secureflag.com/saml.jsp 
    2. ACS (Consumer) URL Validator: ^https:\/\/www\.secureflag\.com\/saml\.jsp$
    3. ACS (Consumer) URL*: https://www.secureflag.com/saml.jsp 
    4. Login URL: https://www.secureflag.com/login.html 
    5. SAML not valid before: 3
    6. SAML not valid on or after: 3
    7. SAML initiator: OneLogin
    8. SAML nameID format: Email
    9. SAML sessionNotOnOrAfter: 1440

  11. Click on Save.

SCIM Configuration

  1. Click on Configuration, then enter:
    1. SCIM Base URL: https://api.secureflag.com/rest/scim/v2 
    2. SCIM Bearer Token: [Your generated SCIM token goes here]
    3. To generate your SCIM token on the SecureFlag Platform, check out section SCIM 2.0 Provisioning above.




  2. Click on Enable.

  3. Click on Save.

  4. Click on Parameters (left side menu).



  5. Change the value of scimusername to Email.

  6. Click on Provisioning (left side menu).



  7. Click on Enable Provisioning.

  8. Click on Save.

  9. Click on More Actions > Click on SAML Metadata.

  10. Install on the SecureFlag portal, more info on that here.


Just-in-Time (JIT) User Provisioning

This guide explains how to configure SecureFlag Single Sign-On to enable Just-in-Time (JIT) user provisioning.

With JIT provisioning enabled, a user can automatically create an account in SecureFlag upon their first successful authentication. SecureFlag redirects the user to the organization’s Identity Provider (IdP), and after validating both the authentication and the user’s access rights, creates the account.

NotesNote: Advanced User provisioning and lifecycle management can also be handled via SCIM. 

JIT Provisioning Use Cases
  1. SCIM is not available.
  2. The organization would like to grant access to all users but only create an account on SecureFlag the first the time the user authenticates.

To Enable JIT Provisioning
  1. Go to the Orgs tab.
  2. Click Details for your organization.
  3. In the Single Sign-On & User Provisioning panel, enable the JIT toggle.


NotesAuthorization Note: Ensure that users are assigned to the SecureFlag application in your IdP. Assignment can be done either directly to individual users or through group membership.

The sections below describe the JIT provisioning flow for SAML 2.0 and OAuth 2.0, along with setup details depending on your organization’s SSO configuration.

JIT Provisioning with SAML 2.0

When a user authenticates via SAML 2.0, authentication may be IdP-initiated (e.g. Identity Provider Dashboard) or SP-initiated (SecureFlag’s login page). 

IdP-Initiated Flow

  1. The user clicks the SecureFlag tile in their IdP dashboard.
  2. SecureFlag reads the SAML Issuer and matches it to one or more orgs associated with that IdP.
  3. When a valid SAML assertion is received, SecureFlag creates the account. The NameID attribute is used as the username/email.

Configuration Scenarios:
  1. Single org bound to the Issuer → no extra configuration.
  2. Multiple orgs with the same Issuer → include the sf_org claim to select the target org.
  3. Multiple orgs with different SAML configurations → no extra configuration needed.

SP-Initiated Flow

  1. The user visits the SecureFlag login page and enters their email.
  2. SecureFlag matches the domain portion of the email against:
    1. The main contact domain for the org (set by Customer Success), or 
    2. The org’s list of allowed SSO domains (set by Customer Success).
  3. When a valid SAML assertion is received, SecureFlag creates the account. The NameID attribute is used as the username/email.

Configuration Scenarios
  1. Single Organization → no extra configuration.
  2. Multiple Organizations with different, non-overlapping email domains → no extra configuration.
  3. Multiple Organizations with overlapping email domains:
    1. If orgs use the same SAML config → include the sf_org claim to select the org.
    2. If orgs use different SAML configs → only one Organization can have JIT enabled; if multiple are enabled, the first is selected by default.

SAML JIT Provisioning Required Attributes

SAML assertions must include first name and last name. SecureFlag recognizes several attribute names (case-insensitive):

Property
Recognized Attribute Name
First Name
FirstName, firstName, givenName, user.givenname, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
Last Name
LastName, lastName, sn, surname, user.surname, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname

Errors and Limitations

  1. If first name and last name values are missing, the user is created as User Anonymous.
  2. JIT fails if the org has reached its licensed user capacity.
  3. In SP-initiated flows, if the login page captured an email, the NameID in the assertion must match that email. Otherwise, provisioning is rejected for security reasons.

JIT Provisioning with OAuth 2.0

In OAuth 2.0 setups, JIT provisioning follows an SP-initiated flow:
  1. The user enters their email on the SecureFlag login page.
  2. SecureFlag matches the domain with the org’s main contact domain or list of allowed SSO domains.
  3. SecureFlag provisions the account using the email field from the OAuth claim.

Configuration Scenarios
  1. Single org → no extra configuration.
  2. Multiple orgs with unique email domains → no extra configuration.
  3. Multiple orgs with overlapping email domains → only one org can be enabled for JIT. If multiple are enabled, the first is selected by default.

OAuth JIT Provisioning Required attributes

For OAuth JIT, SecureFlag populates the user’s first and last name from claims in this order:
  1. given_name → sets first name
  2. family_name → sets last name
  3. name → used if the above are missing. Split on the first space:
    1. Left part → first name
    2. Right part → last name

Example:
  1.  "name": "Jane Doe" → First = Jane, Last = Doe.
  2.  If no space is found → First = full value, Last = Anonymous.

Errors and Limitations

  1. If first name and last name values are missing, the user is created as User Anonymous.
  2. JIT fails if the org has reached its licensed user capacity.
  3. In SP-initiated flows, if the login page captured an email, the email field in the OAuth claim must match that email. Otherwise, provisioning is rejected for security reasons.

SAML Custom Claims

SecureFlag supports parsing custom SAML attributes to configure user access, including roles, teams, managers, tags, and ThreatCanvas project permissions.

Important Considerations
  1. Custom claims are applied only if Custom SAML Claims is enabled on the target organization. 
  2. When enabled, any attribute returned in the SAML assertion overrides the existing user values (including those set via the Web Management interface).

To Enable SAML Custom Claims Provisioning
  1. Go to the Orgs tab.
  2. Click Details for your organization.
  3. In the Single Sign-On & User Provisioning panel, enable the SAML Custom Claims toggle.



Custom SAML Attributes

Organization Selector

Specifies which organization to create the user in when multiple orgs share the same SAML configuration. If omitted, the first matching org is used.

Attribute
Type
Example
sf_org
integer
42

Role

Defines the user’s role on the SecureFlag platform.

Attribute
Type
Example
sf_role
integer
3

The following roles are available:

Integer
Role Name
0
Organization Admin
3
Team Manager
4
Stats
5
Creator
6
ThreatCanvas Reviewer
7
User

InfoTip: Assign the role with the least privilege necessary. Setting sf_role also controls eligibility for sf_managed_teams (only valid for Team Manager and Organization Admin roles).

Team Membership

Assigns the user to a team.

Attribute
Type
Example
sf_team
string (team name)
Blue Team

Managed Teams

Grants the user manager permissions over specific teams. Only applied if the user’s role is Team Manager or Organization Admin.

Attribute
Type
Example
sf_managed_teams
comma-separated list of strings
Blue Team, Red Team

Manager

Specifies the email address of the user’s manager.

Attribute
Type
Example
sf_manager
comma-separated list of strings
manager@example.com

Tags

Adds a list of tags to the user.

Attribute
Type
Example
sf_tags
comma-separated list of strings
Security, EMEA, Contractor

ThreatCanvas Projects

Defines project permissions for ThreatCanvas.

Attribute
Type
Example
sf_projects
map
{"Project Alpha" : "RW",
"Project Beta" : "RO"}

Permission Values
  1. RO = Read-only
  2. RW = Read/Write

Example SAML Assertion

<saml2:Assertion xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
  <saml2:Subject>
    <saml2:NameID Format="urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress">
    </saml2:NameID>
  </saml2:Subject>
  <!-- First name -->
    <saml2:AttributeValue>Jane</saml2:AttributeValue>
  </saml2:Attribute>
  <!-- Last name -->
    <saml2:AttributeValue>Doe</saml2:AttributeValue>
  </saml2:Attribute>
  <!-- Optional org selector -->
  <saml2:Attribute Name="sf_org">
    <saml2:AttributeValue>42</saml2:AttributeValue>
  </saml2:Attribute>
  <!-- Role -->
  <saml2:Attribute Name="sf_role">
    <saml2:AttributeValue>3</saml2:AttributeValue>
  </saml2:Attribute>
  <!-- Team Membership -->
  <saml2:Attribute Name="sf_team">
    <saml2:AttributeValue>Blue Team</saml2:AttributeValue>
  </saml2:Attribute>
  <!-- Managed Teams -->
  <saml2:Attribute Name="sf_managed_teams">
    <saml2:AttributeValue>Blue Team,Red Team</saml2:AttributeValue>
  </saml2:Attribute>
  <!-- Manager -->
  <saml2:Attribute Name="sf_manager">
    <saml2:AttributeValue>lead.manager@example.com</saml2:AttributeValue>
  </saml2:Attribute>
  <!-- Tags -->
  <saml2:Attribute Name="sf_tags">
    <saml2:AttributeValue>Security,EMEA,Contractor</saml2:AttributeValue>
  </saml2:Attribute>
  <!-- ThreatCanvas Projects -->
  <saml2:Attribute Name="sf_projects">
    <saml2:AttributeValue>{ "Project Alpha": "RW", "Project Beta": "RO" }</saml2:AttributeValue>
  </saml2:Attribute>
</saml2:Assertion>

Additional References

Please follow configuration instruction to setup custom SAML attributes for your Identity Provider.
  1. Okta: How to define and configure a custom SAML attribute statement?
  2. Azure AD / Entra ID: SAML claims customization