FreeIPA for HIPAA unique user identification and authentication

How FreeIPA identities, Kerberos and OTP support HIPAA unique user identification and person or entity authentication on Linux systems that hold ePHI, and what evidence a risk analysis needs.

On this page

How FreeIPA helps meet HIPAA unique user identification and authentication

A covered entity or business associate running Linux systems that hold ePHI needs two things from its identity layer: a unique name or number for every user under 45 CFR 164.312(a)(2)(i), and procedures that verify a person is who they claim to be under 164.312(d). FreeIPA helps with both by giving each person one identity in a central directory, with single sign-on through an MIT Kerberos KDC and OTP factors for a second check. Its 389 Directory Server holds users, groups, hosts and policies, and SSSD on enrolled clients applies that identity to local logins. Unique identifiers are a configuration choice you must enforce, so confirm that shared or generic accounts are not used on ePHI systems and that local accounts are reviewed against the directory.

FreeIPA supports strong authentication through HOTP and TOTP tokens, including software tokens and hardware tokens such as YubiKeys, and it can proxy OTP checks to an existing RADIUS server. Those features support the verification side of 164.312(d), but they do not decide whether your procedures are sufficient. Confirm which accounts require OTP, how enrollment and token loss are handled, and whether privileged and service accounts are covered. Keep in mind that the HIPAA Security Rule is risk-based and has no certification, so no product, including FreeIPA, makes a system compliant on its own.

FreeIPA does not address the rest of the Security Rule. It does not perform your risk analysis under 164.308, manage business associate agreements under 164.314, log or review access to ePHI, or cover applications that keep their own user stores outside the directory. Those applications need their own mapping to the directory, and the risk analysis must record how each one authenticates users. Use the NIST SP 800-66 Rev. 2 guidance on authentication to document how you evaluated options and selected them, and treat FreeIPA's configuration exports and access reviews as inputs to that evidence rather than as the evidence itself.

Mapping HIPAA requirements to FreeIPA capabilities and configuration

This table maps the two HIPAA identification and authentication requirements and the related NIST SP 800-66 Rev. 2 activities to FreeIPA features, the settings to review, and the decisions the organization must make itself. Read each row as a starting design point, then confirm the settings against your own Linux estate and risk analysis. The main takeaway is that FreeIPA supplies the mechanisms, while the assignment of identities, the choice of authenticators and the evidence remain organizational decisions.

RequirementFreeIPA capabilityConfiguration to setWhat the organization must still decide
45 CFR 164.312(a)(2)(i) unique user identification389 Directory Server stores each user as a single directory entry with a unique login, and Kerberos principals map to that entryCreate one account per person, disable shared or generic logins, set a naming convention, and review group membership for shared service accountsWhich accounts count as workforce users, how service and vendor identities are named, and who approves each new identity
45 CFR 164.312(d) person or entity authenticationMIT Kerberos KDC issues tickets after password verification, and SSSD on clients enforces login against itSet password policy and lockout values, enable Kerberos pre-authentication, and confirm that clients enroll with SSSDWhich systems that hold ePHI must require a second factor, and how users prove identity during enrollment and reset
Authentication options for MFA (OTP)FreeIPA supports HOTP (RFC 4226) and TOTP (RFC 6238) tokens, including software tokens and hardware tokens such as YubiKeysEnroll tokens per user, set token policy, and test login through SSH and console paths used for ePHI systemsToken type per role, token issuance and loss procedures, and whether hardware tokens are required for privileged users
Existing MFA infrastructure (RADIUS proxy)FreeIPA can proxy OTP checks to an existing RADIUS serverConfigure the RADIUS proxy, confirm the shared secret handling, and test failover behavior before relying on itWhether an existing RADIUS or MFA service is the system of record, and who maintains it
NIST SP 800-66 Rev. 2 section 5.3.1 unique identifiersCentral identity store that lists every user and group, with audit of account creationExport user and group reports on a schedule, and retain change history for account creation and removalHow often access reviews run, and who signs off on the identity inventory used in the risk analysis
NIST SP 800-66 Rev. 2 section 5.3.4 applicability of authenticationHost-based access control (HBAC) and sudo rules limit which users can log in to which hostsMap each system that creates, receives, maintains or transmits ePHI to an HBAC rule, and document systems with no ePHI as out of scopeWhich systems hold ePHI, which are connected to them, and how the boundary is documented in the risk analysis
NIST SP 800-66 Rev. 2 section 5.3.4 evaluating and selecting optionsFreeIPA offers passwords, Kerberos, OTP and certificate-based options, each with different trade-offsRecord the chosen options per system class, and keep the configuration in version control for evidenceWhether the selected options are reasonable and appropriate, and which alternative measures apply if an option is not used

