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…

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…