9.1.4. Authenticating EKM Logins to the Linux Operating System

The operating system of the server on which EKM is installed is detected automatically during installation. If you have installed EKM on a Linux server and want to authenticate users to the Linux operating system, there is nothing you need to do to enable this behavior. The LinuxLoginModule has already been enabled in the JBoss domain configuration, as shown below:

<subsystem xmlns="urn:jboss:domain:security:1.2">
  <security-domains>
    <security-domain name="other" cache-type="default">
      <authentication>
        ...
        ...
        <login-module code="com.ansys.ingress.core.security.LinuxLoginModule" flag="requisite" />

LinuxLoginModule uses PAM (Pluggable Authentication Modules) to authenticate EKM users to the operating system. LinuxLoginModule uses the sshd PAM service configuration by default. To use a different PAM service configuration, specify a module option named pam_service_name with a value of the PAM service name whose configuration you wish to use. For example, to use the configuration for the login service (typically stored at /etc/pam.d/login), use the following LinuxLoginModule configuration:

<login-module code="com.ansys.ingress.core.security.LinuxLoginModule" flag="requisite">
  <module-option name="pam_service_name" value="login" />
</login-module>

The EKM server account needs access to certain operating system files in order to use LinuxLoginModule. This access is configured when creating the EKM server account, as instructed in Create an EKM Server Account.


Release 18.2 - © ANSYS, Inc. All rights reserved.