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#

Navigate to Settings > Configurations > Data Collection > Automations & Feed Integrations.
Search for Jira Event Collector.

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

Parameter	Description	Required
Server URL		True
User name	The user name. For example, `admin@example.com`	True
Password		True
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 settings		False

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 Name	Description	Required
max_fetch	The maximum number of events per fetch. Default is 1000.	Optional
first_fetch	First 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 Items Category Created Id Object Item Summary
{'id': 'ug:123456-123456-123456', 'name': 'ug:123456-123456-123456', 'typeName': 'USER', 'parentId': '111', 'parentName': 'com.atlassian.crowd.directory.example'} group management 2022-04-24T16:28:53.146+0000 1111 name: 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 management 2022-04-24T16:28:53.098+0000 1110 name: jira-software-users
typeName: GROUP
parentId: 111
parentName: com.atlassian.crowd.directory.example User added to group

Associated Items	Category	Created	Id	Object Item	Summary
{'id': 'ug:123456-123456-123456', 'name': 'ug:123456-123456-123456', 'typeName': 'USER', 'parentId': '111', 'parentName': 'com.atlassian.crowd.directory.example'}	group management	2022-04-24T16:28:53.146+0000	1111	name: 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 management	2022-04-24T16:28:53.098+0000	1110	name: jira-software-users typeName: GROUP parentId: 111 parentName: com.atlassian.crowd.directory.example	User added to group