About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
IT organizations are eager to integrate different solutions to fulfill their business needs. Most organizations employ a various disparate applications that store and exchange data in dissimilar ways and therefore cannot "talk" to each other because each critical application has their own language, platform, and operating system. Web services are one of the best ways to make it happen. It enables seamlessly exchange of information between different businesses, customers, and partners is vital for success; A part of xml web services, is the ease of integration with external data sources. No longer does each application need to copy and maintain external data sources.
MaaS360 Provides Rest style web-service APIs, and it's easy to integrate with MaaS360. Here are the details to integrate with MaaS360. MaaS360 API root URL varies by customer account location.
M1: https://services.fiberlink.com
M2: https://services.m2.maas360.com
M3: https://services.m3.maas360.com
M4: https://services.m4.maas360.com
MaaS360 web service request needs to include the Billing Account context - The provided Billing Account context is validated against context available with the authenticated session. To use any web-service, the app needs to authenticate first and get an authentication token, once generated, authentication token is valid for 60 mins. web services can continue to be executed. To be able to make the request to generate authentication token, provision the app is MaaS360 with authorization to use MaaS360 web-services. Please contact IBM MaaS360 Support for provisioning.
App ID
App Version
Platform ID
App Access Key
Create an admin account and convert into the Script Only User
Portal Admin Creation
ROOT_WS_URL: Depends on your MaaS360 instance
M1: https://services.fiberlink.com
M2: https://services.m2.maas360.com
M3: https://services.m3.maas360.com
M4: https://services.m4.maas360.com
Billing ID: <<Customer's Billing ID>>
Administrator Username: <<Your MaaS360 Username>>>
Administrator Password: <<Your MaaS360 Password>>
App ID (for App authorized to use MaaS360 services): <<App ID provisioned in
MaaS360>>
App Version: <<App Version of app provisioned in MaaS360 >>
Platform ID: 3 <<Use this for now >>
App Access Key: <<Access Key generated by MaaS360 >>
-
Log in to MaaS360 Portal
-
Setup -> Administrator -> Add Administrator
-
Provide email address and username
-
Assign roles to the admin.
-
Following inputs will then need to be provided for token generation.
You can test MaaS360 web-services with any web-services client, I am using Advanced Rest web-services client.
-
Get the Web Services Client
Launch App
Now we are ready to test any web services api calls. You required Authentication token to test any web service call of MaaS360.
-
Authentication Token
Request URL
URL: https://services.m3.maas360.com/auth-apis/auth/1.0/authenticate/<billingID/
Method :Post
Header: Content-Type: application/xml
Actual Body
<authRequest>
<maaS360AdminAuth>
<billingID>billingID</billingID>
<platformID>3</platformID>
<appID>App ID</appID>
<appVersion>1.0</appVersion>
<appAccessKey>App Access Key</appAccessKey>
<userName>Admin Username</userName>
<password>Admin Password </password>
</maaS360AdminAuth>
</authRequest>
Authorization Token
-
API Calls
Request URL
URL: https://services.m3.maas360.com/account-provisioning/account/1.0/createCustomerAccount/billingId
Method:
Post
Header
Content-Type application/x-www-form-urlencoded
Authorization MaaS token="4d6d2190-ae0d-4a4e-93cc-95c782d6f376-CBHbmPO"
Parameters:
Service MDM
billingId Your billing ID
accountType Trial/Customer
accountName TestAccount
adminEmailAddress testaccount@email.com
Request
Result
Request URL
URL: https://services.m3.maas360.com/account-provisioning/account/1.0/checkAccountNameAvailability/billingId
Method:
Post
Header:
Content-Type application/x-www-form-urlencoded
Authorization MaaS token="4d6d2190-ae0d-4a4e-93cc-95c782d6f376-CBHbmPO"
Parameters:
accountName Test-WebService2
Request
Result
Request URL
URL: https://services.m3.maas360.com/device-apis/devices/1.0/search/30008180
Method:
GET
Header:
Authorization MaaS token="8015bd40-83d7-43bc-a7c1-4415c94bae75-CBHpvBy"
Parameters:
Optional
Request
Result
(Credit for this document (Afzal Rehman