IBM Support

PH68412: New Function - Enable Identity Propagation support in z/OSMF

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • This APAR delivers new support for Identity propagation in
    IBM z/OS Management Facility (z/OSMF).  This allows invocation
    of the z/OSMF REST APIs from clients local to the sysplex
    without the need to pass credentials along with the HTTPS
    request.
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM z/OS Management Facility    *
    *                 3.2.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: This APAR delivers new support for      *
    *                      Identity propagation in IBM z/OS        *
    *                      Management Facility (z/OSMF).  This     *
    *                      allows invocation of the z/OSMF REST    *
    *                      APIs from clients local to the sysplex  *
    *                      without the need to pass credentials    *
    *                      along with the HTTPS request.           *
    ****************************************************************
    This new function in z/OSMF leverages support in embedded
    Liberty z/OS, v25.0.0.9, which adds the
    zosIdentityPropagation-1.0 feature to Liberty z/OS. This new
    Liberty feature in turn enables use of the Trusted TCP
    Connections support in z/OS Communications Server.
    
    When this function is enabled, and the required SAF resource
    profiles are created and authorized, a z/OSMF REST API can be
    invoked by a local authenticated client (e.g. a user logged into
     z/OS Unix System Services via SSH) without the need to pass
    credentials (e.g. authorization header or certificate) along
    with the HTTPS request.
    
    The z/OSMF server can use this support to obtain the client
    credential from a local client within the sysplex, perform
    normal authorization checks, and then the invocation
    of the REST service (if authorized).
    

Problem conclusion

Temporary fix

Comments

  • There is no change of behavior by default as the new function
    must be enabled to be activated.
    
    Using the new function requires first creating some SAF
    resource profiles and additional authorization.  This APAR
    includes updates to sample JCL, as well as new Security
    Configuration Assistant (SCA) validations to validate and
    assist with the required SAF updates, (which are of course also
    included in the updated product documentation).  If the new
    function is enabled without the SAF updates, then error
    messages will appear and authentication will function as if the
    APAR were not applied.
    
    Note the requirement to upgrade embedded Liberty to v25.0.0.9.
    With an older version of embedded Liberty the new function will
    have no effect if enabled.
    
    To activate, use the z/OSMF UI "General Settings" task, and
    navigate to the "Security" tab and select the "Identity
    propagation" topic, then toggle the control to "Enabled", and
    restart the z/OSMF server.
    

APAR Information

  • APAR number

    PH68412

  • Reported component name

    Z/OSMF CORE

  • Reported component ID

    5655S28SM

  • Reported release

    320

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2025-10-06

  • Closed date

    2026-01-16

  • Last modified date

    2026-03-02

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UO06504

Modules/Macros

  • IZUCFUNC IZUGNAAS IZUGNABR IZUGNABX IZUGNAFO IZUNUSEC IZUSEC
    

Fix information

  • Fixed component name

    Z/OSMF CORE

  • Fixed component ID

    5655S28SM

Applicable component levels

  • R320 PSY UO06504

       UP26/02/05 P F602  

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU029","label":"Software"},"Product":{"code":"SG19O","label":"z\/OS Management Facility"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"320"}]

Document Information

Modified date:
02 March 2026