Skip to content
Developers

Authentication and SSO

Administrators only

Tallyfy includes free Single Sign-On (SSO) on any paid plan, and you set it up yourself. An org admin configures the connection, tests it, and turns it on from Settings > Organization > Security > SSO. No support ticket needed. Your team then logs in with existing corporate credentials from Microsoft Entra ID, Google Workspace, Okta, OneLogin, JumpCloud, or any SAML 2.0 provider.

There’s more than just login. You verify your email domain by DNS so a connection you set up yourself signs in only people on your domains, sync your whole directory with SCIM so people are added and removed automatically, and enforce SSO-only access that blocks email and password logins. Enforcement has no password fallback, even for owners and admins, so plan how you’d get back in if your identity provider goes down.

Everything lives in one place. Sign in as an administrator, open Settings > Organization > Security, and you’ll find tabs for SSO, Domains, SCIM, and the security Activity log. Each tab is covered in its own guide below.

BenefitWhat it means
SecurityApply your company’s existing security rules and MFA (an extra login check beyond a password) to Tallyfy
One loginTeam members use their corporate username and password
Access controlManage Tallyfy permissions from your identity provider
Auto-provisioningNew users on a verified domain get Tallyfy accounts on first SSO login, unless SCIM is on
Directory syncSCIM adds, updates, and deactivates users automatically from your IdP
Consistent policiesSame password complexity and session rules across all systems
Less IT overheadNo more Tallyfy-specific password resets

The SSO wizard walks you through it in four steps. You don’t need to write any XML by hand.

  1. Pick your identity provider. Choose Okta, Microsoft Entra ID, Google Workspace, OneLogin, JumpCloud, generic SAML, or generic OIDC. Tallyfy shows you the exact SP values to copy into your IdP (the ACS URL and entity ID).
  2. Enter your IdP details. Use one of the three methods below.
  3. Test the connection. Tallyfy validates your metadata and certificate before it lets you go live, so you catch problems early instead of during a real login.
  4. Turn it on. Once the test passes and you have a verified domain, enable the connection. People on your verified domains can sign in through SSO right away.

Pick the per-IdP guide further down for screenshots and the exact field names in your provider.

Three ways to connect your identity provider

Section titled “Three ways to connect your identity provider”

When you reach the “enter IdP details” step, Tallyfy gives you three ways to hand over your provider’s SAML metadata. They all end up in the same place, so use whichever your IdP makes easiest.

MethodWhen to use itWhat you paste
Metadata URLYour IdP publishes a metadata link (most do). The easiest option.The URL. Tallyfy fetches and parses it for you.
XML pasteYour IdP gives you a metadata file to download.The full metadata XML, pasted into the box.
Manual entryYou’d rather type the values, or your IdP doesn’t export metadata.The sign-in URL, issuer/entity ID, and signing certificate.

With the metadata URL method, Tallyfy can re-read your IdP’s metadata later, which helps when your provider rotates its signing certificate.

A connection you set up yourself signs in only people whose email is on a domain you’ve verified, so you prove you own your email domain before you turn SSO on or enforce it. You do this by adding a DNS TXT record. A verified domain is the safety check that stops a stranger, whose own IdP happens to assert an @yourcompany.com address, from signing in as one of your people.

Domain verification is its own short setup. See Domain verification for the steps and what each verified domain turns on.

SCIM connects Tallyfy to your identity provider’s directory so user accounts stay in sync without anyone clicking around. When someone joins a group in your IdP, they get a Tallyfy account. When they leave, their Tallyfy access is removed and the seat frees up. No more paying for ex-employees.

Turn it on under Settings > Organization > Security > SCIM. See SCIM provisioning for how to generate the token and map IdP groups to Tallyfy roles.

SSO authentication creates audit trails that can replace e-signature tools for internal approvals.

Why skip traditional e-signatures for internal use?

  • Extra cost per signature/user
  • Separate system to manage
  • Workflow interruption - users leave Tallyfy, sign elsewhere, then return

SSO-based approvals give you:

  • No extra cost - included with paid Tallyfy plans
  • Identity verification - corporate SSO confirms the approver’s identity
  • Audit trail - every approval logged with timestamp and user identity
  • No context switching - approvers complete tasks without leaving Tallyfy
  • Legal compliance - meets requirements for internal corporate approvals in most jurisdictions

Common use cases: purchase orders, policy acknowledgments, budget authorizations, project sign-offs, compliance confirmations, HR approvals.