Designing unique identities for workforce, service and shared accounts

Named workforce users are the simplest case for unique user identification. Each person who reaches a system holding ePHI should have one FreeIPA user entry, with one login name and one Kerberos principal, that is never reissued to someone else. FreeIPA stores these users in its 389 Directory Server back end, and groups hold the access logic, so access is granted to groups rather than to individuals wherever practical.

  • One identity per person: Create a single user entry for each workforce member and prohibit local accounts on ePHI hosts that bypass FreeIPA.
  • Groups as the access unit: Map roles to groups and attach host-based access control and sudo rules to those groups, so tracking shows who holds which role.
  • Kerberos principals for tracking: Authentication through the MIT Kerberos KDC ties each session to a named principal that logs can record.
  • Lifecycle tied to HR events: Define a documented process for disabling accounts on departure or role change, and confirm how your team will run it.
  • Retired names: Decide whether a departed user's login can ever be reused. Most reviewers expect it is not.

A reviewer will ask who approved each account, when it was created and disabled, and whether any person shares a login. Confirm that the export of user, group and rule membership matches your HR records.

Evidence to keep for a HIPAA risk analysis

The FreeIPA server produces most of the records below, but it does not decide whether they are adequate. The covered entity and its assessor judge whether the evidence shows unique identification under 164.312(a)(2)(i) and person or entity authentication under 164.312(d). Keep each record dated and tied to the control it supports.

User lists and group membership exports

Export the full user list with account status, and the membership of every group that grants access to systems holding ePHI. Each account should map to one named person or to one documented entity, with no shared logins. Compare the export to HR records on a schedule you set, and keep the dated exports so you can show who had access at a given time. Confirm the export format and fields with your own FreeIPA version before you rely on a script.

OTP token enrollment and assignment records

Record which OTP tokens (software or hardware) exist, which user each is assigned to, and when it was enrolled or revoked. This is the main evidence that the second factor is tied to a specific identity rather than a shared device. Note how lost tokens are handled, since a replacement without a documented identity check weakens the authentication story. The token design is described in the FreeIPA OTP design page.

Password and authentication policy settings

Export the global and per-group password policies, lockout settings and Kerberos ticket lifetimes, and keep them under change control. Auditors will compare these settings with what your risk analysis says you chose and why. Record every change with its approver and date, and show the policy that applied to each group during the period under review. Confirm which settings your version exposes before you describe them in the analysis.

Backup records and restore tests

Keep the ipa-backup logs and a record of restore tests run against a non-production replica. A backup proves little until a restore has been tested, so document the date, the scope tested and the result. The backup documentation warns that restoring an outdated backup into an active replica topology can break replication, so the test record should show how that was prevented. Identity data is central to access control, so this evidence supports the availability of unique identities as well.

Audit log retention on servers and clients

Define how long authentication and administrative logs are kept on FreeIPA servers and on enrolled Linux clients, and where they are copied. Logs that show who logged in, which OTP was used and which administrator changed a policy are the records an investigator will request first. Confirm the retention period against your own HIPAA documentation policy, and check that clients forward logs before a host is rebuilt or removed.

Written risk analysis tying each control

Map each control above to 164.312(a)(2)(i) or 164.312(d), state the threat it addresses and the residual risk, and name the evidence that shows it operating. Record any addressable specification you decided not to implement, with the reason and the equivalent measure, as 164.306(d) requires. NIST SP 800-66 Rev. 2 gives key activities and sample questions for these standards that can structure the analysis. The analysis itself is the covered entity's document, so it should be reviewed and signed by the people accountable for it.

