LDAP and OpenLDAP Resources

This section includes resources for using LDAP or OpenLDAP as your directory services protocol with Transact. Refer to the following articles for more information: Add Users to LDAP Using Java Common LDAP Errors How to Create a User in OpenLDAP How to Configure OpenLDAP Integrating Ephesoft with LDAP

OpenLDAP: Separate Installation

Applies to: Fresh installation of Ephesoft Transact 2020.1.02 or above using LDAP. Introduction This document is a guide for installing OpenLDAP separately from Ephesoft Transact. Background Several Microsoft Visual C++ Redistributables were removed from the installer, as they were either at end of life (EOL) or posed security risks. This includes: Microsoft Visual C++ 2008 Microsoft…

Combined Realm for AD/LDAP Limitations to Service

Applies to: All versions of Ephesoft Transact Issue In some cases, the group and users search in LDAP can’t find users and groups unless there are specific context paths entered in the configuration. This required listing all organizational units (OU) that contain the authorized users and groups. Combined realms are used particularly when you have multiple OUs that need to be looked at to…

Integrating Ephesoft Transact with LDAP

This article provides the configuration steps to integrate Transact with LDAP. In Ephesoft Transact, there are three properties files that you will need to configure: server.xml user-connectivity.properties application.properties What is required to configure Ephesoft Transact with LDAP? In order to successfully integrate Ephesoft Transact with LDAP, it becomes essential to…

javax.naming.InvalidNameException: [LDAP: error code 34 – invalid DN]

Affected Version: 4501 Component: OpenLDAP 2.4 Issue Description: After upgrading Ephesoft 4500 to 4501 and then trying to connect to LDAP that ephesoft provides we see an error "Error 34 : Invalid DN"   Exception: javax.naming.InvalidNameException:  at com.sun.jndi.ldap.LdapCtx.processReturnCode(LdapCtx.java:3095) at…

javax.naming.AuthenticationException: [LDAP: error code 49 – 80090308: LdapErr: DSID-0C09042F, comment: AcceptSecurityContext error, data 532, v2580 ]

Applies to: All Ephesoft versions configured with LDAP / AD Issue: If you are not able to log into your Ephesoft system and are using LDAP authentication and getting below error all of a sudden javax.naming.AuthenticationException: Root Cause: Password expiration / user locked for user which you are trying to login with or which is mentioned in server.xml and…

KB0018649 : Encryption over LDAPS : ERROR: salt parameter must not be empty

Issue Identified In : 4120 Issue Fixed In: 4.5 Environment : Linux, Windows Problem: Randomly getting the “salt parameter must not be empty” error after using Ephesoft for some time. Unable to Login to Ephesoft after seeing “salt parameter must not be empty” when Ephesoft is configured over LDAPS with Encryption ON. Root Cause: We have observed that due to some reason…

Troubleshooting LDAPS Authentication

Applies to: Ephesoft Transact 4.0.0.0 and above Issue LDAP authentication over SSL (LDAPS) fails due to “Invalid Credentials: Error code 49”. When the server tries to connect, the following error can be seen in the catalina.out log file: javax.naming.CommunicationException: simple bind failed: :636 Root Cause There are a few reasons why this may occur: The credentials could be…

LDAP/AD Password Encryption

Follow the steps below to enable LDAP/AD password encryption in Ephesoft Transact. Note the following files will require changes: server.xml located at Ephesoft\JavaAppServer\conf\ user-connectivity.properties located at \Ephesoft\Application\WEB-INF\classes\META-INF\dcma-user-connectivity dcma-ftp.properties located at \Ephesoft\Application\WEB-INF\classes\META-INF\dcma-ftp…

Add Users to LDAP Using Java

Topic : Adding users to LDAP using a Java Class Applicable Ephesoft versions: Normally LDAP requires the user to log in to the LDAP database with the jxplorer application. By using the Java class provided, you can add users by altering the user details in the .java file below. Download: AddEntryToLDAP.java Instructions: There are two methods of executing this .java file.…

Disabling Anonymous Access to the OpenLDAP Directory

Applies to: All versions of Ephesoft Transact The following steps describe how to disable anonymous access to the OpenLDAP directory. This is recommended if you are using LDAP as your authentication method and have security concerns regarding anonymous access. Configuration Perform the following steps to disable anonymous access: Stop Ephesoft Transact. Open the slapd.conf file,…

How to Configure Active Directory Using the Standard LDAP Service Port

