Web Agents

Requirements

Ping Identity supports customers using the versions specified here. Other versions and alternative environments might work as well. When opening a support ticket for an issue, however, make sure you can also reproduce the problem on a combination covered here.

Special requests

If you have a special request regarding support for a combination not listed here, contact support.

Supported Clients

Supported clients
Client Platform Native Apps(1) Chrome(2) Edge(2) Firefox(2) Safari(2) Mobile Safari

Windows 8

Windows 10

Mac OS X 10.11 or later

Ubuntu 14.04 LTS or later

iOS 9 or later

Android 6 or later

(1) Native Apps is a placeholder to indicate the platform is not limited to browser-based technologies. An example of a native app would be something written to use common REST APIs.

(2) Latest stable versions are supported.

AM requirements

  • Web Agent supports AM 6.5 and later.

  • Web Agent requires the WebSocket protocol to communicate with AM. Both the web server and the network infrastructure must support the WebSocket protocol. For example, Apache HTTP server requires the proxy_wstunnel_module for proxying the WebSocket protocol.

    Refer to your network infrastructure and web server documentation for more information about WebSocket support.

SSL requirements

To secure communications such as the connection to AM through the WebSocket protocol, agents require OpenSSL or the Windows built-in Secure Channel API.

To define the protocol versions allowed in your environment, configure the Security Protocol List.

TLS requirements

Agent version Supported and enabled by default Supported but disabled by default

2024.9

TLSv1.3, TLSv1.2

TLSv1.1, TLSv1.0

2024.6

TLSv1.3, TLSv1.2

TLSv1.1, TLSv1.0

2024.3

TLSv1.3, TLSv1.2

TLSv1.1, TLSv1.0

2023.11

TLSv1.3, TLSv1.2

TLSv1.1, TLSv1.0, SSLv3(1)

2023.9

TLSv1.3, TLSv1.2

TLSv1.1, TLSv1.0, SSLv3

2023.6

TLSv1.3, TLSv1.2

TLSv1.1, TLSv1.0, SSLv3

2023.3

TLSv1.3, TLSv1.2

TLSv1.1, TLSv1.0, SSLv3

(1)Not supported after Web Agent 2023.11.

OpenSSL requirements

Agent version Operating system OpenSSL version

2024.9

CentOS
Red Hat Enterprise Linux
Oracle Linux
Amazon Linux
Ubuntu Linux
Rocky Linux

3.3.x, 3.2.x, 3.1.x, 3.0.x, 1.1.1(1)

Microsoft Windows Server(2)

3.3.x, 3.2.x, 3.1.x, 3.0.x, 1.1.1(1)

IBM AIX

3.3.x, 3.2.x, 3.1.x, 3.0.x, 1.1.1(1)

2024.6

CentOS
Red Hat Enterprise Linux
Oracle Linux
Amazon Linux
Ubuntu Linux
Rocky Linux

3.3.x, 3.2.x, 3.1.x, 3.0.x, 1.1.1(1)

Microsoft Windows Server(2)

3.3.x, 3.2.x, 3.1.x, 3.0.x, 1.1.1(1)

IBM AIX

3.3.x, 3.2.x, 3.1.x, 3.0.x, 1.1.1(1)

2024.3

CentOS
Red Hat Enterprise Linux
Oracle Linux
Amazon Linux
Ubuntu Linux

3.2.x, 3.1.x, 3.0.x, 1.1.1

Microsoft Windows Server(2)

3.2.x, 3.1.x, 3.0.x, 1.1.1

IBM AIX

3.2.x, 3.1.x, 3.0.x, 1.1.1

2023.11-2023.3

CentOS
Red Hat Enterprise Linux
Oracle Linux
Amazon Linux
Ubuntu Linux

3.0.x, 1.1.1

Microsoft Windows Server(2)

3.0.x, 1.1.1

IBM AIX

3.0.x, 1.1.1

5.10

CentOS
Red Hat Enterprise Linux
Oracle Linux
Amazon Linux
Ubuntu Linux

3.0.x, 1.1.1, 1.1.0(3), 1.0.x(3)

Microsoft Windows Server(2)

3.0.x, 1.1.1, 1.1.0(3), 1.0.x(3)

IBM AIX

3.0.x, 1.1.1, 1.1.0(3), 1.0.x(3)

5.9

CentOS
Red Hat Enterprise Linux
Oracle Linux
Amazon Linux
Ubuntu Linux