You can lock your org down so SSO is the only way most people log in. Flip the Require SSO switch under Settings > Organization > Security > SSO. When enforcement is on:

  • Email and password logins are turned off for members whose email is on a verified domain, owners and admins included
  • Manual invites for addresses on your verified domains are blocked, so those people come through your identity provider
  • On a connection you set up yourself, people on other domains can still be invited by hand and sign in with a password
  • Someone who also belongs to another Tallyfy organization that doesn’t require SSO of them keeps password login
  • Members it covers who use the regular login page are sent to sign in through your identity provider

On a connection Tallyfy support set up for you, enforcement covers every member, whatever their domain, and blocks every manual invite.

The switch stays disabled until you have a verified domain, because that’s what makes enforcement safe. Turning it on shows a confirm box first. Tallyfy then emails every admin about the change and records it in your system log.

No password fallback: owners and admins that enforcement covers must use SSO too. If your identity provider goes down or a misconfiguration breaks SSO, they can’t sign in with a password. An admin who’s still signed in can turn enforcement off from the same switch, and Tallyfy Support can turn it off for you.

For the full enforcement walk-through and recovery steps, see SSO enforcement. For security background, see the Compliance documentation on Mandatory Single Sign-On.

Here’s what happens when someone logs in via SSO:

  1. User visits your org’s Tallyfy login link
  2. Tallyfy redirects to your identity provider (Entra ID, Google, etc.)
  3. User authenticates with corporate credentials and MFA
  4. Identity provider sends a SAML assertion back to Tallyfy
  5. On a connection you set up yourself, Tallyfy checks the email is on one of your verified domains. Existing members are matched and logged in. First-time users get an account created automatically from identity provider data (email, first name, last name), unless SCIM is on
What happens when someone logs in with SSOUserTallyfyIdentityprovider 1. Open the SSOlogin link2. Redirect3. Sign in withcompany credentials4. SAML assertion5. Check the domain,match or add the user6. Access granted

Step 5 is where your verified domains matter. A connection you set up yourself turns the person away if their email isn’t on one of them, even if they’re already a member. If the person is already in your org, they’re matched on email and logged straight in. If they’re new to your org, Tallyfy adds them, and creates their account from the email, first name, and last name in the assertion if they don’t have one. With SCIM on, Tallyfy adds nobody at sign-in, so someone who isn’t in your org yet, and has no open invitation, is turned away. On a connection Tallyfy support set up, support can also limit newcomers to people on your verified domains.

Microsoft Entra ID (formerly Azure Active Directory)

Section titled “Microsoft Entra ID (formerly Azure Active Directory)”

Cloud identity and access management with conditional access and MFA.

Azure AD Setup Guide →

Identity platform for businesses using Gmail, Drive, and other Google tools.

Google Workspace Setup Guide →

Cloud-based identity service for enterprise SSO.

Okta Setup Guide →

Identity and access management with SSO capabilities.

OneLogin Setup Guide →

Cloud directory platform with SAML-based SSO.

JumpCloud Setup Guide →

Any SAML 2.0-compatible identity provider works. Pick the Generic SAML option in the wizard and use the metadata URL or XML paste method. OIDC providers work too via the Generic OIDC option. If your provider does something unusual, Tallyfy support can help you check compatibility.

  • A paid plan - SSO and SCIM are available on any active paid plan
  • Admin access in both Tallyfy and your identity provider
  • A verified domain before you turn SSO on or enforce it, because your connection signs in only people on your verified domains
  • Attribute mapping - email, first name, and last name fields from your identity provider to Tallyfy
  • Testing - the wizard’s built-in test, plus a check with different user types before rolling out org-wide
  1. Sign in as an administrator and open Settings > Organization > Security > SSO
  2. Pick the setup guide for your identity provider above and follow it alongside the wizard
  3. Configure the identity provider side, then paste your metadata into Tallyfy
  4. Verify your domain, run the connection test, then enable SSO
  5. (Optional) Turn on SCIM and switch on enforcement
  6. Test with users from different departments and roles, then tell your team about the new login

If you’re stuck in a login loop or can’t get past the login screen, visit https://account.tallyfy.com/logout ↗ to clear all sessions. Then clear your browser cookies for tallyfy.com, wait 10-15 seconds, and log in again.

For more details, see the authentication loop resolution guide.

IssueSolution
Login loops with SSOVisit https://account.tallyfy.com/logout ↗, then re-authenticate
Can’t switch orgsForce logout and clear cookies for all tallyfy.com domains
SSO and password login conflictClear all sessions via the logout URL before switching methods
”Need admin approval” messageYour IT admin must approve Tallyfy in the identity provider settings