IBM webMethods Hybrid Integration

 View Only

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

Ivan Aribanilia's profile image
Ivan Aribanilia posted Tue September 16, 2025 01:06 AM
#### 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:
 
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
 
```
 
The key message here is `User Authentication: disabled because user file not present`.
 
Also here a screenshoot of my config : 
 
---
 
### 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!