1.1.1, 1.1.0, 1.0.x

Microsoft Windows Server(2)

1.1.1, 1.1.0, 1.0.x

IBM AIX

1.1.1, 1.1.0, 1.0.x

(1)Support to be discontinued in a future release.
(2)On Windows, Web Agent uses the Windows built-in Secure Channel API by default.
(3)Not supported after Web Agent 5.10.

Platform requirements

  • Web Agent supports only 64-bit architectures.

  • IIS Web Agent supports 64-bit and 32-bit application pools.

Supported operating systems and web servers Web Agent 2024.9

Operating systems OS versions Web servers & minimum supported versions
  • CentOS Linux(1)

  • 7(2)

  • Apache HTTP Server 2.4

  • Red Hat JBoss Core Services (Red Hat Enterprise Linux only)

  • IBM HTTP Server 8.5, 9

  • NGINX Plus R30, R31, R32

  • Red Hat Enterprise Linux

  • Oracle Linux

  • 7(2)

  • 8

  • 9

  • Amazon Linux

  • 2

  • 2023

  • Ubuntu Linux

  • 20.04 LTS

  • 22.04 LTS

  • 24.04 LTS

  • Rocky Linux

  • 8

  • 9

  • SUSE Linux Enterprise

  • 15

  • Apache HTTP Server 2.4

  • Microsoft Windows Server

  • 2016(2)

  • 2019

  • 2022

  • Apache HTTP Server 2.4(3)

  • Microsoft IIS 10

  • ISAPI

  • IBM AIX

  • 7

  • IBM HTTP Server 9

(1)Learn about which version of CentOS to use with the listed NGINX Plus from the NGINX Plus documentation.
(2)Support to be discontinued in a future release.
(3)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge.

Supported operating systems and web servers Web Agent 2024.6

Operating systems OS versions Web servers & minimum supported versions
  • CentOS Linux(1)

  • 7(2)

  • Apache HTTP Server 2.4

  • Red Hat JBoss Core Services (Red Hat Enterprise Linux only)

  • IBM HTTP Server 8.5, 9

  • NGINX Plus R30, R31, R32

  • Red Hat Enterprise Linux

  • Oracle Linux

  • 7(2)

  • 8

  • 9

  • Amazon Linux

  • 2

  • 2023

  • Ubuntu Linux

  • 20.04 LTS

  • 22.04 LTS

  • 24.04 LTS

  • Rocky Linux

  • 8

  • 9

  • SUSE Linux Enterprise

  • 15

  • Apache HTTP Server 2.4

  • Microsoft Windows Server

  • 2016(2)

  • 2019

  • 2022

  • Apache HTTP Server 2.4(3)

  • Microsoft IIS 10

  • ISAPI

  • IBM AIX

  • 7

  • IBM HTTP Server 9

(1)Learn about which version of CentOS to use with the listed NGINX Plus from the NGINX Plus documentation.
(2)Support to be discontinued in a future release.
(3)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge.

Supported operating systems and web servers Web Agent 2024.3

Operating systems OS versions Web servers & minimum supported versions
  • CentOS Linux(1)

  • 7(2)

  • Apache HTTP Server 2.4

  • Red Hat JBoss Core Services (Red Hat Enterprise Linux only)

  • IBM HTTP Server 8.5, 9

  • NGINX Plus R30, R31

  • Red Hat Enterprise Linux

  • Oracle Linux

  • 7(2)

  • 8

  • 9

  • Amazon Linux

  • 2

  • 2023

  • Ubuntu Linux

  • 20.04 LTS

  • 22.04 LTS

  • SUSE Linux Enterprise

  • 15

  • Apache HTTP Server 2.4

  • Microsoft Windows Server

  • 2016(2)

  • 2019

  • 2022

  • Apache HTTP Server 2.4(3)

  • Microsoft IIS 10

  • ISAPI

  • IBM AIX

  • 7

  • IBM HTTP Server 9

(1)For information about which version of CentOS to use with the listed NGINX Plus, refer to the NGINX Plus documentation.
(2)Support to be discontinued in a future release.
(3)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge.

Supported operating systems and web servers Web Agent 2023.11