By default, MS Active Directory supports all LDAP connections using the Standard 389 port. You can configure Ephesoft to do the same by following the instructions below. Applicable Ephesoft versions: Ephesoft v4.x and up 1. First you have to configure the Active Directory to pull the groups so you can set the role(s) for the batch classes. To do this you will modify the…

How To Configure OpenLDAP

Topic: OpenLDAP Software is a free, open source implementation of the Lightweight Directory Access Protocol (LDAP) developed by the OpenLDAP Project. It is released under its own BSD-style license called the OpenLDAP Public License. LDAP is a platform-independent protocol. To connect to the Ephesoft LDAP database and modify groups, users, permissions, etc administrators can utilize the bundled…

How to Create a User in OpenLDAP

You can create new accounts in LDAP using jexplorer located in the following location Ephesoft\Dependencies\OpenLDAP\ldap-client\jxplorer-3.2.1 Run the jexplorer.bat and load the preset connection info. The password for the manager account is "secret". Ephesoft can also be integrated with Active Directory. If you are creating new user accounts you will also have to add them to…

Windows Upgrade Guide 2022.1.01

Introduction This document describes how to upgrade to Ephesoft Transact 2022.1.01 in the following environments: Environment types — single and multi-server Operating System — Windows® Important: Steps unique to a multi-server upgrade are identified where applicable in this document. Upgrade Overview The process of upgrading to Ephesoft Transact 2022.1.01 follows this general…

Windows Installation Guide 2022.1.01

Introduction This document describes how to install Ephesoft Transact in the following environments: Environment types — single and multi-server Operating System — Windows® Important: Steps unique to a multi-server installation are identified where applicable in this document. Installation Overview The process of installing Ephesoft Transact follows this general sequence of tasks.…

Linux Upgrade Guide 2022.1.01

Introduction This document describes how to upgrade Ephesoft Transact 2022.1.01 in the following environments: Environments — single or multi-server Operating system — Red Hat Enterprise Linux (RHEL) Refer to Platform Configurations and Third-Party Integrations for information on supported versions. Note: Ephesoft Transact 2022.1.01 is only supported for these Linux distributions.…

Linux Installation Guide 2022.1.01

Introduction This document describes how to install Ephesoft Transact 2022.1.01 in the following environments: Environment types — single or multi-server Operating System — Red Hat Enterprise Linux (RHEL) Refer to Platform Configurations and Third-Party Integrations for information on supported versions. Installation types — normal or silent Installation Overview The…

Windows Installation Guide 2022.1.00

Introduction This document describes how to install Ephesoft Transact 2022.1.00 in the following environments: Environment types — single and multi-server Operating System — Windows® Important: Steps unique to a multi-server installation are identified where applicable in this document. Installation Overview The process of installing Ephesoft Transact 2022.1.00 follows this general…

Linux Installation Guide 2022.1.00

Introduction This document describes how to install Ephesoft Transact 2022.1.00 in the following environments: Environment types — single or multi-server Operating System — Red Hat Enterprise Linux (RHEL) Refer to Platform Configurations and Third-Party Integrations for information on supported versions. Installation types — normal or silent Installation Overview The…

Linux Upgrade Guide 2022.1.00

Introduction This document describes how to upgrade Ephesoft Transact 2022.1.00 in the following environments: Environments — single or multi-server Operating system — Red Hat Enterprise Linux (RHEL) Refer to Platform Configurations and Third-Party Integrations for information on supported versions. Note: Ephesoft Transact 2022.1.00 is only supported for these Linux…

Windows Upgrade Guide 2022.1.00

Introduction This document describes how to upgrade to Ephesoft Transact 2022.1.00 in the following environments: Environment types — single and multi-server Operating System — Windows® Important: Steps unique to a multi-server upgrade are identified where applicable in this document. Upgrade Overview Known Issue: When upgrading Transact from version 2020.1.05 to version 2022.1.00,…

Windows Installation Guide 2020.1.06

Introduction This document describes how to install Ephesoft Transact 2020.1.06 in the following environments: Environment types — single and multi-server Operating System — Windows® Important: Steps unique to a multi-server installation are identified where applicable in this document. Installation Overview The process of installing Ephesoft Transact 2020.1.06 follows this general…

Windows Upgrade Guide 2020.1.06

Introduction This document describes how to upgrade to Ephesoft Transact 2020.1.06 in the following environments: Environment types — single and multi-server Operating System — Windows® Important: Steps unique to a multi-server upgrade are identified where applicable in this document. Upgrade Overview Known Issue: When upgrading Transact from version 2020.1.05 to version 2020.1.06,…