Aha

Details

ID	`Aha`
Provider	Aha Labs Inc.
Category	Utilities
From Version	6.5.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM

README

Use the Aha! integration to list and manage Cortex XSOAR features from Aha.
This integration was integrated and tested with API version December 02, 2022 release of Aha.

Configure Aha in Cortex

Parameter	Description	Required
Server URL		True
Project Name	Check the Aha! project name in the URL. Replace the <PROJECT_NAME> placeholder in the following : example.com.aha.io/products/<PROJECT_NAME>/features.	True
Api Key	API Key to access the service REST API.	True
Trust any certificate (not secure)		False
Use system proxy settings		False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

aha-get-features

Lists all features from service, unless a specific feature is specified.

Base Command

aha-get-features

Input

Argument Name	Description	Required
from_date	Show features created after this date. Default is 2020-01-01.	Optional
feature_name	The name of a specific feature to retrieve.	Optional
fields	A comma-separated list of fields to include in the Aha! service response. Default is name,reference_num,id,created_at.	Optional
page	The specific results page to retrieve. Default is 1.	Optional
per_page	The maximum number of results per page. Default is 30.	Optional

Context Output

Path	Type	Description
AHA.Feature.id	UUID	The feature ID.
AHA.Feature.name	String	The feature name.
AHA.Feature.reference_num	String	The feature reference number.
AHA.Feature.workflow_status	String	The feature status description.
AHA.Feature.description	String	The feature description.
AHA.Feature.created_at	Date	The feature creation date.

Command example

!aha-get-features
!aha-get-features feature_name=DEMO-10 fields=workflow_status
!aha-get-features fields=workflow_status page=2 per_page=30

aha-edit-feature

You can edit the following fields in a feature: Name and Description.

Base Command

aha-edit-feature

Input

Argument Name	Description	Required
feature_name	The name of the feature to edit.	Required
fields	Fields in JSON format to edit in a feature. Possible fields are name and status. Status should match Aha values under workflow_status. Example:” {“name”: “name”, “status” : “Closed”}.	Required

Context Output

Path	Type	Description
AHA.Feature.id	UUID	The feature ID.
AHA.Feature.name	String	The feature name.
AHA.Feature.reference_num	String	The feature reference number.
AHA.Feature.workflow_status	String	The feature status description.
AHA.Feature.description	String	The feature description.
AHA.Feature.created_at	Date	The feature creation date.

Command example

