Authomize
App Vendor: Authomize
App Category: IT Services
Connector Version: 1.0.0
API Version: 1.0.0
Note
This app is currently released as a beta version.
About App
Authomize empowers you to establish identity-first security by detecting, investigating, and responding to identity and access threats.
The Authomize app is configured with Orchestrate to perform the following actions:
Action Name | Description |
|---|---|
Create App | This action creates an app in Authomize. |
Create Users | This action creates users in an app. |
Generic Action | This is a generic action used to make request to any Authomize endpoint. |
Retrieve App | This action retrieves details of an app using its app ID. |
Retrieve Incidents | This action retrieves details of an incident using its incident ID. |
Search Accounts | This action finds specific accounts on Authomize and gets related data such as ID, status, and more. |
Search App Assets | This action finds a list of all assets and related data. |
Search Apps | This action searches apps in Authomize. |
Search App Users | This action searches users of an app. |
Search Assets | This action finds specific assets on Authomize and gets related data. |
Search Groups | This action finds specific groups on Authomize and gets related data. |
Search Incidents | This action lists incidents and related data based on specified filters. |
Search Source Apps | This action gets a list of all source app names and their IDs. |
Update Incidents | This action updates an existing incident based on the incident ID. |
Configuration Parameters
The following configuration parameters are required for the Authomize app to communicate with the Authomize enterprise application. The parameters can be configured by creating instances in the app.
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
API Token | Enter the API token to authenticate with Authomize. | Password | Required | |
Timeout | Enter the timeout value in seconds. This is the number of seconds that requests will wait to establish a connection with Authomize. | Integer | Optional | Allowed values: 15-120 Default value: 15 |
Verify | Choose your preference to verify SSL or TLS while making requests. It is recommended to set this option to yes. Passing no may result in incorrectly establishing the connection. | Boolean | Optional | Allowed values:
Default value: false |
Action: Create App
This action creates an app in Authomize.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Integration Name | Enter the integration name to create the app. | Text | Optional |
Action: Create Users
This action creates users in an app.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
App ID | Enter the app ID to create the users. | Text | Required | You can retrieve this using the action Search Apps. |
Unique ID | Enter the unique ID of the user. | Text | Required | |
Name | Enter the name of the user you want to create. | Text | Optional | |
Description | Enter a description for the user. | Text | Optional | |
Additional Data | Enter any additional data associated with the user. | Key Value | Optional |
Action: Retrieve App
This action retrieves details of an app using its app ID.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
App ID | Enter the app ID to retrieve its details. | Text | Required | You can retrieve this using the action Search Apps. |
Action: Retrieve Incidents
This action retrieves details of an incident using its incident ID.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Incident ID | Enter the incident ID to retrieve the incident details. | Text | Required | You can retrieve this using the action Search Incidents. |
Expand | Enter the list of fields to expand for additional information. | List | Optional | Allowed values:
|
Action: Search Accounts
This action finds specific accounts on Authomize and retrieves related data such as ID, status, and more.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Filters | Enter filters such as originId, authomizeId, isExternal, sourceAppId, and more to search for accounts. | Key Value | Optional | Allowed values:
|
Expand | Enter the list of fields to expand for additional information. | List | Optional | Allowed values:
|
Sort | Sort the results by account fields in ascending or descending order. | List | Optional | Allowed values:
Default value: ASC |
Pagination | Enter the pagination details. | Key Value | Optional |
Action: Search App Assets
This action finds a list of all assets and related data.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
App ID | Enter the app ID to search the app assets. | Text | Required | You can retrieve this using the action Search Apps. |
Start date | Enter the start date to search the app assets. | Text | Optional |
Action: Search Apps
This action searches apps in Authomize.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Limit | Enter the limit to search apps. | Integer | Optional | Default value: 20 |
Skip | Enter the skip value to search apps. | Integer | Optional | Default value: 0 |
Action: Search App Users
This action searches users of an app.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
App ID | Enter the app ID to search the app users. | Text | Required | You can retrieve this using the action Search Apps. |
Start Date | Enter the start date to search the app users. | Text | Optional |
Action: Search Assets
This action finds specific assets on Authomize and gets related data.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Filters | Enter filters such as originId, appId, and more to search assets. | Key Value | Optional | Allowed values:
|
Expand | Enter the list of fields to expand for additional information. | List | Optional | Allowed values:
|
Sort | Sort the results by asset name in ascending or descending order. | List | Optional | Allowed values:
Default value: ASC |
Pagination | Enter the pagination details. | Key Value | Optional |
Action: Search Groups
This action finds specific groups on Authomize and gets related data.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Filters | Enter the filters such as uniqueId, originId, and more to search for groups. | Key Value | Optional | Allowed values:
|
Expand | Enter the list of fields to expand for additional information. | List | Optional | Allowed values:
|
Sort | Sort the results by group name in ascending or descending order. | List | Optional | Allowed values:
Default value: ASC |
Pagination | Enter the pagination details. | Key Value | Optional |
Action: Search Incidents
This action lists incidents and related data based on specified filters.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Filters | Enter the filters such as createdAt, updatedAt, severity, status, and more to search for incidents. | Key Value | Optional | Allowed values:
|
Expand | Enter the list of fields to expand for additional information. | List | Optional | Allowed values:
|
Sort | Sort the results by incident fields in ascending or descending order. | List | Optional | Allowed values:
Default value: ASC |
Pagination | Enter the pagination details. | Key Value | Optional |
Action: Search Source Apps
This action gets a list of all source app names and their IDs.
Action Input Parameters
This action does not require any input parameters.
Action: Update Incidents
This action updates an existing incident based on the incident ID.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Incident ID | Enter the incident ID to update its details. | Text | Required | You can retrieve this using the action Search Incidents. |
Assignee ID | Enter the ID of the user assigned to this incident. | Text | Optional | |
Status | Enter the status of the incident. | Text | Optional | Allowed values:
|
Severity | Enter the severity of the incident. | Text | Optional | Allowed values:
|
Action: Generic Action
This is a generic action used to make requests to any Authomize endpoint.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Method | Enter the HTTP method to make the request. | Text | Required | Allowed values:
|
Endpoint | Enter the endpoint to make the request. Example: /api/vulnerabilities/{cve_id}/affected-projects | Text | Required | |
Query Params | Enter the query parameters to pass to the API. Example: id: s647382829tdf | Key Value | Optional | |
Payload | Enter the payload to pass to the API. Example: name: john | Any | Optional | |
Extra Fields | Enter the extra fields to pass to the API. Example: action: block | Key Value | Optional |