Login (rs/login)

Login to the Sophos Mobile server.

The login resource returns a session authentication token that is required to access the other web service resources.

URL

https://<smc_server_address>/rs/login

Method

POST

Request header

Key Value
content-type application/x-www-form-urlencoded

Request body

Form data, containing these properties:

Key Description
customer Customer name
user Administrator login name
password Administrator password

Response body

JSON object with the following structure:

Key Type Description
userName String Administrator login name
authToken String Session authentication token
loginDate Integer Login timestamp in epoch milliseconds
rights Array of strings List of rights that are granted to the administrator

The administrator must have the DEVICE_BROWSE right to be able to retrieve network access status.

HTTP response status

Status code Description
200 OK Administrator was successfully logged in
401 Unauthorized Administrator is not authorized to access the resource

Example request

POST /rs/login HTTP/1.1
Host: smc.yourcompany.com
Content-Type: application/x-www-form-urlencoded
customer=your_customer&user=your_admin_name&password=your_password

Example response

{
   "userName": "your_admin_name",
   "authToken": "da81d6d2-3c02-4f18-8115-f4188d84e851",
   "loginDate": 1452258438634,
   "rights": [
      <array of granted rights>
   ]
}