Purpose

To add a user using Sectona's API interface.

Accessing the API

Endpoint: /API/APP/APP008/RequestPassword
XML


HTTP METHOD

POST
XML


Authorization: This API uses access key data for authorization purpose


Parameters

ParametersData TypeRequiredDescription
AssetTypeStringYESAsset type
AssetHostStringYES Host name or IP address
DBInstanceStringOPTIONAL Database instance if asset category is database
AccountNameStringYES Account name
InstanceStringYES Instance name


Sample Request (JSON)

{
	"AssetType":"Unix Based",
	"AssetHost":"CENTOS7",
	"DBInstance":"",
	"AccountName":"*****",
	"Instance":"Default"
}
XML

Sample Response (JSON)

{
	"Version":"2.3.0.0",
	"IsSuccess":true,
	"LogCode":"0",
	"Result":
	"{
		"AssetType": "Unix Based",
      	"AssetHost": "XXXXXX",
      	"AccountName": "XXXXXX",
      	"AccountAuthenticationType": "KeyBased_SecretKey",
      	"AccountType": "Local",
      	"Password": "XXXXXX",
      	"PassPhrase": "XXXXXX",
      	"CreatedBy": "",
      	"CreatedOn": "03 Jun 2019 15:22:11 GMT 05:30:00",
      	"Status": "Active"
	}",
 	"StatusCode":"Accepted",
	"Timestamp":"03 Jun 2019 15:38:18 GMT 05:30:00"
}
XML


Standard Error Response Codes

Error CodeError Description

011670

UI description

011671

Invalid account details

011672

Invalid account name

011688

Requested details are not valid or unaccessible

011689

Invalid access key

011690

Invalid request parameters

011691

Account does not belong to asset

011692

Unable to validate request

011693

Unable to get account password

011694

Unable to read response