IT organizations are eager to integrate different solutions to fulfill their business needs. Most organizations employ a variety of 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 way to make it happen, it provides the ability to seamlessly exchange information between different businesses, customers, and partners is vital for success; An integral 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 API’s, and it’s pretty easy to integrate with MaaS360. You will require following 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 will need 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, we need to provision the app is MaaS360 with authorization to use MaaS360 web-services. Please contact IBM MaaS360 Support for provisioning this.

App ID

App Version

Platform ID

App Access Key


Please create an admin account and convert into the Script Only User

Portal Admin Creation

  1. Login to MaaS360 Portal

  2. Setup -> Administrator -> Add Administrator

  3. Provide email address and username

  4. Assign roles to the admin.

  5. Following inputs will then need to be provided for token generation.

  6. 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 >>


Once you will have all this information now you can test MaaS360 Web-Services with any web-service client, I am using Advanced Rest Web-services client.

  1. Get the Web Services Client

    Launch App

    Now we are ready to test any  web-servcies api calls.  You required Authentication token to test any web-service call of MaaS360.

  2. 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

     

     

  3. API Calls

    1. Provision a Customer Account

    2. 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

       

    3. Check Account Name Availability

    4. 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

    5. Basic Search

    6. 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)