IBM webMethods Hybrid Integration

IBM webMethods Hybrid Integration

Join this online group to communicate across IBM product users and experts by sharing advice and best practices with peers and staying up to date regarding product enhancements.


#TechXchangePresenter
 View Only
Back to discussions
Expand all | Collapse all

Microgateway 10.15: "user file not present" when attempting internal Basic Auth validation with users.cnf

  • 1.  Microgateway 10.15: "user file not present" when attempting internal Basic Auth validation with users.cnf

    Posted Tue September 16, 2025 02:16 PM

    Hi Community,

    I am currently implementing webMethods Microgateway version 10.15 to secure my services using a Basic Authentication policy.

    My current setup successfully validates credentials against an external Integration Server (/authenticate), and this is working correctly. However, I would like to switch to the internal user validation method by providing a users.cnf file in the configuration directory, as described in the documentation.

    What I've Done

    1. I am using a licensed installation of Microgateway 10.15.

    2. I have created a users.cnf file containing valid user and password definitions.

    3. This users.cnf file has been placed inside the /opt/softwareag/Microgateway/config directory within my Docker image. I have verified that the file is successfully copied into the image during the build process.

    The Problem

    However, when I start the Microgateway container, the startup log indicates that the user file is not found, and consequently, the user authentication feature is disabled.

    Here is the relevant log snippet:

    <response-element class="" ng-version="0.0.0-PLACEHOLDER"></response-element>

    Code snippet
    2025-09-16 11:56:04 Warning: asset type User currently not supported ... (other warnings) ... 2025-09-16 11:56:05 > API "ATEST 1.0" successfully deployed 2025-09-16 11:56:05 > 2025-09-16 11:56:05 > User Authentication: disabled because user file not present 2025-09-16 11:56:05 > Application Synchronization: enabled 2025-09-16 11:56:05 > Microgateway --> API Gateway registration: established

    <response-element class="" ng-version="0.0.0-PLACEHOLDER"></response-element>

    The key message here is User Authentication: disabled because user file not present.

    Also here a screenshot of my config folder :

     

    My Questions

    1. Is there a specific setting required in config.yml or system-settings.yml to explicitly enable 'internal' user validation and instruct the Microgateway to use the users.cnf file? Simply placing the file in the config directory does not seem to be sufficient.

    2. I am referencing the IBM documentation for version 11.1.0, but I am using version 10.15. Are there any significant differences or limitations in version 10.15 regarding internal user authentication with users.cnf?

    3. Could the "user file not present" message also appear if the content format of the users.cnf file is incorrect, even if the file itself is present?

    Environment Summary

    • Product: webMethods Microgateway

    • Version: 10.15 (Licensed)

    • Deployment: Docker Container

    • Goal: Switch from external (Integration Server) to internal (users.cnf) Basic Authentication.

    Any help or guidance on this would be greatly appreciated.

    Thank you!



    ------------------------------
    Ivan Aribanilia
    ------------------------------


Related Content