Operating systems OS versions Web servers & minimum supported versions
  • CentOS Linux(1)

  • 7(2)

  • Apache HTTP Server 2.4

  • Red Hat JBoss Core Services (Red Hat Enterprise Linux only)

  • IBM HTTP Server 8.5, 9

  • NGINX Plus R25(2), R26(2), R27(2), R28(2), R29(2), R30

  • Red Hat Enterprise Linux

  • Oracle Linux

  • Amazon Linux 2

  • 7(2)

  • 8

  • 9

  • Ubuntu Linux

  • 18.04 LTS(2)

  • 20.04 LTS

  • 22.04 LTS

  • SUSE Linux Enterprise

  • 15

  • Apache HTTP Server 2.4

  • Microsoft Windows Server

  • 2016, 2019, 2022

  • Apache HTTP Server 2.4(3)

  • Microsoft IIS 10

  • IBM AIX

  • 7

  • IBM HTTP Server 9

(1)For information about which version of CentOS to use with the listed NGINX Plus, refer to the NGINX Plus documentation.
(2)Support to be discontinued in a future release.
(3)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge.

Supported operating systems and web servers Web Agent 2023.9

Operating systems OS versions Web servers & minimum supported versions
  • CentOS Linux(1)

  • 7(2)

  • Apache HTTP Server 2.4

  • Red Hat JBoss Core Services (Red Hat Enterprise Linux only)

  • IBM HTTP Server 8.5, 9

  • NGINX Plus R25(2), R26(2), R27(2), R28(2), R29, R30

  • Red Hat Enterprise Linux

  • Oracle Linux

  • Amazon Linux 2

  • 7(2)

  • 8

  • 9

  • Ubuntu Linux

  • 18.04 LTS(2)

  • 20.04 LTS

  • 22.04 LTS

  • SUSE Linux Enterprise

  • 15

  • Apache HTTP Server 2.4

  • Microsoft Windows Server

  • 2016, 2019, 2022

  • Apache HTTP Server 2.4(3)

  • Microsoft IIS 10

  • IBM AIX

  • 7

  • IBM HTTP Server 9

(1)For information about which version of CentOS to use with the listed NGINX Plus, refer to the NGINX Plus documentation.
(2)Support to be discontinued in a future release.
(3)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge.

Supported operating systems and web servers Web Agent 2023.6

Operating systems OS versions Web servers & minimum supported versions
  • CentOS(1)

  • 7(2)

  • Apache HTTP Server 2.4

  • IBM HTTP Server 9

  • NGINX Plus R25(2), R26(2), R27(2), R28, R29

  • Red Hat Enterprise Linux

  • Oracle Linux

  • Amazon Linux 2

  • 7(2)

  • 8

  • 9

  • Ubuntu Linux

  • 18.04 LTS(2)

  • 20.04 LTS

  • 22.04 LTS

  • SUSE Linux Enterprise

  • 15

  • Apache HTTP Server 2.4

  • Microsoft Windows Server

  • 2016, 2019, 2022

  • Apache HTTP Server 2.4(3)

  • Microsoft IIS 10

  • IBM AIX

  • 7

  • IBM HTTP Server 9

(1)For information about which version of CentOS to use with the listed NGINX Plus, refer to the Nginx Plus documentation.
(2)Support to be discontinued in a future release.
(3)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge.

Supported operating systems and web servers Web Agent 2023.3

Operating systems OS versions Web servers & minimum supported versions
  • CentOS(1)

  • 7(2)

  • Apache HTTP Server 2.4

  • IBM HTTP Server 9

  • NGINX Plus R25(2), R26, R27, R28

  • Red Hat Enterprise Linux

  • Oracle Linux

  • Amazon Linux 2

  • 7(2)

  • 8

  • 9

  • Ubuntu Linux

  • 18.04 LTS(2)

  • 20.04 LTS

  • 22.04 LTS

  • SUSE Linux Enterprise

  • 15

  • Apache HTTP Server 2.4

  • Microsoft Windows Server

  • 2016, 2019, 2022

  • Apache HTTP Server 2.4(3)

  • Microsoft IIS 10

  • IBM AIX

  • 7

  • IBM HTTP Server 9

(1)For information about which version of CentOS to use with the listed NGINX Plus, refer to the NGINX Plus documentation.
(2)Support to be discontinued in a future release.
(3)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge.

Supported operating systems and web servers Web Agent 5.10