Configuring FreeIPA for unique identification and authentication

This sequence moves ePHI hosts from shared or local logins to named FreeIPA identities with OTP, host-based access control and tested recovery, and ends with a written record of the authentication options you evaluated. Each step produces evidence you can place in your risk analysis file.

  1. Inventory the systems that hold ePHI

    Before any configuration, the security or compliance lead and the system owners list every Linux host, database server, application server and backup target that creates, receives, maintains or transmits ePHI. Record the hostname, the application that uses it, who administers it and whether it is reached directly, through a bastion or through a remote access path. This list defines the scope of the HIPAA unique user identification work and becomes the first exhibit in your risk analysis. It is done when every ePHI system has an owner and an access path recorded, and the list has been reviewed against your data flow diagrams.

  2. Enroll ePHI hosts as SSSD clients

    The platform team enrolls each host from the inventory into the FreeIPA domain using the client installer, so that SSSD resolves named users and groups from the central directory and Kerberos tickets are issued by the IPA KDC. Confirm that DNS on each client points to at least two FreeIPA DNS servers, following the vendor's deployment recommendations. Done means that an enrolled host can resolve a test user by name and that a login with that user's own credentials succeeds and is recorded against that identity.

  3. Create one identity per person

    The identity administrator creates a single user entry for each workforce member, contractor and service owner who needs ePHI access, using the HR or sponsor record as the source. Each person gets one UID that is never reassigned, and group membership reflects the job role rather than the host. Confirm the naming rule in writing and check that no two people share a login. Done means a sample of accounts can be traced to a named person and an approved request.

  4. Disable or restrict shared and generic logins

    The platform team inventories local accounts, shared service logins and generic administrative names on the ePHI hosts, and either disables them, moves them to named service identities with an owner, or restricts their use to documented break-glass procedures. Where an application needs a service account, record the business owner and the reason it cannot use an individual identity. Done means a host-level account listing shows no unexplained shared login and the exceptions are documented with approvals.

  5. Enable OTP for privileged and remote access

    The identity administrator enrolls OTP tokens for administrators and for anyone who reaches ePHI systems from outside the internal network, using FreeIPA's HOTP or TOTP support with software or hardware tokens. Confirm with the vendor and your own testing which authentication paths enforce the second factor, such as SSH, console and Kerberos-based logins, and test each one. Done means a test login without the second factor is refused on the covered paths and a login with it succeeds, and the test results are saved.

  6. Set HBAC so only authorized users reach ePHI hosts

    The identity administrator builds host-based access control rules that tie each ePHI host or host group to the user groups approved for it, and removes the default allow-all rule on those hosts. Sudo rules are scoped the same way for administrative access. Test each rule with a user inside and outside the group. Done means an unauthorized user is denied on a test host, an authorized user is allowed, and the rule set is exported to your change records.

  7. Back up the FreeIPA topology and test restore

    The platform team runs ipa-backup on a schedule agreed with the business, stores the archives according to your retention policy, and performs a restore test in an isolated environment. The vendor's backup documentation warns that the first server handles certificate renewal and CRL publication by default, and that restoring an outdated backup into an active replica topology can break replication, so the restore procedure must follow that guidance. Done means a restore into a test environment completes, logins and HBAC rules work afterward, and the test record is filed.

  8. Document the authentication options evaluated

    The compliance lead records the authentication options considered for each ePHI system, following the NIST SP 800-66 Rev. 2 activities of determining where authentication applies, evaluating the available options and selecting and implementing them. Include the options you rejected, such as password only, FreeIPA OTP, RADIUS proxying to an existing server or smart cards, and the reason for each choice. Note any proposed HIPAA changes as proposals only. Done means the record is signed off by the security owner and linked from your risk analysis.

What FreeIPA does not cover for HIPAA

