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…
KB00007629 Combined Realm for AD/LDAP
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 with LDAP
Integrating Ephesoft with LDAP
This wiki article focus on providing detailed explanation on how to integrate Ephesoft with LDAP. This article focuses on detailed explanation of each property used in order to successfully configure Ephesoft with LDAP.
In Ephesoft we basically have to focus on 3 properties file mentioned as below:
server.xml
user-connectivity.properties…
KB00022567: 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: [LDAP: error code 34 - invalid DN]
at com.sun.jndi.ldap.LdapCtx.processReturnCode(LdapCtx.java:3095)
at…
KB00022563: 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
[LDAP: error code 49 - 80090308: LdapErr: DSID-0C09042F, comment: AcceptSecurityContext error, data 532, v2580 ]
javax.naming.AuthenticationException: [LDAP: error code 49 - 80090308: LdapErr:…
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: [server name]:636 [Root exception is javax.net.ssl.SSLHandshakeException:…
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…
Linux Installation Guide 2020.1.03
Introduction
This document describes how to install Ephesoft Transact 2020.1.03 in the following environments:
Environment types — single or multi-server
Operating System — Red Hat Enterprise Linux (RHEL) 7.5 or 7.6
Note: Ephesoft Transact 2020.1.03 is only supported for these Linux distributions. Do not run the yum update command, as this updates RHEL to an unsupported version. Refer…
Windows Upgrade Guide 2020.1.03
Introduction
This document describes how to upgrade to Ephesoft Transact 2020.1.03 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 2020.1.03 follows this general…
Windows Installation Guide 2020.1.03
Introduction
This document describes how to install Ephesoft Transact 2020.1.03 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.03 follows this general…
Linux Upgrade Guide 2020.1.03
Introduction
This document describes how to upgrade Ephesoft Transact 2020.1.03 in the following environments:
Environments — single or multi-server
Operating system — Red Hat Enterprise Linux (RHEL) 7.5 or 7.6
Note: Ephesoft Transact 2020.1.03 is only supported for these Linux distributions. Do not run the yum update command, as this updates RHEL to an unsupported version. Refer to…
Linux Upgrade Guide 2020.1.02
Introduction
This document describes how to upgrade Ephesoft Transact 2020.1.02 in the following environments:
Environments — single or multi-server
Operating system — Red Hat Enterprise Linux (RHEL) 7.5 or 7.6
Note: Ephesoft Transact 2020.1.02 is only supported for these Linux distributions. Do not run the yum update command, as this updates RHEL to an unsupported version. Refer to…
Linux Installation Guide 2020.1.02
Introduction
This document describes how to install Ephesoft Transact 2020.1.02 in the following environments:
Environment types — single or multi-server
Operating System — Red Hat Enterprise Linux (RHEL) 7.5 or 7.6
Note: Ephesoft Transact 2020.1.02 is only supported for these Linux distributions. Do not run the yum update command, as this updates RHEL to an unsupported version. Refer…
Windows Upgrade Guide 2020.1.02
Introduction
This document describes how to upgrade to Ephesoft Transact 2020.1.02 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 2020.1.02 follows this general…
Windows Installation Guide 2020.1.02
Introduction
This document describes how to install Ephesoft Transact 2020.1.02 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.02 follows this general…
Known Issues and Workarounds 2020.1.02
The following is a list of known issues for which a workaround is provided.
Category
Known Issue
Workaround
Batch Class Import
If you are importing a batch class that creates or updates global document types in the global batch class, the import process will fail if there is a local document type in the Global Batch Class (BC0).
Importing will succeed if all local document types…
Platform Configurations and Third-Party Integrations
This page lists the operating systems, databases, and third-party integrations supported for each version of Ephesoft Transact. Other environments that have not been tested may still be compatible. Contact tickets@ephesoft.com for more information.
Refer to your version of Ephesoft Transact for detailed information. For minor versions, refer to the associated major version.
Ephesoft…