IBM Support

IT34426: CLARIFY DOCUMENTATION ON HOW TO USING PKCS12 KEYSTORES AND TRUSTSTORES

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as documentation error.

Error description

  • The existing documentation on how to configure keystores and
    truststores correctly mentions that the PKCS12 format can be
    used. However the documentation incorrectly implies that the
    proper name for this format is "P12". Attempting to set "P12"
    as the keystore or truststore type will result in an invalid
    keystore format exception at runtime.
    
    The documentation should
    be updated to state that the correct type for such keystores is
    PKCS12, not P12.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    All users of keystores and truststores in IBM App Connect
    Enterprise 11
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The Knowledge Center incorrectly refers to PKCS12 keystores as
    P12 keystores in a number of places, which incorrectly implies
    that this is a valid keystore type string that can be set in the
    server.conf.yaml and node.conf.yaml whenever a keystore or
    truststore type must be specified. This is incorrect, the
    correct keystore string for such keystores is "PKCS12" not
    "P12".
    

Problem conclusion

  • The KC has been updated to refer to keystores and truststores as
    PKCS12 keystores and truststores rather than P12 keystores and
    truststores.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT34426

  • Reported component name

    APP CONNECT ENT

  • Reported component ID

    5724J0550

  • Reported release

    B00

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-10-02

  • Closed date

    2020-12-16

  • Last modified date

    2020-12-16

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

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

Fix information

Applicable component levels

[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSDR5J","label":"IBM App Connect Enterprise"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"B00"}]

Document Information

Modified date:
12 January 2021