Skip to main content

Jira Event Collector

This Integration is part of the Atlassian Jira Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.5.0 and later.

This integration was integrated and tested with version 3 of Jira Event Collector rest API.

This is the default integration for this content pack when configured by the Data Onboarder in Cortex XSIAM.

Configure Jira Event Collector on Cortex XSIAM#

  1. Navigate to Settings > Configurations > Data Collection > Automations & Feed Integrations.

  2. Search for Jira Event Collector.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    Server URLTrue
    User nameThe user name. For example, admin@example.comTrue
    PasswordTrue
    First fetch time(<number> <time unit>. For example, 12 hours, 1 day, 3 months). Default is 3 days.
    The maximum number of incidents per fetch.Default is 1000.
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the War Room, 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.

jira-get-events#


Base Command#

jira-get-events

Input#

Argument NameDescriptionRequired
max_fetchThe maximum number of events per fetch. Default is 1000.Optional
first_fetchFirst fetch time (<number> <time unit>, e.g., 12 hours, 1 day, 3 months). default is 3 days.Optional

Command example#

!jira-get-events max_fetch=2

Context Example#

{
"Jira": {
"Records": [
{
"associatedItems": [
{
"id": "ug:123456-123456-123456",
"name": "ug:123456-123456-123456",
"parentId": "111",
"parentName": "com.atlassian.crowd.directory.example",
"typeName": "USER"
}
],
"category": "group management",
"created": "2022-04-24T16:28:53.146+0000",
"eventSource": "",
"id": 1111,
"objectItem": {
"name": "jira-servicemanagement-users",
"parentId": "111",
"parentName": "com.atlassian.crowd.directory.example",
"typeName": "GROUP"
},
"summary": "User added to group"
},
{
"associatedItems": [
{
"id": "ug:123456-123456-123457",
"name": "ug:123456-123456-123457",
"parentId": "111",
"parentName": "com.atlassian.crowd.directory.example",
"typeName": "USER"
}
],
"category": "group management",
"created": "2022-04-24T16:28:53.098+0000",
"eventSource": "",
"id": 1110,
"objectItem": {
"name": "jira-software-users",
"parentId": "111",
"parentName": "com.atlassian.crowd.directory.example",
"typeName": "GROUP"
},
"summary": "User added to group"
}
]
}
}

Human Readable Output#

Jira records#

Associated ItemsCategoryCreatedIdObject ItemSummary
{'id': 'ug:123456-123456-123456', 'name': 'ug:123456-123456-123456', 'typeName': 'USER', 'parentId': '111', 'parentName': 'com.atlassian.crowd.directory.example'}group management2022-04-24T16:28:53.146+00001111name: jira-servicemanagement-users
typeName: GROUP
parentId: 111
parentName: com.atlassian.crowd.directory.example
User added to group
{'id': 'ug:123456-123456-123457', 'name': 'ug:123456-123456-123457', 'typeName': 'USER', 'parentId': '111', 'parentName': 'com.atlassian.crowd.directory.example'}group management2022-04-24T16:28:53.098+00001110name: jira-software-users
typeName: GROUP
parentId: 111
parentName: com.atlassian.crowd.directory.example
User added to group