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.

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 100 maximum 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 100 maximum 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