API - Get Entitlement | Sectona Docs

Purpose

To get the entitlement by user, asset and account using Sectona API interface.

Accessing the API

Endpoint: /API/APP/APP007/GetEntitlement

HTTP METHOD

POST

Parameters

Parameters	Data type	Required	Description
EntitlementType	String	Yes	All/User
Username	String	No	Required if entitlement type is User.
AssetHost	String	No	Asset Host
AccountName	String	No	Account
Instance	String	YES	Instance name

Sample Request (JSON)

{
     "EntitlementType":"All/User",
     "Username":"user name",
     "AssetHost":"asset host",
     "AccountName":"Account name",
     "Instance":"Instance name",
}

Sample Response (JSON)

{
   	“Version”:”6.0.0.0”,
	"IsSuccess": true,
	"LogCode":"0",
	"Result":
[{
     "Username":"String",
     "PolicyName":"String",
     "AssetCategory":"String",
     "AssetType":"String",
     "DBInstance":"String",
     "HostName":"String",
     "IPAddress":"String",
     "AccountName":"String",
     "AccountType":"String",
     "Domain":"String",
     "AccountGroup":"String",
]}

	"StatusCode":"Accepted",
	"Timestamp":"03 Jun 2019 12:25:16 GMT 05:30:00"
}

Standard Error Response Codes

Error Code	Error Description
011649	Current user doesn’t have permission to take action
011651	The authorization header is either empty or not basic
011673	Invalid credentials
011674	Invalid credentials
011675	Unable to validate request
011683	Invalid instance name
011803	Unable to insert API log details
032417	Unable to get entitlement information
011656	Invalid directory store
011671	Invalid account name
011685	Unable to get asset information
011690	Account does not belong to asset
011805	Unable to get user group
011853	Requested asset is not valid