Direct Answers · ERPNext SSO Integration
Q: How does ERPNext LDAP integration work for employee single sign-on with Active Directory?

Quantbit's LDAP connector connects ERPNext to your organization's Active Directory or OpenLDAP server. When an employee types their domain username and password on the ERPNext login screen, the credentials are authenticated against Active Directory — not a separate ERPNext password. ERPNext roles are mapped to Active Directory security groups, so when someone moves to a different department or gets promoted, updating their AD group instantly changes their ERPNext permissions. When an employee leaves and is disabled in Active Directory, they immediately lose access to ERPNext — no separate IT action required on the ERPNext side.

Q: Can employees log in to ERPNext using their Microsoft 365 account without a separate ERPNext password?

Yes. Quantbit's Microsoft Entra ID connector adds a "Sign in with Microsoft" button to the ERPNext login page. Employees authenticate using their existing Microsoft 365 credentials — the same username and password they use for Outlook, Teams, and SharePoint. No separate ERPNext password is created or required. Entra ID security groups are mapped to ERPNext roles so access levels are controlled from Microsoft's admin console. Multi-factor authentication configured in Entra ID automatically applies to ERPNext logins as well.

🔐 Identity & SSO Connector Pack

One Company Login. Every System — Including ERPNext.

Let employees log into ERPNext with the same credentials they use for Microsoft 365, Google Workspace, or your company's Active Directory. No separate passwords, no IT helpdesk calls about ERPNext logins, no access that lingers after someone leaves.

Identity Providers

Connect ERPNext to the Identity System You Already Use

You already have an identity provider managing your company's users. ERPNext should respect that system — not maintain a parallel one. Our connectors make that happen.

🪟

Microsoft Entra ID (Azure AD)

For companies running Microsoft 365 — the most common setup in Indian mid-market and enterprise companies. Employees use their Outlook credentials to access ERPNext, and IT manages everything from the Azure portal.

  • OAuth 2.0 / OpenID Connect based SSO
  • "Sign in with Microsoft" button on ERPNext login
  • Entra ID groups mapped to ERPNext roles
  • MFA enforced from Entra ID policy
  • Conditional access policies respected
  • User provisioning (SCIM) from Entra ID
  • Automatic account disable on Entra ID deactivation
  • Department and job title synced to ERPNext profile
🔵

Google Workspace SSO

For companies using Google Workspace — common in startups, IT companies, and modern mid-market businesses that have moved away from on-premise Microsoft. Google credentials grant ERPNext access seamlessly.

  • Google OAuth 2.0 integration
  • "Sign in with Google" on ERPNext login page
  • Google Workspace domain restriction (only company emails)
  • Google Groups mapped to ERPNext roles
  • Google MFA carries over to ERPNext sessions
  • User directory sync from Google Admin
  • Profile photo pulled from Google account
🏢

LDAP / Active Directory

For companies with on-premise Windows Server and Active Directory — still the dominant setup in manufacturing, government-adjacent businesses, and established enterprises. ERPNext authenticates against your existing AD server without requiring cloud identity services.

  • Direct LDAP bind authentication
  • On-premise Active Directory support
  • OpenLDAP and FreeIPA support
  • AD organizational unit to ERPNext role mapping
  • Password policy enforcement via AD
  • Account lockout and expiry respected
  • Works without internet dependency (LAN-only)
User Lifecycle Management

When Your Identity Provider Moves, ERPNext Follows

The real value of SSO integration is not just the login button — it is that every identity event in your central directory automatically reflects in ERPNext.

👋

New Employee Joins

HR creates the user in Active Directory or Entra ID. The ERPNext account is provisioned automatically with the correct role based on the department group — no separate ERPNext user creation needed.

🔄

Employee Changes Department

IT moves the employee to a different AD group reflecting their new role. ERPNext permissions update automatically. No ticket to the ERPNext admin, no manual role reassignment.

🔒

Employee on Leave or Suspended

AD account is disabled by HR or IT. ERPNext login is blocked immediately. No risk of a suspended employee accessing financial or sensitive business data.

🚪

Employee Leaves

AD account is deactivated on the last working day. ERPNext access is revoked at the same moment — no orphaned accounts, no security risk from ex-employee credentials.

Real Stories

The Identity Problems That Made SSO Integration Non-Negotiable

SSO integration tends to happen after an incident — a security audit finding, an ex-employee access scare, or a week where IT spent more time resetting ERPNext passwords than doing anything else.

Manufacturing · Pune

The IT Manager Getting 12 ERPNext Password Reset Requests a Week

