Zef offers SSO login to all licensed users
What is SSO login?
SSO login (Single Sign-On) means that your organization's users log in to Zeffi with the same credentials they use for other workplace systems. Login happens through your organization's identity provider, such as Microsoft Entra or Google Workspace. This lets you centrally manage who can log in to Zeffi.
This removes the need to invite users separately and to manage Zeffi passwords. New users can be added to your organization automatically on their first login, with the permission level you choose.
The service is included in all paid license tiers.
How is SSO implemented?
ZEF currently supports two ways to implement SSO login:
- SAML 2.0
- OIDC
This document covers SAML 2.0-based login. In SAML login, Zeffi acts as the Service Provider (SP), and login always starts from Zeffi.
If you want to use OIDC-based SSO, please contact our support at support@zef.fi, as its settings are not yet available in the Zeffi user interface.
What do I need to set up SSO?
- A shared identity provider (IdP) for your organization, such as Microsoft Entra or Google Workspace.
- Admin rights to the identity provider. Microsoft Entra requires at least the Cloud Application Administrator role, and Google Workspace requires super administrator rights.
- Owner or admin rights to your organization in Zeffi.
Your identity provider needs Zeffi's service provider details, which are available at: https://app.zef.fi/ssoLogin/saml/metadata
If your identity provider does not support a metadata URL, enter the details manually:
Setting |
Value |
Entity ID (Identifier) |
|
ACS URL (Reply URL) |
|
NameID format |
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress |
Step 1: Add Zeffi to your identity provider
Microsoft Entra
Zeffi is not listed in the Microsoft Entra application gallery, so it is added as your own (non-gallery) application.
- Sign in to the Microsoft Entra admin center (entra.microsoft.com) with at least the Cloud Application Administrator role.
- Go to Entra ID > Enterprise apps > All applications and select New application.
- At the top of the page, select Create your own application.
- Give the application a name, for example Zef. Select Integrate any other application you don't find in the gallery (Non-gallery) and then Create.
- In the application menu, select Single sign-on and choose SAML as the sign-on method.
- Under Basic SAML Configuration > Edit and enter the following details:
- Identifier (Entity ID): https://app.zef.fi/ssoLogin
- Reply URL (Assertion Consumer Service URL): https://app.zef.fi/ssoLogin/api/oauth/saml
- Select Save to save.
- Under SAML Certificates, copy the App Federation Metadata Url value. You will need it in the Zeffi settings in Step 2. The URL has the format https://login.microsoftonline.com/<tenant-id>/federationmetadata/2007-06/federationmetadata.xml?appid=<app-id>.
- Under Users and groups, add the users or groups who should have access to Zeffi.
Microsoft documentation
How to register a SAML app: https://learn.microsoft.com/en-us/entra/external-id/customers/how-to-register-saml-app
SAML token claims: https://learn.microsoft.com/en-us/entra/identity-platform/saml-claims-customization
Claim Mapping: https://learn.microsoft.com/en-us/entra/external-id/claims-mapping
Assigning users and groups: https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/assign-user-or-group-access-portal?pivots=portal
Google Workspace
- Sign in to the Google Admin console with super administrator rights.
- Go to Apps > Web and mobile apps and select Add app > Add custom SAML app.
- Give the application a name, for example Zef, and select Continue.
- On the Google Identity Provider details page, select Download metadata and save the XML file. You will need it in the Zeffi settings in Step 2. Select Continue.
- On the Service provider details page, enter the following details:
- ACS URL: https://app.zef.fi/ssoLogin/api/oauth/saml
- Entity ID: https://app.zef.fi/ssoLogin
- Name ID format: EMAIL
- Name ID: Basic Information > Primary email
Google documentation
Set up your own custom SAML app: https://knowledge.workspace.google.com/admin/apps/set-up-your-own-custom-saml-app
Step 2: Configure SSO settings in Zeffi
The SSO settings are found in Zeffi under Organization settings > Settings > SSO settings. The settings are visible to organization owners and admins.
- SSO Name: The name defines your organization's login URL https://app.zef.fi/login/<SSO-name>. The name must be unique and written in lowercase, without spaces or special characters.
- Email Domains: Add the domains whose email addresses log in through this SSO, for example company.com. You can add several domains.
- Logout URL: The address users are redirected to when they log out. The default is https://zef.fi, but you can change it, for example to your intranet address.
- Default user rights for new users: The permission level a new user gets when they are added to the organization on their first login.
- None: New users are not added automatically. Users are invited with a Zeffi team invitation, after which they can log in with SSO without creating a separate account.
- Member: Anyone with an email address in your organization's domain is added to the organization with member rights. This is the most common choice.
- Login timeout: The time in hours a user can remain logged in while inactive before being logged out automatically. The default is one week, i.e. 168 hours.
- IDP metadata: Choose the format and enter your identity provider's metadata. For Microsoft Entra, paste the App Federation Metadata Url (URL). For Google Workspace, paste the contents of the downloaded metadata file (XML) directly.
Save the settings by selecting Save. SSO login is now enabled.
Step 3: Test the login
- Open app.zef.fi/login in a new browser window and select Login with SSO.
- Enter an email address that belongs to one of the configured domains, for example firstname.lastname@company.com.
- Zeffi redirects you to your identity provider's login page and, after a successful login, back to Zeffi.
If the login fails, check the email domains, the metadata, and that the user has access to the application in the identity provider.
How users log in with SSO
- Via the login page (recommended): The user goes to app.zef.fi/login, selects Login with SSO and enters their work email.
- With the direct login URL: At app.zef.fi/login/<SSO-name> login happens directly, without the login page. You can link this address, for example, from your intranet.
- https://www.zef.fi: use the Log in-button, which takes you to the app.zef.fi/login page, where you can continue as usual.
Users are identified by their email address. If a user already exists in Zeffi with the same email address, their data stays as it is. The user can log in to the same account both with SSO and, for example, with the Log in with Google option.
Managing users and permissions
- The default permission level only applies when a user is added to the organization on their first login. This also applies to existing Zeffi users who have not previously belonged to your organization.
- After that, permissions are changed in Zeffi as usual, and SSO login does not change them.
- Enabling SSO does not change the permissions of existing users.
- If the default permission is None and the user has no invitation, login fails.
When a user is removed from the identity provider
When a user's account is deleted or disabled in the identity provider, they can no longer log in to Zeffi with SSO. Note, however, the following:
- Zeffi is not notified of the removal, and the user is not automatically removed from your Zeffi organization.
- If the user is already logged in, their session stays active until the login timeout logs them out.
- If access must be revoked quickly, we recommend setting the login timeout as short as possible. If needed, also remove the user from your Zeffi organization.
User data passed in SSO
At minimum, the user's email address is passed to Zeffi during SSO login. The first name and last name are usually passed as well.
Other data, such as the user's permission level, can also be passed to Zeffi. However, these settings cannot be configured in the user interface. If you need these features, please contact our support at support@zef.fi