Operating systems OS versions Web servers & minimum supported versions
  • Amazon Linux 2

  • Oracle Linux

  • Red Hat Enterprise Linux

  • 7

  • 8

  • Apache HTTP Server 2.4

  • IBM HTTP Server 9

  • NGINX Plus R23(1), R24(1), R25, R26, R27

  • CentOS

  • 7

  • 8(1)

  • Apache HTTP Server 2.4

  • IBM HTTP Server 9

  • NGINX Plus R23(1), R24(1), R25, R26, R27

  • Ubuntu Linux

  • 18.04 LTS

  • 20.04 LTS

  • Apache HTTP Server 2.4

  • IBM HTTP Server 9

  • NGINX Plus R23(1), R24(1), R25, R26, R27

  • 22.04 LTS

  • Apache HTTP Server 2.4

  • IBM HTTP Server 9

  • IBM AIX

  • 7

  • IBM HTTP Server 9

  • Microsoft Windows Server

  • 2012 R2(1)

  • Apache HTTP Server 2.4(2)

  • Microsoft IIS 8.5

  • 2016, 2019, 2022

  • Apache HTTP Server 2.4,(2)

  • Microsoft IIS 10

(1)Support to be discontinued in a future release.

(2)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge

Supported operating systems and web servers Web Agent 5.9

Operating Systems OS Versions Web Servers & Minimum Supported Versions
  • Amazon Linux 2

  • CentOS

  • Oracle Linux

  • Red Hat Enterprise Linux

  • 7

  • 8

  • Apache HTTP Server 2.4

  • IBM HTTP Server 9

  • NGINX Plus R22(1)

  • NGINX Plus R23, R24, R25

  • Ubuntu Linux

  • 18.04 LTS

  • 20.04 LTS

  • Apache HTTP Server 2.4

  • IBM HTTP Server 9

  • NGINX Plus R22(1)

  • NGINX Plus R23, R24, R25

  • IBM AIX

  • 7

  • IBM HTTP Server 9

  • Microsoft Windows Server

  • 2012 R2(1)

  • Apache HTTP Server 2.4(1)(2)

  • Microsoft IIS 8.5(1)

  • 2016

  • Apache HTTP Server 2.4,(2)

  • Microsoft IIS 10

  • 2019

  • Apache HTTP Server 2.4(2)

  • Microsoft IIS 10

(1)Support to be discontinued in a future release.

(2)The Apache HTTP Server Project does not offer binary releases for Microsoft Windows. The Apache HTTP Server web agent for Windows was tested against the binaries offered by Apache Lounge

Linux Systems requirements

  • Web Agent on Linux supports Glibc 2.17 and later versions, and is compatible with Glibc 2.14 and later versions. For Glibc versions before 2.14, contact support.

  • Web Agent on Linux requires a minimum of 16 MB of shared memory for the session and policy cache, and the various worker processes. Additionally, it needs 32 KB shared memory for the logging system. Failure to provide enough shared memory may result in errors similar to the following:

    2017-11-10 12:06:00.492 +0000   DEBUG [1:7521][source/shared.c:1451]am_shm_create2() about to create block-clusters_0, size 1074008064
    2017-11-10 12:06:00.492 +0000   ERROR [1:7521]am_shm_create2(): ftruncate failed, error: 28

    To configure additional shared memory for the session and policy cache, see Environment variables.

  • If POST data preservation is enabled, the web agent requires additional free disk space in the web agent installation directory to store the POST data cache files.

Microsoft Windows systems requirements

  • Before installing the IIS web agent, make sure that the optional Application Development component of Web Server (IIS) is installed. In the Windows Server 2022 Server Manager for example, Application Development is a component of Web Server (IIS) | Web Server.

  • Web Agent on Windows requires a minimum of 16 MB of shared memory for the session and policy cache, and the various worker processes in the system page file. Additionally, it needs 32 KB shared memory for the logging system. Failure to provide enough shared memory may result in errors similar to the following:

    2017-11-10 12:06:00.492 +0000   DEBUG [1:7521][source/shared.c:1451]am_shm_create2() about to create block-clusters_0, size 1074008064
    2017-11-10 12:06:00.492 +0000   ERROR [1:7521]am_shm_create2(): ftruncate failed, error: 28

    To configure additional shared memory for the session and policy cache, see Environment variables.

  • If POST data preservation is enabled, the web agent requires additional free disk space in the web agent installation directory to store the POST data cache files.

Copyright © 2010-2024 ForgeRock, all rights reserved.