A 300-employee auto components manufacturer in Pune ran Microsoft 365 for email and Teams — every employee had an Entra ID account and used it daily without thinking about it. But ERPNext had its own separate login system. Every few weeks, someone would forget their ERPNext password and raise a helpdesk ticket. The IT manager was handling twelve to fifteen ERPNext password reset requests per week on average. During month-end closing when more people than usual were logging in, it could hit twenty-five in a single week. After the Microsoft Entra ID SSO integration went live, the password reset requests dropped to near zero overnight. Employees just click "Sign in with Microsoft," use the same credentials they use for Teams, and they are in ERPNext. The IT manager used the time he reclaimed to complete a network infrastructure project that had been pending for eight months.

✦ ERPNext password reset requests dropped from 12–15/week to near zero; IT team time reclaimed
IT Services · Bengaluru

The Security Audit That Found 23 Former Employees Still Had ERPNext Access

An IT services company in Bengaluru conducted an annual security audit and ran a comparison between their active employee list in Entra ID and the active users in ERPNext. They found twenty-three accounts in ERPNext belonging to employees who had left the company in the past eighteen months — some of whom had left under difficult circumstances. Three of those accounts still had access to sensitive financial data. Nobody had deliberately ignored this — it was simply that the ERPNext admin was a different person from the Entra ID admin, and offboarding for one system did not automatically propagate to the other. After the Entra ID SSO integration, all twenty-three accounts were deactivated immediately as part of the cutover. Going forward, when HR disables an Entra ID account, ERPNext access disappears at the same moment. The next security audit found zero orphaned accounts.

✦ 23 orphaned accounts closed; zero orphaned accounts in subsequent audits; offboarding is now automatic
Hospital · Kolhapur

Nurses and Doctors Who Would Not Use ERPNext Because Logging In Was Too Slow

A multi-specialty hospital in Kolhapur ran ERPNext HISx for billing, pharmacy, and patient records. The clinical staff — nurses and junior doctors — were supposed to log patient data directly into ERPNext during their shifts. But the reality was that they were already logged into their hospital's Google Workspace accounts on shared computers, and having to log out and log into a completely separate ERPNext account was enough friction that many of them skipped it and gave data to the billing desk to enter later. Patient record data was always an hour or two behind. After Google Workspace SSO was integrated with ERPNext, clinical staff click "Sign in with Google" and they are in ERPNext within seconds using the credentials they are already logged into. Adoption of direct clinical data entry went up significantly, and the billing team's data entry load dropped because nurses and doctors were updating records themselves.

✦ Clinical staff ERPNext adoption increased substantially; real-time patient data entry now the norm
Manufacturing Group · Sangli

Managing ERPNext Users Across Four Group Companies Without Four Separate Admin Headaches

A manufacturing group in Sangli operates four companies — a foundry, a forging unit, a trading arm, and a holding entity — each with its own ERPNext company setup but on a shared instance. Each company had employees who needed different roles in ERPNext, and managing who had access to which company's data was complex. When someone moved from the foundry to the trading arm, their ERPNext permissions had to be manually updated by the group IT admin — who often did not hear about internal transfers until a week or two after they happened. After LDAP integration with the group's on-premise Active Directory, each company's employees are in a separate AD organizational unit, and ERPNext permissions are managed through AD group policies. An internal transfer is handled in AD, and ERPNext access changes automatically — correctly, immediately, and without the IT admin needing to know about every internal movement.

✦ Cross-company access management automated; permission updates happen in seconds after AD change
Trading Company · Muscat

The Oman Business That Needed ERPNext Access for Staff in Three Countries

A trading company headquartered in Muscat had staff working in India, Oman, and Kenya — all needing ERPNext access. Managing separate ERPNext passwords across three geographies, especially for staff who were not tech-savvy, was a continuous problem. Forgotten passwords from staff in Kenya who only used ERPNext monthly were the norm. After Microsoft Entra ID SSO integration, all staff globally use their Microsoft 365 credentials — which they use every day for email and Teams regardless of location. The Entra ID account is the single login that works for everything. For staff in low-connectivity areas, the connector's offline session token approach means they can stay logged in for extended periods without re-authenticating every day.

✦ Multi-country ERPNext access unified under single Entra ID login; support tickets from remote staff reduced by 80%
Facility Management · GCC

The Compliance Requirement That Made MFA on ERPNext Non-Negotiable

