Sign-in methods
An email code and Google give the same account for the same email address. A SAML sign-in gives a separate account, even for the same email address: see Accounts and access. MFA applies on top of every method.
Google and SAML sign-in are available only when they are turned on for your deployment. If Google sign-in is not available, the sign-in page says so: continue with your work email. Contact support to ask about SAML SSO for your organization.
How SAML SSO works
When SSO is set up for your email domain:- You open the sign-in page and enter your work email.
- You click Sign in with SSO.
- ManaLens finds the identity provider for your email domain and sends you to it.
- You sign in with your identity provider.
- The identity provider sends you back to ManaLens, signed in.
Supported providers
SSO works with SAML 2.0 identity providers, such as Okta, Google Workspace and Microsoft Entra ID (Azure AD). Any identity provider that follows SAML 2.0 should work.Set up SAML SSO
The ManaLens team registers your identity provider. You create the SAML application in your identity provider.1
Contact support
Ask support to set up SAML SSO. Give your email domains, for example
example.com and example.co.uk. Each domain can have one identity provider.Support sends you two values for your identity provider:2
Create a SAML application
In your identity provider, create a SAML 2.0 application with these settings:
3
Map the email attribute
Add an attribute statement named
email with the user’s email address. The email must use one of the domains you gave support.4
Assign users
Assign the application to the users or groups who need ManaLens.
5
Send the metadata
Copy your identity provider’s SAML metadata URL (or download the metadata XML file) and send it to support. Support registers it for your domains and tells you when it is ready.
6
Test the sign-in
- Sign out of ManaLens, or open a private window.
- Open the sign-in page and enter an email with your domain.
- Click Sign in with SSO. You go to your identity provider.
- Sign in. You come back to ManaLens, signed in.
Okta
- In the Okta Admin Console, go to Applications > Applications and click Create App Integration.
- Select SAML 2.0 and click Next.
- Enter an app name, for example
ManaLens, and click Next. - Enter the Single sign-on URL (the ACS URL) and the Audience URI (SP Entity ID).
- Set Name ID format to
EmailAddressand Application username toEmail. - Under Attribute Statements, add
emailwith the valueuser.email. - Finish the wizard. On the Sign On tab, copy the Metadata URL and send it to support.
- On the Assignments tab, assign the users or groups.
Google Workspace
- In the Google Admin console, go to Apps > Web and mobile apps, then Add app > Add custom SAML app.
- Enter an app name and click Continue.
- Click Download metadata and keep the XML file for support. Click Continue.
- Enter the ACS URL and the Entity ID (the SP entity ID). Set Name ID format to
EMAILand Name ID to Basic Information > Primary email. - Under Attribute mapping, map Primary email to
email. - Turn the app on for the organizational units or groups who need it.
Microsoft Entra ID
- In the Microsoft Entra admin center, go to Enterprise applications > New application > Create your own application. Choose Integrate any other application you don’t find in the gallery.
- Open Single sign-on and choose SAML.
- Under Basic SAML Configuration, enter the Identifier (Entity ID) (the SP entity ID) and the Reply URL (the ACS URL).
- Under Attributes & Claims, set the Unique User Identifier to
user.mailwith the formatEmail address, and add a claim namedemailwith the valueuser.mail. - Copy the App Federation Metadata Url and send it to support.
- Under Users and groups, assign the users or groups.
Accounts and access
SSO proves who you are. It does not give access to a workspace.- An owner or admin must still invite you, and your role decides what you can do. Accept the invite while you are signed in with SSO.
- A new identity does not get a membership only because its email matches a member.
- A SAML account is separate from an email code or Google account with the same email address. It has its own workspace memberships and its own MFA authenticator.
Remove access
- Remove the user from the SAML application in your identity provider. They can no longer sign in with SSO.
- Remove the user on the Members page of each workspace. This ends their access to the workspace at once, even in a session that is already open.