SAML integration strategy & best practice

There are many ways to implement SAML to manage users and access in OptiSigns with your IDP.

Here are some high level best practice with OptiSigns that may help you to plan your integration and reduce overhead, manual work later.


This article only focus on the strategy & approach, for detail step by step configuration, you can refer to this guide.


Create an backup Admin account during set up:

During set up, we recommend to leave Enable Username & Password login, and create an Admin account with username/password to log back in and config, in case you accidently lock yourself out by miss assignment of role, groups.

You can disable this account later once your implementation is completed.


In the case you are planning not to use email as the unique identifier for the user, and use username or employee id instead. We recommend to have this on, so the account owner and admin account will be able to manage the account without interruption, e.g. forgot password, issue with identify provider. 


There are 2 Strategies of using SAML:

1) As Authentication & Authorization Service to enforce identity verification like above, but also enforce user, team, role mapping in OptiSigns, With this approach you will map all users to groups in your IDP, and map the IDP groups to OptiSigns teams / roles. When there's a change in IDP like a user is added or moved group, it will automatically reflect in OptiSigns. We recommend this approach.

To implement this, check "Enable User Override", with this enabled, every time a user log in using SAML, OptiSigns will check to see if their group assignment has changed, and enforce that accordingly, also if their name has changed, updated, it will also update OptiSigns.


Map all your appropriate groups to roles & team in OptiSigns.

For example we have 3 groups:

  • Marketing West Coast - users responsible for managing screens, content for West region
  • Marketing East Coast - user responsible for manage screens, content for East region
  • IT Support - Admin that can support both region and do other admin tasks

The mapping should be like below.


With this set up, if a user belong to Marketing West Coast, later moved to Marketing East Coast, you just need to update your IDP move him/her from Marketing West Coast to Marketing East Coast, next time the user log in, he/she now belong to and can only see "Marketing West Coast" team content in OptiSigns.


2) As Authentication Service Only to enforce your MFA, Password policy, and remove user will no longer have access to OptiSigns. You will still can assigns, manage these users to Teams, Roles in OptiSigns. This approach is quick to set up and flexible as you can quickly move users around in OptiSigns, but when users moved around in your IDP, you will have to remember to move them around in OptiSigns as well, if that's a requirement.

To implement this, uncheck "Enable User Override"


This way, in the example above. When a user move from Marketing West Coast to Marketing East Coast.

You will need to go to OptiSigns and move the user's team assignment, if that's required.

Also if when the user update, change their name, you will have to update OptiSigns as well to keep it in sync.


Enable User Creation:

We recommend to keep this option checked. When this option is enabled, if users authenticated and SAML setting map the user to a team, role that can use OptiSigns, the user will be created automatically.

If disabled, you will have to create each user first in OptiSigns before they can log in with SAML SSO.


In the example above, if there are 20 users belong to Marketing West Coast group in your IDP, and Marketing West Coast is mapped to the Marketing West Coast team in OptiSigns.

If user A belong to Marketing West Coast group logs in, he/she will be created in OptiSigns and can start working right away to with West Coast Team screens and content.

The other 19 users are not created in OptiSigns until they attempt to log in.

You can also map the "Unmapped users/groups" to "No Team (Disable)", this way if a user belong to some other group in your IDP like say "Sales West Coast" try to log in, they will get an error and the user is not created in OptiSigns.

This way you can keep the system clean and only necessary users that using the app are replicated.



If you have any questions or need help with SAML integration please feel free to reach out to us at


Was this article helpful?
0 out of 1 found this helpful



Article is closed for comments.