A facility management company in the GCC won a contract with a government entity that required all vendor software accessing government-related data to enforce multi-factor authentication. ERPNext's native MFA is functional but requires configuring it separately for each user — and tracking MFA enrollment across 80 field staff is its own project. After Microsoft Entra ID SSO integration, MFA is enforced by Entra ID's conditional access policy — the same policy that applies to Teams, Outlook, and every other Microsoft application. When staff log into ERPNext, they authenticate with Microsoft and MFA fires automatically. No separate ERPNext MFA enrollment, no exceptions. The compliance certificate the government entity required was issued within two weeks of the integration going live.

✦ Government MFA compliance achieved; MFA enforced across all 80 staff via Entra ID policy with zero individual setup
Technical Specs

Standards-Based. Secure by Design.

All three identity integrations use industry-standard protocols — no proprietary connectors, no lock-in, and no security shortcuts.

Protocols Supported

  • OAuth 2.0 (Entra ID, Google)
  • OpenID Connect (OIDC)
  • SAML 2.0 (enterprise SSO)
  • LDAP v3 (Active Directory)
  • SCIM 2.0 (user provisioning)
  • JWT token validation

Identity Providers

  • Microsoft Entra ID (Azure AD)
  • Google Workspace
  • Active Directory (on-premise)
  • OpenLDAP
  • Okta, OneLogin (SAML)
  • FreeIPA (Linux environments)

ERPNext Compatibility

  • ERPNext v13, v14, v15
  • Multi-company role mapping
  • Custom role to group mapping UI
  • Fallback local login for emergency admin
  • Session timeout configurable

Security Features

  • MFA enforcement via identity provider
  • Conditional access policy support
  • IP restriction from identity provider
  • Session revocation on IdP logout
  • Login audit log in ERPNext
  • Brute-force protection via IdP

User Provisioning

  • Auto-create ERPNext users from IdP
  • Role assignment from group membership
  • Profile field sync (name, dept, title)
  • Auto-disable on IdP deactivation
  • SCIM push from Entra ID (optional)

Deployment

  • Cloud ERPNext (Frappe Cloud) supported
  • Self-hosted ERPNext supported
  • On-premise LDAP (no internet required)
  • GCC and India data residency options
  • Setup time: 2–5 business days
FAQs

What IT Managers Ask Before Going Live

What happens if the identity provider is down? Can employees still access ERPNext?
For cloud identity providers like Entra ID and Google Workspace, downtime is extremely rare — both providers maintain 99.99% availability SLAs. For LDAP on-premise setups, we recommend configuring a fallback local admin account in ERPNext that can be used in emergencies. Regular employees' SSO sessions remain valid for the configured session duration even if the IdP has a brief outage. For mission-critical environments, we can configure a secondary LDAP server as a failover.
How granular can ERPNext role mapping from Active Directory groups be?
Very granular. You can map individual AD security groups to individual ERPNext roles — for example, "Finance-AP-Users" in AD maps to "Accounts Payable User" in ERPNext, while "Finance-AR-Users" maps to "Accounts Receivable User." Users in both groups get both roles in ERPNext. You can also map groups to ERPNext's permission levels, restricting which company entities or cost centres a user can see. The mapping is configured in a visual table within ERPNext — no code changes required.
We have some contractors and external auditors who need ERPNext access but are not in our Active Directory. How do we handle them?
ERPNext supports mixed authentication modes. Internal employees use SSO through your identity provider. External users — contractors, auditors, consultants — can be given local ERPNext accounts with individual username and password authentication. The SSO connector does not force every account to use SSO; it makes SSO the default for users whose email domain matches your configured identity provider domain. External emails are handled with local accounts as usual.
Does SSO work on the ERPNext mobile app?
Yes. ERPNext's mobile app (both the native app and the Progressive Web App) supports SSO login. On mobile, tapping "Sign in with Microsoft" or "Sign in with Google" redirects to the identity provider's mobile-optimized login page, authenticates, and returns the user to ERPNext. For mobile devices managed via Mobile Device Management (MDM), this can be configured to work with device-level authentication as well.
How long does the SSO integration setup take?
For Entra ID or Google Workspace SSO, setup typically takes 2 to 3 business days — this includes registering ERPNext as an enterprise application in your identity provider, configuring the OAuth callback URLs, mapping groups to ERPNext roles, and testing with a pilot group of users before rolling out to all staff. LDAP integration for on-premise Active Directory may take 3 to 5 days depending on network access to the LDAP server and the complexity of the group-to-role mapping required.

Your Employees Have One Company Password. ERPNext Should Respect That.

Tell us which identity provider you use and how many ERPNext users you have. We will have SSO live in under a week — with roles mapped to your existing groups.

Book a Free SSO Integration Call →