Log In¶

Log in to EnOS.

Request Format¶

POST https://{apigw-address}/enos-iam-service/v2.0/login

Request Parameters (Body)¶

Name	Required/Optional	Data Type	Description
authType	Required	Integer	The authentication type. 0: EnOS 1: LDAP
linkName	Optional (Required if using LDAP `authType`)	String	The LDAP domain name.
principal	Required	String	The account name.
credentials	Required	String	The password.
keyId	Optional	String	The encryption key ID.
captcha	Optional	String	The captcha, which is a reserved field.
clientIp	Optional	String	The IP address of the client.
expireInterval	Optional	Integer	The session expiring time, in seconds. The range of values is [900, 864000], with values <900 being defaulted to 900 and values >864000 being defaulted to 864000.

Response Parameters¶

Name	Data Type	Description
captcha	String	The captcha for verification.
session	Session Struct	The session information. For more information, see Session Struct.

Session Struct ¶

Name	Data Type	Description
id	String	The session ID.
expires	Integer	The session expiring time.
user	User Struct	The detailed user information. For more information, see User Struct.
residentOrganization	List<JSONObject>	The OU to which the user belongs when the user account is created.
workingOrganization	List<JSONObject>	The current organizatoin.
refreshTime	Long	The session refresh time.
createTime	Long	The session create time.
status	Int	The session status. 0: initialized (limited access to interface only), 1: normal.
ssoLogin	Boolean	Whether there is an SSO login session.

User Struct ¶

Name	Data Type	Description
id	String	The user ID.
organizationId	String	The OU to which the user belongs.
authType	Integer	The authentication type. 0: EnOS 1: LDAP
name	String	The user name.
domain	String	The domain.
phoneArea	String	The phone area.
phone	String	The user phone number.
phoneVerifiedAt	String	The time when the user phone number is verified.
email	String	The user email address.
emailVerifiedAt	String	The time when the user email is verified.
description	String	The user description.
extra	Map	Other user information.
resourceId	String	The resource ID.
type	Enum	The user type. 0: user 1: OU owner 2: OU admin
state	Enum	The user account status. 0: Enabled 1: Disabled
mfaType	Enum	The multi-factor authentication type. 0: Disabled 1: By SMS 2: By email 3: By SMS and email
passwordState	Enum	The user password status. 0: Normal 1: Requires password change
passwordExpireTime	Long	The password expiring time.
passwordStrength	Enum	The password strength. 0: Medium 1: Strong 2: Very strong
organization	Organization Struct	The organization’s information. For more information, see Organization Struct.
createdAt	String	The creation time.
phoneVerified	Boolean	Is the phone number verified.
emailVerified	Boolean	Is the email number verified.

Error Code¶

Code	Description
30400	The user accout or password is not correct, or the LDAP domain is missing, or the LDAP attribute mapping is not correct, or connection failed.
30404	The LDAP connection does not exist.
30410	The password has expired.
30429	The login failure times of the IP or account has reached the limit. Please try again later.
30511	The user account is disabled, or the LDAP login is disabled.

Sample¶

Request Sample¶

url: https://{apigw-address}/enos-iam-service/v2.0/login
method: POST
requestBody:
{
  "authType":0,
  "linkName":"",
  "credentials":"xxx",
  "principal":"xxxx",
  "keyId":"yyy",
  "captcha":"xxxx",
  "clientIp":"1.1.1.1",
  "expireInterval":3600
}

Return Sample¶

{
  "fail": false,
  "session": {
    "workingOrganization": {
      "domain": "db_portal_test01",
      "name": "portal_test01",
      "id": "o15578227985571"
    },
    "expires": 7200,
    "createTime": 1562849746,
    "residentOrganization": {
      "domain": null,
      "name": "portal_test01",
      "id": "o15578227985571"
    },
    "refreshTime": 1562850052,
    "id": "IAM_S_HbH8y6sP77T5uUDgqLfzGCZkrz9x5Pyr3VMVARBBQRK8YDbAnsU9YWdUQAMkBu7g4fQKUXmPjakeSmqpFVWsANXKdrBJKUxrLxZC9MvCVHqTc5HyqTcnANz3M8HMhnTb",
    "user": {
      "createdByUserId": "u15440200922941",
      "resourceId": "r15578227990212",
      "phoneVerified": false,
      "description": "",
      "type": 2,
      "organizationId": "o15578227985571",
      "createdAt": null,
      "emailVerified": true,
      "phoneVerifiedAt": null,
      "phone": "",
      "createTime": "2019-05-14 08:33:19.0",
      "emailVerifiedAt": null,
      "mfaType": null,
      "extra": null,
      "organization": null,
      "name": "portal_test01",
      "phoneArea": "",
      "id": "u15578227990211",
      "state": 0,
      "authType": 0,
      "email": "congcong1.chen@envision-digital.com"
    }
  },
  "captcha":"",
  "success": true,
  "requestId": null,
  "failed": false,
  "message": "",
  "status": 0,
  "successful": true
}