!aha-edit-feature feature_name=DEMO-10 fields=`{"name":"the_new_name", "status":"Closed"}

aha-get-ideas

Lists all ideas from service, unless a specific idea is specified.

Base Command

aha-get-ideas

Input

Argument Name	Description	Required
from_date	Show ideas created after this date. Default is 2020-01-01.	Optional
idea_name	The name of a specific idea to retrieve.	Optional
fields	A comma-separated list of fields to include in the Aha! service response. Default is name,reference_num,id,created_at.	Optional
page	The specific results page to retrieve. Default is 1.	Optional
per_page	The maximum number of results per page. Default is 30.	Optional

Context Output

Path	Type	Description
AHA.Idea.id	UUID	The idea ID.
AHA.Idea.name	String	The idea name.
AHA.Idea.reference_num	String	The idea reference number.
AHA.Idea.workflow_status	String	The idea status description.
AHA.Idea.description	String	The idea description.
AHA.Idea.created_at	Date	The idea creation date.

Command example

!aha-get-ideas
!aha-get-ideas idea_name=DEMO-I-2895
!aha-get-ideas idea_name=DEMO-I-2895 fields=workflow_status

aha-edit-idea

Edit an idea status to Shipped.

Base Command

aha-edit-idea

Input

Argument Name	Description	Required
idea_name	The name of the idea to edit.	Required

Context Output

Path	Type	Description
AHA.Idea.id	UUID	The idea ID.
AHA.Idea.name	String	The idea name.
AHA.Idea.reference_num	String	The idea reference number.
AHA.Idea.workflow_status	String	The idea status description.
AHA.Idea.description	String	The idea description.
AHA.Idea.created_at	Date	The idea creation date.

Command example

!aha-edit-idea idea_name=DEMO-I-2895

Configuration parameters

url — Server URL (required)
project_name — Project Name (required)
api_key — (required)
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (4)

aha-edit-feature
You can edit the following fields in a feature: Name and Status.
aha-edit-idea
Edit an idea status to Shipped.
aha-get-features
Lists all features from service, unless a specific feature is specified.
aha-get-ideas
Lists all ideas from service, unless a specific idea is specified.

Source

AHA.py AHA_test.py AHA.yml AHA_description.md command_examples.txt

Download History Raw

category: Utilities
provider: Aha Labs Inc.
commonfields:
  id: Aha
  version: -1
configuration:
- name: url
  display: Server URL
  required: true
  defaultvalue: https://example.com/
  type: 0
  additionalinfo:
- name: project_name
  display: Project Name
  required: true
  defaultvalue: DEMO
  type: 0
  additionalinfo: "Check the Aha! project name in the URL. Replace the <PROJECT_NAME> placeholder in the following : example.com.aha.io/products/<PROJECT_NAME>/features."
- name: api_key
  displaypassword: Api Key
  required: true
  defaultvalue:
  type: 9
  hiddenusername: true
  additionalinfo: "API Key to access the service REST API."
- name: insecure
  display: Trust any certificate (not secure)
  type: 8
  additionalinfo:
  required: false
- name: proxy
  display: Use system proxy settings
  type: 8
  additionalinfo:
  required: false
description: Use the Aha! integration to list and manage Cortex XSOAR features from Aha.
display: Aha
name: Aha
script:
  commands:
  - name: aha-get-features
    description: Lists all features from service, unless a specific feature is specified.
    arguments:
    - name: from_date
      description: Show features created after this date.
      defaultValue: "2020-01-01"
    - name: feature_name
      description: The name of a specific feature to retrieve.
      defaultValue: ""
    - name: fields
      description: A comma-separated list of fields to include in the Aha! service response.
      defaultValue: "name,reference_num,id,created_at"
    - name: page
      description: The specific results page to retrieve.
      defaultValue: "1"
    - name: per_page
      description: The maximum number of results per page.
      defaultValue: "30"
    outputs:
    - contextPath: AHA.Feature.id
      description: The feature ID.
      type: UUID
    - contextPath: AHA.Feature.name
      description: The feature name.
      type: String
    - contextPath: AHA.Feature.reference_num
      description: The feature reference number.
      type: String
    - contextPath: AHA.Feature.workflow_status
      description: The feature status description.
      type: String
    - contextPath: AHA.Feature.description
      description: The feature description.
      type: String
    - contextPath: AHA.Feature.created_at
      description: The feature creation date.
      type: Date
  - name: aha-edit-feature
    description: "You can edit the following fields in a feature: Name and Status."
    arguments:
    - name: feature_name
      description: The name of the feature to edit.
      required: true
      defaultValue: ""
    - name: fields
      description: 'Fields in JSON format to edit in a feature. Possible fields are name and status. Status should match Aha values under workflow_status. Example:" {"name": "name", "status" : "Closed"}.'
      required: true
      defaultValue: ""
    outputs:
    - contextPath: AHA.Feature.id
      description: The feature ID.
      type: UUID
    - contextPath: AHA.Feature.name
      description: The feature name.
      type: String
    - contextPath: AHA.Feature.reference_num
      description: The feature reference number.
      type: String
    - contextPath: AHA.Feature.description
      description: The feature description.
      type: String
    - contextPath: AHA.Feature.workflow_status
      description: The feature status description.
      type: String
    - contextPath: AHA.Feature.created_at
      description: The feature creation date.
      type: Date
  - name: aha-get-ideas
    description: Lists all ideas from service, unless a specific idea is specified.
    arguments:
    - name: from_date
      description: Show ideas created after this date.
      defaultValue: "2020-01-01"
    - name: idea_name
      description: The name of a specific idea to retrieve.
      defaultValue: ""
    - name: fields
      description: A comma-separated list of fields to include in the Aha! service response.
      defaultValue: "name,reference_num,id,created_at"
    - name: page
      description: The specific results page to retrieve.
      defaultValue: "1"
    - name: per_page
      description: The maximum number of results per page.
      defaultValue: "30"
    outputs:
    - contextPath: AHA.Idea.id
      description: The idea ID.
      type: UUID
    - contextPath: AHA.Idea.name
      description: The idea name.
      type: String
    - contextPath: AHA.Idea.reference_num
      description: The idea reference number.
      type: String
    - contextPath: AHA.Idea.workflow_status
      description: The idea status description.
      type: String
    - contextPath: AHA.Idea.description
      description: The idea description.
      type: String
    - contextPath: AHA.Idea.created_at
      description: The idea creation date.
      type: Date
  - name: aha-edit-idea
    description: "Edit an idea status to Shipped."
    arguments:
    - name: idea_name
      description: The name of the idea to edit.
      required: true
      defaultValue: ""
    outputs:
    - contextPath: AHA.Idea.id
      description: The idea ID.
      type: UUID
    - contextPath: AHA.Idea.name
      description: The idea name.
      type: String
    - contextPath: AHA.Idea.reference_num
      description: The idea reference number.
      type: String
    - contextPath: AHA.Idea.workflow_status
      description: The idea status description.
      type: String
    - contextPath: AHA.Idea.description
      description: The idea description.
      type: String
    - contextPath: AHA.Idea.created_at
      description: The idea creation date.
      type: Date
  runonce: false
  script: "-"
  type: python
  subtype: python3
  dockerimage: demisto/python3:3.12.13.10116658
fromversion: 6.5.0
tests:
- No tests (auto formatted)