OpenEMR and Active Directory Integration

OpenEMR Development
8

Hi Shivm,

I just got this working not too long ago.

For context my setup is OpenEMR 5.0.1 hosted on Ubuntu 18.04 and I have a Windows Server 2016 Active Directory.

Here is what I did:

  • Step 1: Logged into my Active Directory Domain Controller and added a user:
    • Name (can be anything): OpenEMR admin
    • User logon name: admin
    • Password: [new admin password]
  • Step 2: Logged into the EMR with EMR admin account and set Administration/Globals checked the “Use Active Directory” with the same set-up you had.
    image
  • Step 3: I then hit save and it will prompt you to log back into the EMR. This time, log in with the password you set in the Active Directory in step 1.
    • User logon name: admin
    • Password: [new admin password]
  • Step 4: Now, to add users, they need to be in BOTH the Active Directory AND in the EMR as users. The Active Directory does not credential users access within the EMR. So add the user you want in the EMR with the correct level of access
    • Username: Doctor01
    • Password: [Random Password]
  • Step 5: Then I logged into my Active Directory Domain Controller and added the user to the Active Directory
    • Name: Doctor 01
    • User login name: Doctor01
    • Password: [Doctor’s Domain Login Password]
  • Step 6: Login to the EMR as user Doctor01 using the password you just made in the Active Directory
    • User login name: Doctor01
    • Password: [Doctor’s Domain Login Password]

One additionally item, to make the EMR users easier to manage long term, you can also add groups to the Active Directory settings in OpenEMR and add users to those groups, that way you can add and remove access to the domain via that group management from the Active Directory side.

This can be done by making a group such as “Users” in the Activey Directory on the Domain Controller, and then setting the “Active Directory – Domain Base” to CN=Users,DC=example,DC=com

Hope this makes sense. If you need further assistance, I can set up a dev EMR example and screenshot the steps involved.

2 Likes