Verify that you have already installed the following prerequisite software packages:
Note:

Installation from operating system-specific source packages is covered here:

Red Hat: Installation example for Red Hat

Ubuntu/Debian: Installation example for Ubuntu/Debian (64 bit)

Solaris: Installation example for Solaris

Follow the steps shown below for other Unix/Linux flavors.

Install PingID SSH from the source package:

  1. Get the latest version of the package from https://www.pingidentity.com/en/resources/downloads/pingid.html
  2. Extract the package.
  3. Go to the directory of the extracted PingID package:

    cd pingid-<version>

  4. Run the configuration utility:

    ./configure --with-pam --prefix=/usr

    In CentOS 7 & RHEL 7, when SELinux is installed, you might need to add this parameter to the configure command: --enable-selinux See SELinux section in PingID SSH support information

    Note:

    When running the ./configure command, there is an option to specify that the use_base64_key field in the PingID properties file should be obfuscated.

    To use this option, include the --with-obfuscation switch.

    If you have openssl and base64 installed, the key required for obfuscation will be generated automatically so you can just use the following syntax:

    ./configure --with-obfuscation

    If you don't have openssl and base64 installed, this command will result in an error message. In this case, you can generate the key manually and then use --with-obfuscation as follows:

    ./configure --with-obfuscation=<keyToUse>

  5. Build and install PingID SSH:

    make

    sudo make install

    The following files will be installed, assuming the configure command was executed with the --prefix=/usr parameter:

    • /usr/sbin/pingid_fc

    • /usr/etc/pingid/pingid.conf

      (/etc/pingid/pingid.conf on FHS compliant systems)

    • If PAM was enabled:

      • /lib64/security/pam_pingid.so

        or

      • /lib/security/pam_pingid.so

      depending on the platform architecture.

    For more about installation directories, see autoconf installation directories.

  6. Test the installation:

    pingid_fc -v

    You should see output similar to the following:

    PingID API version 4.0 (Package version 4.0.7)
Configuration file: /usr/etc/pingid/pingid.conf
  7. Download the relevant PingID properties file (see Obtaining the PingID properties file for SSH).
  8. Copy the properties file to /usr/etc/pingid/pingid.properties
    For example:
    sudo cp pingid.properties /usr/etc/pingid/pingid.properties
    Important: Do not make any changes to the contents of the file.