IBM Support

How to test Authentication API from Web Services API Documentation in MaaS360 portal?

Question & Answer


Question

Here are the steps to test the Authentication API from MaaS360 portal:

1. In MaaS360 portal navigate to Setup > Web Services API > Documentation. If you're not able to see that, please reach out to Support to have it enabled.

2. Select Authentication and then the option Expand Operations on the upper right-hand side.

3. Fill out the Billing ID - that's the account number;

4. Click on the AuthRequest XML example on the right-hand side - this will copy the whole XML into the body field;

5. Modify the XML in the body - platform: 3; billing ID: the MaaS360 account ID; appID, appVersion and appAccessKey should be matching the App details you have; for username and password use the credentials of the currently logged in administrator. You can double check the app details from Setup > Web Services API > Manage Access Keys (the logged in administrator should have the WebService API roles assigned to be able to see that).

Result: Use the Try it out! button to test the authentication request - it should run successfully and in the result you should be able to see the authToken being generated successfully, Response Code is 200.


Note: This request can only be run using the currently logged in administrator and cannot be used for testing the authentication for other administrators. If the request is run with another administrator's credentials, it would return a prompt "Please provide the username used during login." and it would fail with error with Response Code 500.

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYSXX","label":"IBM MaaS360"},"ARM Category":[{"code":"a8m0z000000GnQJAA0","label":"TROUBLESHOOTING"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"LOB24","label":"Security Software"}}]

Document Information

More support for:
IBM MaaS360

Component:
TROUBLESHOOTING

Software version:
All Version(s)

Document number:
6241580

Modified date:
06 July 2020

UID

ibm16241580

Manage My Notification Subscriptions