SecurityAgent / Client / list_pentest_job_tasks

list_pentest_job_tasks¶

SecurityAgent.Client.list_pentest_job_tasks(**kwargs)¶

Lists tasks associated with a specific pentest job

Request Syntax

response = client.list_pentest_job_tasks(
    agentSpaceId='string',
    maxResults=123,
    pentestJobId='string',
    stepName='PREFLIGHT'|'STATIC_ANALYSIS'|'PENTEST'|'FINALIZING',
    categoryName='string',
    nextToken='string'
)

Parameters:

agentSpaceId (string) –
[REQUIRED]

ID of the agent space where the pentest exists
maxResults (integer) – Maximum number of tasks to return in a single request
pentestJobId (string) – Identifier of the pentest job whose tasks to list
stepName (string) – Filter tasks by step name
categoryName (string) – Filter tasks by category name.
nextToken (string) – Token for pagination to retrieve the next set of results

Return type:

dict

Returns:

Response Syntax

{
    'taskSummaries': [
        {
            'taskId': 'string',
            'pentestId': 'string',
            'pentestJobId': 'string',
            'agentSpaceId': 'string',
            'title': 'string',
            'riskType': 'CROSS_SITE_SCRIPTING'|'DEFAULT_CREDENTIALS'|'INSECURE_DIRECT_OBJECT_REFERENCE'|'PRIVILEGE_ESCALATION'|'SERVER_SIDE_TEMPLATE_INJECTION'|'COMMAND_INJECTION'|'CODE_INJECTION'|'SQL_INJECTION'|'ARBITRARY_FILE_UPLOAD'|'INSECURE_DESERIALIZATION'|'LOCAL_FILE_INCLUSION'|'INFORMATION_DISCLOSURE'|'PATH_TRAVERSAL'|'SERVER_SIDE_REQUEST_FORGERY'|'JSON_WEB_TOKEN_VULNERABILITIES'|'XML_EXTERNAL_ENTITY'|'FILE_DELETION'|'OTHER'|'GRAPHQL_VULNERABILITIES'|'BUSINESS_LOGIC_VULNERABILITIES'|'CRYPTOGRAPHIC_VULNERABILITIES'|'DENIAL_OF_SERVICE'|'FILE_ACCESS'|'FILE_CREATION'|'DATABASE_MODIFICATION'|'DATABASE_ACCESS'|'OUTBOUND_SERVICE_REQUEST'|'UNKNOWN',
            'executionStatus': 'IN_PROGRESS'|'ABORTED'|'COMPLETED'|'INTERNAL_ERROR'|'FAILED',
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) –

Output for the ListPentestJobTasks operation
- taskSummaries (list) –
  
  List of task summaries associated with the specified pentest job
  - (dict) –
    
    Summary information for a task
    - taskId (string) –
      
      Unique identifier for the task
    - pentestId (string) –
      
      Identifier of the parent pentest
    - pentestJobId (string) –
      
      Identifier of the pentest job this task belongs to
    - agentSpaceId (string) –
      
      Identifier of the agent space this task belongs to
    - title (string) –
      
      Title or name of the task
    - riskType (string) –
      
      Type of security risk this task is designed to test
    - executionStatus (string) –
      
      Current status of the task execution
    - createdAt (datetime) –
      
      Timestamp when the task was created
    - updatedAt (datetime) –
      
      Timestamp when the task was last updated
- nextToken (string) –
  
  Token for pagination to retrieve the next set of results