category: Data Enrichment & Threat Intelligence
provider: Pentera
commonfields:
  id: Pentera
  version: -1
configuration:
- defaultvalue: https://pentera.com
  display: Server URL (e.g. https://192.168.64.128)
  name: url
  required: true
  type: 0
- defaultvalue: '5555'
  display: Pentera API port
  name: port
  required: true
  type: 0
- display: Client Id
  name: clientId
  required: true
  type: 0
- display: TGT  (The token from Pentera UI in Administration -> API Clients)
  name: tgt
  required: true
  type: 4
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
description: Automate remediation actions based on Pentera, the Automated Security Validation Platform, proactively exposing high-risk vulnerabilities.
display: Pentera
name: Pentera
script:
  commands:
  - arguments:
    - description: The name of the template that you want to run.
      name: template_name
      required: true
    description: Run a specific template by its name. Please add the template name in the parameters.
    name: pentera-run-template-by-name
    outputs:
    - contextPath: Pentera.TaskRun.TemplateName
      description: Returns the name of the template.
      type: String
    - contextPath: Pentera.TaskRun.ID
      description: The task run id.
      type: String
    - contextPath: Pentera.TaskRun.StartTime
      description: The date when the task run started.
      type: Date
    - contextPath: Pentera.TaskRun.EndTime
      description: The date when the task run ended.
      type: Date
    - contextPath: Pentera.TaskRun.Status
      description: 'The status of the task run; e.g.: Running, Done, etc.'
      type: String
  - arguments:
    - description: The ID of the task run.
      name: task_run_id
      required: true
    description: Get the status of a task run by its task run id.
    name: pentera-get-task-run-status
    outputs:
    - contextPath: Pentera.TaskRun.ID
      description: The task run id.
      type: String
    - contextPath: Pentera.TaskRun.TemplateName
      description: Returns the name of the template.
      type: String
    - contextPath: Pentera.TaskRun.StartTime
      description: The date when the task run started.
      type: Date
    - contextPath: Pentera.TaskRun.EndTime
      description: The date when the task run ended.
      type: Date
    - contextPath: Pentera.TaskRun.Status
      description: 'The status of the task run; e.g.: Running, Done, etc.'
      type: String
  - arguments:
    - description: The ID of the task run.
      name: task_run_id
      required: true
    description: Get the full action report of a task run.
    name: pentera-get-task-run-full-action-report
    outputs:
    - contextPath: Pentera.TaskRun.ID
      description: The task run id.
      type: String
    - contextPath: Pentera.TaskRun.TemplateName
      description: Returns the name of the template.
      type: String
    - contextPath: Pentera.TaskRun.StartTime
      description: The date when the task run started.
      type: Date
    - contextPath: Pentera.TaskRun.EndTime
      description: The date when the task run ended.
      type: Date
    - contextPath: Pentera.TaskRun.Status
      description: 'The status of the task run; e.g.: Running, Done, etc.'
      type: String
    - contextPath: Pentera.TaskRun.FullActionReport.Severity
      description: The sevirity of the action, from N/A to 10.0.
      type: Number
    - contextPath: Pentera.TaskRun.FullActionReport.Time
      description: The full date the action took place.
      type: Date
    - contextPath: Pentera.TaskRun.FullActionReport.Duration
      description: The duration of the action in milliseconds.
      type: Number
    - contextPath: Pentera.TaskRun.FullActionReport.OperationType
      description: 'The type of the action that ran; e.g.: "Scanning hosts", "Malware injected to host", etc.'
      type: String
    - contextPath: Pentera.TaskRun.FullActionReport.Techniques
      description: The MITRE technique(s) used with the relevant MITRE ID.
      type: String
    - contextPath: Pentera.TaskRun.FullActionReport.Parameters
      description: 'The relevant parameters of the action; e.g.: List of hosts IP addresses.'
      type: String
    - contextPath: Pentera.TaskRun.FullActionReport.Status
      description: 'The status of the action. Can be: success, failed, canceled, no_results.'
      type: String
  dockerimage: demisto/auth-utils:1.0.0.3562326
  runonce: false
  script: '-'
  subtype: python3
  type: python
fromversion: 5.0.0
tests:
- No tests (auto formatted)