Find Applications
Find applications. The command uses the PV_APPLICATION public view to find data. Any filters passed should be passed on this public view.
GET https://instance.securid.com/aveksa/command.submit?cmd=findApplications
Request
Parameters
| findApplications | |
| format | properties - (Default) Returns the response as key=value pairs. When multiple objects are returned, values are comma-delimited: key=value1,value2,value3.json - Returns the response as JSON.csv - Returns the response as comma-separated values.tsv - Returns the response as tab-separated values.xml - Returns the response as XML. |
| delimiter | The delimiter to use between values for csv and properties formats |
| returnColumns | The names of the columns to return. returnColumns may be a CSV list of multiple column names. The returnColumns parameter may also be listed multiple times (ie returnColumns=col1,col2&returnColumns=col3,col4) Refer to Columns table below. |
| returnMaxRows | The maximum number of objects to return |
| distinct | true, false Returns only distinct values, equivalent to the distinct keyword in SQL. |
| sortByColumns | The results will be sorted based on the columns listed using comma as the delimiter if multiple columns are specified. Refer to Columns table below. |
| sortDirection | Determines sorting order. asc for ascending, desc for descending. If not specified, the natural order returned by the database is used. |
| includeHeaderRow | true, false Include column headers when the return format is csv or tsv. (Default) true |
| ignoreCase | true, false Returns case-insensitive search results for specified filter parameters. (Default) false |
Columns
| id | [Primary Key] Unique application identifier |
| name | Application name |
| created_by | [Foreign Key referencing USERS.ID] User id that created this application |
| creation_date | Date stamp when this application was created |
| description | Description associated with this application |
| sensitivity | Sensitivity |
| ownership | Ownership |
| locality | Locality |
| business_owner | [Foreign Key referencing USERS.ID] Business owner user id |
| technical_owner | [Foreign Key referencing USERS.ID] Technical owner user id |
| exception_manager | [Foreign Key referencing USERS.ID] Exception manager user |
| business_unit_id | [Foreign Key referencing BUSINESS_UNIT.ID] Related business unit id |
| alt_name | Alternate name for this entry |
| short_desc | Short description for this entry |
| long_desc | Long description for this entry |
| url_ref | URL reference for this entry |
| user_count | Total number of collected users for this application |
| account_count | Total number of collected accounts for this application |
| orphaned_account_count | Total number of collected accounts for this application that do not map to any user |
| entitlement_count | Total number of collected entitlements for this application |
| category | Category |
| exclude_from_normal_add_access | Exclude application from normal add access |
| allow_create_entitlement | Allow create entitlement |
| allow_manual_activity | Allow manual activity |
| ents_require_account | Stores true and false and signifies whether entitlements added to the users have to come from an account |
| directory_for_accounts | Stores the directory of the accounts for the application |
| rules_account_template_id | Signifies the account template to be used when a change request is created from Rules to add entitlements to this application |
| attr_sync_enabled | Stores true and false and signifies whether attribute sync feature is enabled |
| allow_disabled_accounts | Stores true and false and signifies whether the disabled accounts are allowed to be collected |
| allow_locked_accounts | Stores true and false and signifies whether the locked accounts are allowed to be collected |
| roles_account_template_id | Signifies the account template to be used when a change request is created from Roles to add entitlements to this application |
| business_owner_name | Business owner display name |
| technical_owner_name | Technical owner display name |
| exception_manager_name | Exception manager display name |
| editable | TRUE, FALSEIf the application is editable. |
| backup_business_owner | [Foreign Key referencing USERS.ID] Backup business owner |
| backup_technical_owner | [Foreign Key referencing USERS.ID] Backup technical owner |
| business_criticality | Specifies the level of criticality for the business source |
| privileged_flag | Specifies that the business source manages and controls privileged access |
| contains_privileged_access | Indicates whether this application contains privileged access accounts. 0 = No, 1 = Yes |
| decommissioning_date | Date stamp when this application was decommissioned |
| is_active | Indicates whether this application is active |
| cau1 | Value of custom user type attributes configured on the instance represented by their reference names |
| cau2 | Value of custom user type attributes configured on the instance represented by their reference names |
| cad1 | Value of custom date type attributes configured on the instance represented by their reference names |
| cas1 | Value of custom string type attributes configured on the instance represented by their reference names |
Headers
Bearer token | |
| Accept | application/json |
| Content-Type | application/json |
Response
Parameters
The API returns the requested columns specified by returnColumns as output. If returnColumns is unspecified then all columns listed will be returned.
Examples
Request
- Curl
- Python
- Node.js
curl -K -X GET \
"https://instance.securid.com/aveksa/command.submit?cmd=findApplications&format=json" \
"&returnColumns=id%2Cname%2Cdescription&returnMaxRows=3" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"
import requests
url = "https://instance.securid.com/aveksa/command.submit"
params = {
"cmd": "findApplications",
"format": "json",
"returnColumns": "id,name,description",
"returnMaxRows": "3"
}
headers = {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
}
response = requests.get(url, params=params, headers=headers)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f"Request failed with status code {response.status_code}")
const axios = require('axios');
const url = "https://instance.securid.com/aveksa/command.submit";
const params = {
cmd: "findApplications",
format: "json",
returnColumns: "id,name,description",
returnMaxRows: "3"
};
const headers = {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
};
axios.get(url, { params, headers })
.then(response => {
if (response.status === 200) {
const data = response.data;
console.log(data);
} else {
console.log(`Request failed with status code ${response.status}`);
}
})
.catch(error => {
console.error('Error:', error);
});
Response
- 200
{
“findApplications”: [
{
“id”: “47”,
“name”: “Generic SecurID Tokens”,
“description”: “Represents generic requestable tokens meant to allow the system to request the \”next available\” token”
},
{
“id”: “429”,
“name”: “Canvas”,
“description”: “Canvas LMS is a versatile Learning Management System known for its user-friendly interface and robust features. Widely used in educational institutions, it facilitates seamless course management, collaboration, and assessment. With customizable dashboards and mobile accessibility, Canvas enhances the teaching and learning experience, making it a preferred choice for educators and students alike.”
},
{
“id”: “551”,
“name”: “Alteryx”,
“description”: “Alteryx is a unified AI-powered data analytics platform that enables users to prepare, blend, analyze, and automate data workflows without coding. It accelerates data-driven decisions by combining code-free automation, predictive analytics, and generative AI in one easy-to-use environment. Widely used across industries, Alteryx supports integration with cloud platforms and BI tools to deliver scalable, trusted insights quickly and securely.”
}
]
}
Verified with RSA Governance & Lifecycle version 8.0.0.188886 P10_HF01.