SAML is a protocol between an Identity Provider (IdP) and Service Provider (SP) that defines how a user in Service Provider can be authorised in a system with a profile provided by the Identity Provider. In this model Humaans acts as a Service Provider (SP) and plugs into whichever Identity Provider (IdP) you are using in your business (e.g. Okta/JumpCloud/Azure AD etc).

You will need to be an owner or admin of Humaans to configure the SAML integration and have administration privileges in your chosen Identity Provider.

First open the Integrations screen and click "Configure" on the SAML card.

Then click "Enable integration" in the modal.

After a few moments you will see another button "Continue SAML setup", click this and you will be taken to an admin portal where you can complete the SAML setup.

From this admin portal you can select your SAML provider and will be shown step-by-step instructions for configuring it.

Once this is complete when you go back to Humaans you will see that the integration is now active.

Now, when your users enter their email address in the Humaans login page they will be redirected to your Identity Provider, after they've logged in there they will be logged in to the Humaans app.

Alternatively, if your Identity Provider offers end users an application dashboard (Okta is pictured below) your users can login by just clicking the application.

From the moment the integration becomes active your users will be able to login through your chosen Identity Provider. Users will no longer be able to login with their password. If you currently use Google/Microsoft SSO these logins will continue to work alongside SAML login, please get in contact with support if you would like these to be disabled.