Add Application Token Account

1 min

POST

{{url}}/aioc-rest-web/rest/aapm/addAapmAccount

Request Overview

The Add Application Token Account API enables the creation of new Application Token accounts.

Usage:

Use this method to generate a new Application Token account within the system.

Add Application Token Account parameters

POST /rest/aapm/addAapmAccount accepts AapmAccountModel.

JSON field	Type	Required	Description
`applicationName`	String	Yes	Application identifier. Must not be blank.
`applicationIPs`	Array[String]	Yes	Allowed client IP addresses or CIDR ranges. At least one value is required.
`level`	SecurityLevel	Yes	Server-supported security level; for example `BASIC_PIN_PATH_HASH`.
`sapmAccounts`	Array[Long]	Conditional	SAPM account database IDs. At least one SAPM account or SAPM group is required.
`sapmGroups`	Array[Long]	Conditional	SAPM group database IDs. At least one SAPM account or SAPM group is required.
`restrictions.allowListingAccounts`	Boolean	No	Allows the token to list linked SAPM accounts. Defaults to `false`.
`restrictions.eventUserId`	String	No	User UUID used for event attribution.
`restrictions.expiryDate`	Long	No	Token expiry time in Unix epoch milliseconds.
`restrictions.maxUsageCount`	String	No	Maximum usage count represented as an integer string, such as `"100"`.
`properties`	Object	No	Security-level-specific settings such as `pinPort`, `appPath`, `appHash`, `OSType`, `OSCredentialType`, `OSCredentialSAPM`, `manualUserName`, and `manualPassword`.

dbId, token, lastAccessTime, and numberOfUsage are generated or maintained by the system and are not add-request fields.

urlstring

x-xsrf-tokenstring

bodyobject

200Add Application Token Account

curl --request POST \
     --url {{url}}/aioc-rest-web/rest/aapm/addAapmAccount \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-xsrf-token: {{x-xsrf-token}}' \
     --data '"{\n  \"applicationName\": \"ExampleApplication\",\n  \"applicationIPs\": [\n    \"192.0.2.10/32\"\n  ],\n  \"sapmAccounts\": [\n    100001\n  ],\n  \"sapmGroups\": [],\n  \"restrictions\": {\n    \"allowListingAccounts\": false,\n    \"expiryDate\": 1893456000000,\n    \"maxUsageCount\": \"100\"\n  },\n  \"level\": \"BASIC_PIN_PATH_HASH\",\n  \"properties\": {\n    \"appHash\": \"EXAMPLE_APP_HASH\",\n    \"appPath\": \"C:\\\\Program Files\\\\Example\\\\example.exe\",\n    \"OSType\": \"WINDOWS\",\n    \"OSCredentialType\": \"SAPM\",\n    \"OSCredentialSAPM\": 100001,\n    \"pinPort\": 8080\n  }\n}"'