How To
Summary
Until Manage 9.0, the only supported authentication method was using API Keys in the transaction header.
Starting with Manage 9.1, other authentication methods are available, but they all still rely on API Keys as the primary mechanism for users to be able to access the Integration Framework and its full set of features.
Objective
The purpose of this document is to show the authentication methods supported starting from Manage 9.1
Environment
In this document, we will use a MAS 9.1 environment and the Postman client as an example.
The use of the Integration Framework (MIF) will be done through HTTP POST (meaweb/es).
Steps
How to Create an API Key in Manage
- Go to Manage → Integration → API Keys application.
- Click Add API Key.
- Select the user and expiration time, or keep the default values (by default, the key never expires).
- Click Create.
Once created, copy the API key using the Copy Key option.
Authenticating to MIF using HTTP POST
The API key cannot be passed as a URL parameter.
1.) Using Headers:
Go to Headers tab and add apikey:apikeyvalue
1.2) MAXAUTH header
The API Key must be encoded to base64 in the following format: <apikey>:<apikeyvalue>
2.) Using Authorization --> API Key
Go to Authorization tab and select Type = API Key
Key = <apikey>
Value = <apikeyvalue>
Add to = Headers
3.) Using Authorization --> Basic Auth
AVOID TROUBLE: basic auth can be used only with an api key
Go to Authorization tab and select Type = Basic Auth
Username: <apikey>
Password: <apikeyvalue>
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSLPL8","label":"IBM Maximo Manage"},"ARM Category":[{"code":"a8m50000000CbFGAA0","label":"Integration"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"and future releases"}]
Was this topic helpful?
Document Information
Modified date:
02 September 2025
UID
ibm17243716