Kony Management User Guide: Intelligent EMM (IEMM) > User Authentication

User Authentication

This service is the first service call in series of calling various IEMM services except emminfo service. This service maintains sessions and secret tokens that contain user information.

URL

https://emmserver.com/emm/iemm/services/login

Type

POST

Input

Input Parameters

username

This is a mandatory parameter given by tenant/admin to the particular user.

password

This is a mandatory parameter given by tenant/admin to the particular user.

deviceid

This is a mandatory parameter to authenticate the user.

Input Headers

Content-Type

This is a mandatory parameter and allowed value is application/x-www-form-urlencoded.

Accept

This is an optional parameter whose default value is “application/xml”, and the possible values are application/xml or application/json.

Output

Output Parameters

responseCode

1000 = success
1001 = Error - Missing Username: Username should not be empty
1002 = Error - Missing Password: Password should not be empty
1003 = Error - Missing Device ID: Device ID should not be empty
1005 = Authentication Failed. Invalid username or password
2001 = Error: Authenticated Token is missing
2002 = Error: Device ID should not be empty
2003 = Session time out
3001 = Unexpected error occurred
3003 = Error - Improper Service Call: Please check URL and provide correct service call
3004 = IEMM services are not available
3005 = Error - Device is not enrolled with EMM

description

Please refer responseCode.

token

Encrypted token contains user information.

Output Headers

Set-Cookie

This helps in maintaining session and is passed in consecutive services as value of input header parameter “Cookie”.

Examples

Input:

username=admin&password=admin&deviceid= fbf43e35aeb2fb9eaedf0dddf26250d4

Output:

{
   "description":"success",
   "responseCode":1000,
   "token":"BA47E3769E65732794B4CD4A742DB555E37F167C87A9AE73A27581E0C186039D43800F9C0D8CA8611D0F971A9B3B2B52F9C7D629F59728A8F0F5669091722E9C"
}