FreeIPA can give Linux systems that hold ePHI unique identities and strong authentication, but it does not reach every system, device, vendor or decision that the Security Rule touches. The cards below list the gaps your risk analysis and policies must cover before the identity design can support 164.312(a)(2)(i) and 164.312(d).

Application-level ePHI access

FreeIPA authenticates someone to the Linux host, but many clinical and billing applications keep their own user tables and roles. A shared application account, or a vendor login that bypasses the directory, can hide who viewed a record even when the host login was unique. Check which applications on each host authenticate through PAM, SSSD or Kerberos, and whether the application writes its own audit trail tied to the IPA username.

Workstations and mobile devices

Laptops, clinician tablets and phones that open ePHI but are not enrolled as FreeIPA clients fall outside the directory. Local accounts on these devices can be shared or unmanaged. Inventory every device class that reaches ePHI, decide which ones enroll, and document how the others are restricted or kept out of scope.

Business associate contracts

Under 164.314(a)(2)(i), a business associate that handles ePHI for you must agree to comply with the Security Rule and to report security incidents. If a hosting provider, managed service or support vendor can administer your FreeIPA servers or reach their Kerberos keys, that access must appear in the contract. Confirm who holds administrative accounts and how their access is authenticated and logged.

Risk analysis and policy decisions

FreeIPA implements choices, but it does not make them. Your risk analysis must decide which users need unique identities, which roles may share a workstation, how long a session stays open and who approves exceptions. These decisions belong in written policy, and the FreeIPA configuration should be traceable back to them. Keep the analysis current when systems or staff change.

Addressable specifications to document

Automatic logoff and encryption are addressable, so you must assess whether each is reasonable and appropriate, then document the decision and any equivalent measure. FreeIPA can enforce some session and password settings, but it does not decide whether those settings are adequate for your environment. Record the assessment for each host group, including why an alternative was chosen.

OTP rollout and the 2025 proposed rule

OTP tokens in FreeIPA are a factor you must issue, enroll, support and revoke. Lost tokens, lockouts and exceptions become a help desk process that needs written procedures. The January 2025 proposed rule would require multi-factor authentication on relevant systems, but it has not been finalized, so treat it as a planning input. Confirm your MFA expectations against the final rule text when it is published.

Questions buyers ask before hiring help with FreeIPA for HIPAA

Does HIPAA certify FreeIPA or our organization?

No. HIPAA has no certification. HHS states in its 2003 FAQ that no Security Rule standard requires an entity to certify compliance, that HHS does not endorse or recognize private certifications, and that a private certification does not stop HHS from later finding a violation. The same applies to FreeIPA: it is an open-source component you configure, and no product is "HIPAA certified." What you can show is how your configuration maps to the unique user identification and person or entity authentication standards, backed by your risk analysis and the evidence it produces. The HHS Office for Civil Rights enforces the rule through complaints, compliance reviews and audits, so your records need to support your own compliance position.

How much effort does FreeIPA for HIPAA take, and what drives it?

Effort depends mostly on how many Linux systems hold ePHI, how many of them already have local accounts, and how much of the access model is undocumented. The work splits into one-time design and build (server topology, client enrollment, password and OTP policy, host-based access rules, sudo rules and evidence collection) and recurring operations (account joiners and leavers, token lifecycle, backups, upgrades and periodic access reviews). Ask any provider for a quote that lists:

  • The systems in scope and how each is enrolled
  • Whether MFA covers all users or only remote or privileged access
  • Whether existing accounts must be migrated or re-created
  • Who writes the evidence pack and who signs off on the risk analysis

We do not estimate DeployOpen's fees here. A fixed-scope quote follows from a written scope.

Can our internal team implement FreeIPA for HIPAA on its own?

Often yes, if the team already runs Linux, DNS, certificates and directory services and can dedicate time to the project. The skills most often missing are replication design, Kerberos and SSSD troubleshooting, and the documentation auditors ask for. FreeIPA's deployment recommendations call for dedicated servers, at least two to three replicas in each datacenter, and at least two DNS servers in each client's resolv.conf, so a first build needs careful planning. Backups also need care: the backup documentation warns that restoring an outdated backup into an active replica topology can break replication. Decide early whether your team will own build, operations, or both, and whether an outside partner will review the design before go-live.

