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…
Common LDAP Errors
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,…