Subscribe
THE DAILY DIGEST

The daily edition.

Essential reading from Rocket Enterprise. Straight to the source.

Archived edition
DAILY EDITION1 story· 4 min read

External Security Facility (ESF) & Security Manager Stacks in Rocket Enterprise Server

In a mainframe z/OS environment, applications and subsystems query security products (such as RACF, ACF2, or Top Secret) through the System Authorization Facility (SAF) interface. Rocket Enterprise Server replicates this mainframe security model via the External Security Facility (ESF).

IN FOCUS

External Security Facility (ESF) & Security Manager Stacks in Rocket Enterprise Server

In a mainframe z/OS environment, applications and subsystems query security products (such as RACF, ACF2, or Top Secret) through the System Authorization Facility (SAF) interface. Rocket Enterprise Server replicates this mainframe security model via the External Security Facility (ESF). [1]

Read the full briefing

1. Capability Overview

In a mainframe z/OS environment, applications and subsystems query security products (such as RACF, ACF2, or Top Secret) through the System Authorization Facility (SAF) interface. Rocket Enterprise Server replicates this mainframe security model via the External Security Facility (ESF).

ESF serves as the security intermediary across all Enterprise Server execution environments (CICS, IMS, JCL/JES) and administrative layers (ESCWA and Directory Server). Instead of relying on isolated or legacy security stores (such as CASESM), ESF delegates authentication and authorization decisions to enterprise directory services and security providers through pluggable External Security Managers (ESMs) like LDAP, Active Directory, PAM, or vault systems (External Security - Enterprise Server).

2. Architecture & How It Works

  • Unified Security Across Three Domains: Rocket Enterprise Server architecture defines three distinct security domains: ESCWA (management console), Directory Servers (MFDS), and individual Server Regions. ESF allows administrators to configure a Security Manager Stack—an ordered chain of ESM modules evaluated sequentially (Default ESF Configuration). Rocket documentation strongly recommends establishing a shared Default ES Configuration across all three domains so that user identities, group memberships, and access rules remain synchronized throughout the estate.
  • Mainframe SAF Class Emulation: ESF intercepts transaction execution, dataset access, and batch job submissions, mapping traditional mainframe resource classes (such as FACILITY, DATASET, JESSPOOL, SURROGAT, and TCICSTRN) directly into corresponding LDAP attributes or ESM rule hierarchies (Default ESF Configuration). Administrative operations performed via command-line utilities are similarly governed by SAF access rules evaluated under the AdminAPI resource class (Configuring External Security Facility (ESF) from the Command Line).
  • In-Memory Caching & Dynamic Invalidation (esfupdate): To maintain high transaction throughput without generating excessive network traffic to external LDAP servers, ESF aggressively caches Accessor Environment Elements (ACEEs), user credentials, and group memberships. When an administrator updates security definitions in an external directory, the changes do not require a region restart; executing the esfupdate command-line utility signals active worker processes to flush their local security caches and re-evaluate authorizations on subsequent requests (Additional ESF notes, To Update Security Manager Changes Using esfupdate).

3. Practical Configuration & Operational Tidbits

  1. Stack Chaining with PAM and MLDAP: You can combine disparate authentication and authorization sources within a single security manager stack. A common configuration pairs the PAM ESM Module (which authenticates user passwords against host OS/Kerberos mechanisms) with the MLDAP ESM Module (which resolves granular CICS transaction and JCL dataset authorization rules stored in OpenLDAP or Active Directory) (Using the PAM ESM Module and MLDAP ESM Module together).
  2. Mainframe-Style Administration with esfadmin: Administrators transitioning from z/OS can manage directory-backed security entities using familiar command verbs. The esfadmin utility provides sub-commands such as ADDUSER, ALTUSER, ADDGROUP, ADDRESOURCE, and ADDACE to script and manipulate access control entries without manual LDAP directory edits (LISTUSER).
  3. Disabling Legacy CASESM: In ESCWA, navigate to Operation > Directory Server > [Region] > General > Security, attach your configured ESM to the Security Managers list, and restart the region to ensure authentication is handled strictly by external enterprise security rather than internal default fallbacks (External Security - Enterprise Server).
  4. SAF Diagnostic Tracing: When troubleshooting permission issues, enable the region-specific auxiliary trace flag saf. Because security tracing captures detailed entry/exit logs for every authorization check, Rocket recommends toggling it off once diagnostics are complete to prevent performance degradation in production (Security Tracing).

4. Reference Citations (Rocket Enterprise Server 12.0 Manuals)

Enterprise Server · 12.0 · Linux/UNIX
Documentation references
REFERENCE 1External Security - Enterprise ServerEnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/pms1742951333629.htmlREFERENCE 2Default ESF ConfigurationEnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/ynk1742951333705.htmlREFERENCE 3Configuring External Security Facility (ESF) from the Command LineEnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/woi1742951335462.htmlREFERENCE 4Additional ESF notesEnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/pbq1742951634918.htmlREFERENCE 5To Update Security Manager Changes Using esfupdateEnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/egd1742951267129.htmlREFERENCE 6Using the PAM ESM Module and MLDAP ESM Module togetherEnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/bfc1742951512466.htmlREFERENCE 7LISTUSEREnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/ssq1742951483782.htmlREFERENCE 8Security TracingEnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/wwg1742952168865.htmlREFERENCE 9Security Managers and security configurationsEnterprise Server · Rocket Docs 12.0 · Linux/UNIXhttps://docs.rocketsoftware.com/bundle/enterpriseserverux_ug_120/page/tri1742951634409.html
That’s the briefing.You’ve reached the end of this edition.
More editions

From the archive

View all
Sep 19

Scale-Out Performance and Availability Clusters (PAC) in Rocket Enterprise Server