What does the work need from our organization before it starts?

Three inputs matter most. First, a system inventory listing every Linux host, service account and application that stores or transmits ePHI, along with the owner of each. Second, a documented access model: who needs access, from where, with what role, and which hosts they may reach. Third, a named owner for the risk analysis. HIPAA requires you to assess your own risks, and that owner must make decisions about addressable specifications and document any equivalent alternatives. The owner should also decide how user identifiers will be assigned and retired. Prepare the existing directory state, any LDAP or Active Directory dependencies, and the change window for cutover. These inputs shape scope more than any technical choice does.

How long does a FreeIPA for HIPAA project take?

Duration depends on scope: the number of systems and sites, whether existing accounts must migrate, whether OTP or smart cards are required for remote access, and how quickly your change board approves cutover. No duration is set by the Security Rule itself, and this page does not give a timeline. A narrow scope, such as one server group with new enrollments, moves faster than a multi-site estate with legacy LDAP users, sudo and host-based access rules to migrate by hand. Ask for a phased plan with a written milestone for each: design sign-off, pilot enrollment, production cutover, evidence collection and handover. Timelines in a fixed-scope agreement should follow from that written scope.

What changes if the 2025 proposed HIPAA Security Rule is finalized?

The change would be significant, but it is not yet law. HHS proposed a major Security Rule revision on January 6, 2025 (90 FR 898), which would rename the authentication standard and require multi-factor authentication on all technology assets in relevant electronic information systems, with limited exceptions. As of October 2026, no final rule has been published, and the latest Unified Agenda lists final action for July 2027. Until then, the current standards in 45 CFR 164.312 apply. Design your FreeIPA estate so MFA can be extended to more accounts and hosts without a rebuild, for example by using OTP or smart cards as a standard option. Confirm the final text and its effective date with counsel before changing commitments.

Who owns the evidence for unique user identification and authentication?

Your organization owns the evidence, and the partner helps produce it. Evidence usually includes a list of unique FreeIPA identities, a record of how shared or service accounts are controlled, the password and OTP policy settings in force, host access rules, sudo rules, enrollment records, and the access review history. The risk analysis and the decisions taken on each addressable specification remain your documents. Ask whether the partner will supply configuration exports and a runbook, and who keeps them current after handover. Independent auditors and certification bodies assess compliance where they are engaged, so align the evidence format with what your assessor will request.

How DeployOpen scopes and delivers FreeIPA compliance configuration

DeployOpen plans, implements, hardens, documents and supports FreeIPA inside your own infrastructure, including the identity configuration behind HIPAA unique user identification and authentication on Linux systems that hold ePHI. Engagements start from a written scope, so the controls, evidence and handover items are agreed before any build work begins.

How we scope

  • Inventory the Linux hosts, applications and databases that hold or reach ePHI, and map which accounts reach them.
  • Agree in writing which FreeIPA servers, clients, OTP or smart card flows and password policies are in scope.
  • Record which HIPAA specifications your risk analysis treats as required and which need a documented decision.

How we build

  • Configure one unique FreeIPA identity per person, with no shared login accounts for ePHI systems.
  • Set up Kerberos, OTP enrollment and host access rules, then test each ePHI system against those rules.
  • Verify through named test cases, including denied access for a disabled or unenrolled account.

How we hand over

  • Deliver configuration records, runbooks and an evidence pack that maps each control to its HIPAA citation.
  • Document the joiner, mover and leaver steps your administrators run in FreeIPA after go-live.
  • Walk your security and compliance staff through the evidence so they can present it to their own risk analysis.

How we support

  • Support, upgrades and periodic review of FreeIPA configuration are available as a retainer.
  • Track FreeIPA release notes and security updates, and agree in writing how each update is tested before rollout.
  • Confirm with your compliance team and your assessors which evidence they need, since DeployOpen does not issue audit reports or certifications.

Sources and further reading

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.