이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Jira

통합 버전: 41.0

Google Security Operations와 함께 작동하도록 Jira 구성

API 토큰 만들기

Atlassian 계정에서 API 토큰을 만듭니다.

Atlassian 계정에 로그인합니다.
API 토큰 만들기를 클릭합니다.
표시되는 대화상자에서 기억하기 쉽고 간결한 토큰 라벨을 입력하고 만들기를 클릭합니다.
클립보드에 복사를 클릭한 다음 토큰을 안전한 곳에 붙여넣어 저장합니다.

Google SecOps에서 Jira 통합 구성

Google SecOps에서 통합을 구성하는 방법에 대한 자세한 내용은 통합 구성을 참고하세요.

통합 매개변수

다음 매개변수를 사용하여 통합을 구성합니다.

매개변수 표시 이름	유형	기본값	필수 항목	설명
인스턴스 이름	문자열	해당 사항 없음	No	통합을 구성할 인스턴스의 이름입니다.
설명	문자열	해당 사항 없음	No	인스턴스에 대한 설명입니다.
API 루트	문자열	https://{jira_address}	예	Jira 인스턴스의 주소입니다.
사용자 이름	문자열	해당 사항 없음	예	Jira에 연결하는 데 사용해야 하는 사용자 이름입니다.
API 토큰	비밀번호	해당 사항 없음	예	Jira 콘솔에서 생성된 토큰입니다. 참고: 이 매개변수는 사용자 이름과 비밀번호 조합을 사용하는 온프레미스 인증의 경우 'Password' 문자열을 포함하는 데 사용할 수 있습니다.
SSL 확인	체크박스	선택 해제	아니요	Jira 연결에 SSL 확인이 필요한 경우 이 체크박스를 사용합니다.
원격 실행	체크박스	선택 해제	No	구성된 통합을 원격으로 실행하려면 필드를 선택합니다. 선택하면 원격 사용자(에이전트)를 선택하는 옵션이 나타납니다.

작업

의견 추가

설명

문제에 대한 댓글을 작성하면 문제에 관한 추가 요소를 문서화하고 팀 구성원과 소통하는 데 효과적입니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
문제 키	문자열	해당 사항 없음	예	문제의 문제 키입니다. 예: ABC-123
댓글	문자열	해당 사항 없음	예	문제에 추가할 댓글 콘텐츠입니다.

유형

기본값

필수 항목

설명

문제 키

문자열

해당 사항 없음

예

문제의 문제 키입니다.

예: ABC-123

문자열

해당 사항 없음

예

문제에 추가할 댓글 콘텐츠입니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
comment_id	해당 사항 없음	해당 사항 없음

JSON 결과

N/A

문제 할당

설명

특정 사용자에게 문제를 할당합니다. Jira 사용자 이름은 이름이나 메일일 수 있습니다. 새 Jira API의 경우 작업은 사용자 이메일을 기반으로 담당자를 일치시켜 문제를 할당한 다음 displayName 필드를 사용하여 시도합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
문제 키	문자열	해당 사항 없음	예	문제의 문제 키입니다.
담당자	문자열	해당 사항 없음	예	문제의 새 할당자입니다.
Jira 사용자 이름	문자열	해당 사항 없음	아니요	작업을 시작한 사용자의 Jira 사용자 이름입니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
성공	True/False	success:False

알림 문제 만들기

설명

특정 그룹에 인시던트를 할당합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
프로젝트 키	문자열	해당 사항 없음	예	문제를 생성할 프로젝트의 키입니다.
요약	문자열	해당 사항 없음	예	문제 요약
문제 유형	문자열	해당 사항 없음	예	문제 유형입니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
issue_key	해당 사항 없음	해당 사항 없음

JSON 결과

{
   "comment":
      {
        "total": 0,
        "startAt": 0,
        "comments": [],
        "maxResults": 0
       },
   "Creator":
      {
        "displayName": "user1",
        "name": "user1",
        "self": "",
        "avatarUrls":
           {
              "24x24": "",
              "16x16": "",
              "48x48": "",
              "32x32": ""
            },
        "emailAddress": "john_doe@example.com",
        "key": "user1user",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": "0"
       },
   "aggregatetimeestimate": null,
   "labels": ["Label1"],
   "aggregatetimespent": null,
   "watches":
       {
         "self": "",
         "watchCount": 1,
         "isWatching": false
        },
   "Assignee":
       {
         "displayName": "user2",
         "name": "user2",
         "self": "",
         "avatarUrls":
            {
                "24x24": "",
                "16x16": "",
                "48x48": "",
                "32x32": ""
             },
         "emailAddress": "john_doe@example.com",
         "key": "user2",
         "active": true,
         "timeZone": "Asia/Jerusalem",
         "accountId": ""
         },
   "lastViewed": "2019-01-22T10:14:02.910+0200",
   "issuelinks": [],
   "worklog":
        {
         "worklogs": [],
         "total": 0,
         "startAt": 0,
         "maxResults": 20
        },
   "aggregateprogress":
        {
         "progress": 0,
         "total": 0
        },
   "priority":
        {
         "iconUrl": "",
         "self": "",
         "name": "Medium",
         "id": "3"
         },
    "votes":
        {
         "hasVoted": false,
         "self": "", "votes": 0
        },
    "workratio": -1,
    "fixVersions": [],
    "environment": null,
    "timespent": null,
    "attachment":
      [{
         "mimeType": "binary/octet-stream",
         "created": "2018-06-19T15:23:07.369+0300",
         "self": "",
         "Author":
             {
                "displayName": "user1",
                "name": "user1",
                "self": "",
                "avatarUrls":
                    {
                      "24x24": "",
                      "16x16": "",
                      "48x48": "",
                      "32x32": ""
                     },
                "emailAddress": "john_doe@example.com",
                "key": "user1",
                "active": true,
                "timeZone": "Asia/Jerusalem",
                "accountId": "0"
              },
         "filename": "file.rar",
         "content": "",
         "id": "0",
         "size": 0
        }],
    "progress": {"progress": 0,
                 "total": 0},
    "duedate": null,
    "status":
        {
          "statusCategory":
              {
                 "name": "Done",
                 "self": "",
                 "id": 3,
                 "key": "done",
                 "colorName": "green"
               },
           "description": "",
           "self": "",
           "iconUrl": "",
           "id": "0",
           "name": "DONE"
         },
    "updated": "2018-09-18T10:02:06.347+0300",
    "subtasks": [],
    "description": "Create Enrich entities action using Insights API (IOC search)\\n\\nWrite connector for laerts\\n\\nIn a couple of days we will have access to an instance",
    "reporter":
         {
            "displayName": "user1",
            "name": "user1",
            "self": "",
            "avatarUrls":
               {
                  "24x24": "",
                  "16x16": "",
                  "48x48": "",
                  "32x32": ""
               },
            "emailAddress": "john_doe@example.com",
            "key": "user1",
            "active": true,
             "timeZone": "Asia/Jerusalem",
             "accountId": "0"
           },
    "timeoriginalestimate": null,
    "aggregatetimeoriginalestimate": null,
    "created": "2018-06-19T15:23:13.701+0300",
    "versions": [],
    "resolutiondate": "2018-09-18T10:02:06.340+0300",
    "summary": "Sample issue",
    "project":
          {
             "name": "Project 1",
             "self": "",
             "projectTypeKey": "software",
             "avatarUrls":
                {
                  "24x24": "",
                  "16x16": "",
                  "48x48": "",
                  "32x32": ""
                },
            "key": "PR",
            "id": "0"
          },
    "timetracking": {},
    "components": [],
    "issuetype":
         {
            "name": "Task",
            "self": "",
            "iconUrl": "",
            "subtask": false,
            "avatarId": 10318,
            "id": "10002",
            "description": "A task that needs to be done."
          },
    "security": null,
    "resolution":
          {
            "id": "10000",
            "self": "",
            "description": "Work has been completed on this issue.",
            "name": "Done"
          },
  "timeestimate": null
}

문제 만들기

설명

프로젝트에서 문제를 만듭니다. Jira 사용자 이름은 이름이나 메일일 수 있습니다. 새 Jira API의 경우 작업은 사용자 이메일을 기반으로 담당자를 일치시켜 문제를 할당한 다음 displayName 필드를 사용하여 시도합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
프로젝트 키	문자열	해당 사항 없음	예	문제를 만들 프로젝트의 키입니다.
요약	문자열	해당 사항 없음	예	문제 요약
설명	문자열	해당 사항 없음	예	문제에 대한 설명입니다.
문제 유형	문자열	해당 사항 없음	예	문제 유형입니다.
담당자	문자열	해당 사항 없음	아니요	문제의 새 할당자입니다.
Jira 사용자 이름	문자열	해당 사항 없음	아니요	작업을 시작한 사용자의 Jira 사용자 이름입니다.
구성요소	문자열	해당 사항 없음	아니요	문제의 구성요소 필드입니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.
라벨	문자열	해당 사항 없음	아니요	문제의 구성요소 필드입니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.
커스텀 필드	JSON	해당 사항 없음	아니요	문제 생성 중에 사용될 모든 필드와 값을 포함하는 JSON 객체를 지정합니다. 참고: 이 매개변수가 우선순위를 가지며 모든 필드가 이 매개변수에 제공된 값으로 덮어쓰여집니다. 예: {'field':'value'}

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
issue_key	해당 사항 없음	해당 사항 없음

JSON 결과

N/A

문제 삭제

설명

문제를 삭제합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
문제 키	문자열	해당 사항 없음	예	삭제할 문제의 키입니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
성공	True/False	success:False

JSON 결과

N/A

첨부파일 다운로드

설명

문제 키를 가져오고 모든 첨부파일을 다운로드합니다. 그중 하나가 EML 파일인 경우 첨부파일 내에서도 다운로드합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
문제 키	문자열	해당 사항 없음	예	문제의 키입니다.
다운로드 경로	문자열	해당 사항 없음	아니요	첨부파일을 저장할 경로입니다.
케이스 월에 첨부파일 다운로드	체크박스	선택 해제	아니요	사용 설정하면 작업이 Jira 문제 첨부파일을 현재 Google SecOps 알림 케이스 월에 다운로드합니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

{
   "comment":
      {
        "total": 0,
        "startAt": 0,
        "comments": [],
        "maxResults": 0
       },
   "creator":
      {
        "displayName": "user1",
        "name": "user1",
        "self": "",
        "avatarUrls":
          {
            "24x24": "",
            "16x16": "",
            "48x48": "",
            "32x32": ""
            },
        "emailAddress": "john_doe@example.com",
        "key": "user1user",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": "0"
      },
    "aggregatetimeestimate": null,
    "labels": ["Label1"],
    "aggregatetimespent": null,
    "watches":
      {
        "self": "",
        "watchCount": 1,
        "isWatching": false
      },
     "assignee":
       {
        "displayName": "user2",
        "name": "user2",
        "self": "",
        "avatarUrls":
           {
             "24x24": "",
             "16x16": "",
             "48x48": "",
             "32x32": ""
            },
         "emailAddress": "john_doe@example.com",
         "key": "user2","active": true,
         "timeZone": "Asia/Jerusalem",
         "accountId": ""
        },
      "lastViewed": "2019-01-22T10:14:02.910+0200",
      "issuelinks": [],
      "worklog":
        {
          "worklogs": [],
          "total": 0,
          "startAt": 0,
          "maxResults": 20
         },
      "aggregateprogress":
        {
          "progress": 0,
          "total": 0
         },
      "Priority":
        {
          "iconUrl": "",
          "self": "",
          "name": "Medium",
          "id": "3"
         },
      "Votes":
         {
           "hasVoted": false,
           "self": "",
           "votes": 0
          },
      "workratio": -1,
      "fixVersions": [],
      "environment": null,
      "timespent": null,
      "attachment":
          [{
             "mimeType": "binary/octet-stream",
             "created": "2018-06-19T15:23:07.369+0300",
             "self": "",
             "author":
                {
                  "displayName": "user1",
                  "name": "user1",
                  "self": "",
                  "avatarUrls":
                      {
                        "24x24": "",
                        "16x16": "",
                        "48x48": "",
                        "32x32": ""
                      },
                 "emailAddress": "john_doe@example.com",
                 "key": "user1",
                 "active": true,
                 "timeZone": "Asia/Jerusalem",
                 "accountId": "0"
                 },
             "filename": "file.rar",
             "content": "",
             "id": "0",
             "size": 0
           }],
       "progress":
           {
             "progress": 0,
             "total": 0
            },
       "duedate": null,
       "status":
            {
             "statusCategory":
                 {
                   "name": "Done",
                   "self": "",
                   "id": 3,
                   "key": "done",
                   "colorName": "green"
                  },
             "description": "",
             "self": "",
             "iconUrl": "",
             "id": "0",
             "name": "DONE"
            },
       "updated": "2018-09-18T10:02:06.347+0300",
       "subtasks": [],
       "description": "Create Enrich entities action using Insights API (IOC search)\\n\\nWrite connector for laerts\\n\\nIn a couple of days we will have access to an instance",
       "reporter":
            {
              "displayName": "user1",
              "name": "user1",
              "self": "",
              "avatarUrls":
                  {
                    "24x24": "",
                    "16x16": "",
                    "48x48": "",
                    "32x32": ""
                   },
              "emailAddress": "john_doe@example.com",
              "key": "user1",
              "active": true,
              "timeZone": "Asia/Jerusalem",
              "accountId": "0"
             },
       "timeoriginalestimate": null,
       "aggregatetimeoriginalestimate": null,
       "created": "2018-06-19T15:23:13.701+0300",
       "versions": [],
       "resolutiondate": "2018-09-18T10:02:06.340+0300",
       "summary": "Sample issue",
       "project":
             {
               "name": "Project 1",
               "self": "",
               "projectTypeKey": "software",
               "avatarUrls":
                    {
                       "24x24": "",
                       "16x16": "",
                       "48x48": "",
                       "32x32": ""
                     },
               "key": "PR",
               "id": "0"
              },
        "timetracking": {},
        "components": [],
        "issuetype":
             {
               "name": "Task",
               "self": "",
               "iconUrl": "",
               "subtask": false,
               "avatarId": 10318,
               "id": "10002",
               "description": "A task that needs to be done."
              },
         "security": null,
         "resolution":
             {
               "id": "10000",
               "self": "",
               "description": "Work has been completed on this issue.",
               "name": "Done"
             },
         "timeestimate": null
 }

문제 가져오기

설명

키로 문제의 세부정보를 가져옵니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
문제 키	문자열	해당 사항 없음	예	가져올 문제의 키를 쉼표로 구분합니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
issues_details_list	True/False	issues_details_list:False

JSON 결과

{
   "comment":
      {
        "total": 0,
        "startAt": 0,
        "comments": [],
        "maxResults": 0
       },
   "creator":
      {
        "displayName": "user1",
        "name": "user1",
        "self": "",
        "avatarUrls":
          {
            "24x24": "",
            "16x16": "",
            "48x48": "",
            "32x32": ""
            },
        "emailAddress": "john_doe@example.com",
        "key": "user1user",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": "0"
      },
    "aggregatetimeestimate": null,
    "labels": ["Label1"],
    "aggregatetimespent": null,
    "watches":
      {
        "self": "",
        "watchCount": 1,
        "isWatching": false
      },
     "assignee":
       {
        "displayName": "user2",
        "name": "user2",
        "self": "",
        "avatarUrls":
           {
             "24x24": "",
             "16x16": "",
             "48x48": "",
             "32x32": ""
            },
         "emailAddress": "john_doe@example.com",
         "key": "user2","active": true,
         "timeZone": "Asia/Jerusalem",
         "accountId": ""
        },
      "lastViewed": "2019-01-22T10:14:02.910+0200",
      "issuelinks": [],
      "worklog":
        {
          "worklogs": [],
          "total": 0,
          "startAt": 0,
          "maxResults": 20
         },
      "aggregateprogress":
        {
          "progress": 0,
          "total": 0
         },
      "Priority":
        {
          "iconUrl": "",
          "self": "",
          "name": "Medium",
          "id": "3"
         },
      "Votes":
         {
           "hasVoted": false,
           "self": "",
           "votes": 0
          },
      "workratio": -1,
      "fixVersions": [],
      "environment": null,
      "timespent": null,
      "attachment":
          [{
             "mimeType": "binary/octet-stream",
             "created": "2018-06-19T15:23:07.369+0300",
             "self": "",
             "author":
                {
                  "displayName": "user1",
                  "name": "user1",
                  "self": "",
                  "avatarUrls":
                      {
                        "24x24": "",
                        "16x16": "",
                        "48x48": "",
                        "32x32": ""
                      },
                 "emailAddress": "john_doe@example.com",
                 "key": "user1",
                 "active": true,
                 "timeZone": "Asia/Jerusalem",
                 "accountId": "0"
                 },
             "filename": "file.rar",
             "content": "",
             "id": "0",
             "size": 0
           }],
       "progress":
           {
             "progress": 0,
             "total": 0
            },
       "duedate": null,
       "status":
            {
             "statusCategory":
                 {
                   "name": "Done",
                   "self": "",
                   "id": 3,
                   "key": "done",
                   "colorName": "green"
                  },
             "description": "",
             "self": "",
             "iconUrl": "",
             "id": "0",
             "name": "DONE"
            },
       "updated": "2018-09-18T10:02:06.347+0300",
       "subtasks": [],
       "description": "Create Enrich entities action using Insights API (IOC search)\\n\\nWrite connector for laerts\\n\\nIn a couple of days we will have access to an instance",
       "reporter":
            {
              "displayName": "user1",
              "name": "user1",
              "self": "",
              "avatarUrls":
                  {
                    "24x24": "",
                    "16x16": "",
                    "48x48": "",
                    "32x32": ""
                   },
              "emailAddress": "john_doe@example.com",
              "key": "user1",
              "active": true,
              "timeZone": "Asia/Jerusalem",
              "accountId": "0"
             },
       "timeoriginalestimate": null,
       "aggregatetimeoriginalestimate": null,
       "created": "2018-06-19T15:23:13.701+0300",
       "versions": [],
       "resolutiondate": "2018-09-18T10:02:06.340+0300",
       "summary": "Sample issue",
       "project":
             {
               "name": "Project 1",
               "self": "",
               "projectTypeKey": "software",
               "avatarUrls":
                    {
                       "24x24": "",
                       "16x16": "",
                       "48x48": "",
                       "32x32": ""
                     },
               "key": "PR",
               "id": "0"
              },
        "timetracking": {},
        "components": [],
        "issuetype":
             {
               "name": "Task",
               "self": "",
               "iconUrl": "",
               "subtask": false,
               "avatarId": 10318,
               "id": "10002",
               "description": "A task that needs to be done."
              },
         "security": null,
         "resolution":
             {
               "id": "10000",
               "self": "",
               "description": "Work has been completed on this issue.",
               "name": "Done"
             },
         "timeestimate": null
 }

문제 나열

설명

문제를 검색합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
프로젝트 이름	문자열	해당 사항 없음	아니요	검색할 프로젝트의 이름입니다(쉼표로 구분).
요약	문자열	해당 사항 없음	아니요	필터링할 요약입니다.
설명	문자열	해당 사항 없음	아니요	필터링할 설명입니다.
문제 유형	문자열	버그	아니요	필터링할 문제 유형입니다.
우선순위	문자열	해당 사항 없음	아니요	필터링할 우선순위입니다.
생성 위치	문자열	해당 사항 없음	아니요	필터링할 가장 빠른 생성 날짜입니다. 형식: YYYY/MM/DD
업데이트 출처	문자열	해당 사항 없음	아니요	필터링할 가장 빠른 업데이트 날짜입니다. 형식: YYYY/MM/DD
할당된 사용자	문자열	해당 사항 없음	아니요	쉼표로 구분된 필터링할 할당자의 이름입니다.
신고자	문자열	해당 사항 없음	아니요	쉼표로 구분된 필터링할 신고자의 이름입니다.
상태	문자열	해당 사항 없음	아니요	쉼표로 구분된 필터링할 상태입니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
문제	True/False	issues:False

JSON 결과

[ "PR-123", "PR-124"]

핑

설명

사용자가 사용자 기기를 통해 Jira에 연결되어 있는지 확인합니다.

매개변수

이 작업에는 입력 매개변수가 없습니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
성공	True/False	success:False

JSON 결과

N/A

문제 업데이트

설명

문제를 업데이트합니다. 새 Jira API의 경우 작업은 사용자 이메일을 기반으로 문제를 할당할 담당자를 찾은 다음 displayName 필드를 사용하여 시도합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
문제 키	문자열	해당 사항 없음	예	업데이트할 문제의 키입니다.
상태	문자열	해당 사항 없음	아니요	이 문제를 원하는 새 상태로 전환하려면 관련 전환 이름을 지정하세요.
요약	문자열	해당 사항 없음	아니요	문제의 새 요약입니다.
설명	문자열	해당 사항 없음	아니요	문제에 관한 새로운 설명입니다.
문제 유형	문자열	해당 사항 없음	아니요	새 문제 유형입니다.
담당자	문자열	해당 사항 없음	아니요	문제의 새 할당자입니다.
Jira 사용자 이름	문자열	해당 사항 없음	아니요	작업 시작자의 Jira 사용자 이름입니다.
구성요소	문자열	해당 사항 없음	아니요	문제의 구성요소 필드입니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.
커스텀 필드	JSON	해당 사항 없음	아니요	문제 생성 중에 사용되는 모든 필드와 값을 포함하는 JSON 객체를 지정합니다. 참고: 이 매개변수가 우선순위를 가지며 모든 필드가 이 매개변수에 제공된 값으로 덮어쓰여집니다. 예: {'field':'value'}
라벨	문자열	해당 사항 없음	아니요	문제의 구성요소 필드입니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
성공	True/False	Success:False

JSON 결과

{
   "comment":
     {
       "total": 0,
       "startAt": 0,
       "comments": [],
       "maxResults": 0
      },
   "creator":
     {
       "displayName": "user1",
       "name": "user1",
       "self": "",
       "avatarUrls":
          {
            "24x24": "",
            "16x16": "",
            "48x48": "",
            "32x32": ""
           },
        "emailAddress": "john_doe@example.com",
        "key": "user1user",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": "0"
       },
   "aggregatetimeestimate": null,
   "labels": ["Label1"],
   "aggregatetimespent": null,
   "watches":
      {
        "self": "",
        "watchCount": 1,
        "isWatching": false
       },
   "assignee":
      {
        "displayName": "user2",
        "name": "user2",
        "self": "",
        "avatarUrls":
           {
              "24x24": "",
              "16x16": "",
              "48x48": "",
              "32x32": ""
            },
        "emailAddress": "john_doe@example.com",
        "key": "user2",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": ""
       },
   "lastViewed": "2019-01-22T10:14:02.910+0200",
   "issuelinks": [],
   "Worklog":
      {
        "worklogs": [],
        "total": 0,
        "startAt": 0,
        "maxResults": 20
       },
   "aggregateprogress":
      {
        "progress": 0,
        "total": 0
       },
   "Priority":
      {
        "iconUrl": "",
        "self": "",
        "name": "Medium",
        "id": "3"
       },
   "votes":
       {
          "hasVoted": false,
          "self": "",
          "votes": 0
        },
   "workratio": -1,
   "fixVersions": [],
   "environment": null,
   "timespent": null,
   "attachment":
      [{
          "mimeType": "binary/octet-stream",
          "created": "2018-06-19T15:23:07.369+0300",
          "self": "",
          "author":
             {
               "displayName": "user1",
               "name": "user1",
               "self": "",
               "avatarUrls":
                  {
                     "24x24": "",
                     "16x16": "",
                     "48x48": "",
                     "32x32": ""
                   },
               "emailAddress": "john_doe@example.com",
               "key": "user1",
               "active": true,
               "timeZone": "Asia/Jerusalem",
               "accountId": "0"
              },
           "filename": "file.rar",
           "content": "",
           "id": "0",
           "size": 0
        }],
   "progress":
        {
          "progress": 0,
          "total": 0
         },
   "duedate": null,
   "status":
        {
          "statusCategory":
              {
                 "name": "Done",
                 "self": "",
                 "id": 3,
                 "key": "done",
                 "colorName": "green"
               },
          "description": "",
          "self": "",
          "iconUrl": "",
          "id": "0",
          "name": "DONE"
         },
   "updated": "2018-09-18T10:02:06.347+0300",
   "subtasks": [],
   "description": "Create Enrich entities action using Insights API (IOC search)\\n\\nWrite connector for laerts\\n\\nIn a couple of days we will have access to an instance",
   "reporter":
         {
           "displayName": "user1",
           "name": "user1",
           "self": "",
           "avatarUrls":
               {
                 "24x24": "",
                 "16x16": "",
                 "48x48": "",
                 "32x32": ""
               },
           "emailAddress": "john_doe@example.com",
           "key": "user1",
           "active": true,
           "timeZone": "Asia/Jerusalem",
           "accountId": "0"
          },
    "timeoriginalestimate": null,
    "aggregatetimeoriginalestimate": null,
    "created": "2018-06-19T15:23:13.701+0300",
    "versions": [],
    "resolutiondate": "2018-09-18T10:02:06.340+0300",
    "summary": "Sample issue",
    "project":
          {
             "name": "Project 1",
             "self": "",
             "projectTypeKey": "software",
             "avatarUrls":
                 {
                   "24x24": "",
                   "16x16": "",
                   "48x48": "",
                   "32x32": ""
                  },
             "key": "PR",
             "id": "0"
           },
    "timetracking": {},
    "components": [],
    "issuetype":
          {
             "name": "Task",
             "self": "",
             "iconUrl": "",
             "subtask": false,
             "avatarId": 10318,
             "id": "10002",
             "description": "A task that needs to be done."
           },
    "security": null,
    "resolution":
           {
             "id": "10000",
             "self": "",
             "description": "Work has been completed on this issue.",
              "name": "Done"
             },
    "timeestimate": null
}

첨부파일 업로드

설명

문제에 첨부파일을 추가합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
문제 키	문자열	해당 사항 없음	예	파일 경로
File Paths	문자열	해당 사항 없음	예	업로드할 파일의 경로를 쉼표로 구분합니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

N/A

링크 문제

설명

Jira에서 여러 문제를 연결합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
Inward Issue ID(인바운드 문제 ID)	문자열	해당 사항 없음	예	인바운드 문제 ID의 쉼표로 구분된 목록을 지정합니다. 예를 들어 관계 유형이 '차단'인 경우 UI에 '차단됨' 관계가 있는 문제가 표시됩니다.
Outward Issue IDs(아웃워드 문제 ID)	CSV	해당 사항 없음	예	아웃워드 문제 ID를 지정합니다. 예를 들어 관계 유형이 '차단'인 경우 UI에 '차단' 관계가 있는 문제가 표시됩니다.
관계 유형	문자열	블록	예	여러 문제를 연결하는 데 사용할 관계 유형을 지정합니다. 사용 가능한 모든 관계 유형 목록은 '관계 유형 목록' 작업에서 확인할 수 있습니다.

유형

기본값

필수 항목

설명

Inward Issue ID(인바운드 문제 ID)

문자열

해당 사항 없음

예

인바운드 문제 ID의 쉼표로 구분된 목록을 지정합니다.

예를 들어 관계 유형이 '차단'인 경우 UI에 '차단됨' 관계가 있는 문제가 표시됩니다.

Outward Issue IDs(아웃워드 문제 ID)

CSV

해당 사항 없음

예

아웃워드 문제 ID를 지정합니다.

예를 들어 관계 유형이 '차단'인 경우 UI에 '차단' 관계가 있는 문제가 표시됩니다.

관계 유형

문자열

블록

예

여러 문제를 연결하는 데 사용할 관계 유형을 지정합니다. 사용 가능한 모든 관계 유형 목록은 '관계 유형 목록' 작업에서 확인할 수 있습니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

N/A

케이스 월

결과 유형	값 / 설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 일부 문제에 대해 201 상태 코드가 보고된 경우 (is_success = true): 'Jira에서 '{source issue}' 문제를 다음 문제와 연결했습니다: {destination issues}' 한 문제에 대해 404 상태 코드와 '문제가 존재하지 않음' 오류가 보고된 경우 (is_success=true): '작업이 Jira에서 다음 대상 문제를 찾을 수 없습니다: {jira issues that were not found}'. 모든 문제에 대해 404 상태 코드와 '문제가 존재하지 않음' 오류가 보고된 경우 (is_success=false): 'Jira에서 대상 문제를 찾을 수 없습니다.' 작업이 실패하고 플레이북 실행을 중지합니다. 잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: '작업 실행 중에 오류가 발생했습니다.' 이유: {0}'.format(error.Stacktrace) 소스 문제를 찾을 수 없는 경우: "작업을 실행하는 동안 오류가 발생했습니다." 이유: Jira에서 소스 문제 '{source issue}'를 찾을 수 없습니다. 맞춤법을 확인하세요'. 404 상태 코드이고 하나 이상의 '문제가 존재하지 않음' 오류가 아닌 경우: '작업 실행 중 오류가 발생했습니다.' 이유: {오류 메시지}	일반

결과 유형

값 / 설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

일부 문제에 대해 201 상태 코드가 보고된 경우 (is_success = true): 'Jira에서 '{source issue}' 문제를 다음 문제와 연결했습니다: {destination issues}'

한 문제에 대해 404 상태 코드와 '문제가 존재하지 않음' 오류가 보고된 경우 (is_success=true): '작업이 Jira에서 다음 대상 문제를 찾을 수 없습니다: {jira issues that were not found}'.

모든 문제에 대해 404 상태 코드와 '문제가 존재하지 않음' 오류가 보고된 경우 (is_success=false): 'Jira에서 대상 문제를 찾을 수 없습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: '작업 실행 중에 오류가 발생했습니다.' 이유: {0}'.format(error.Stacktrace)

소스 문제를 찾을 수 없는 경우: "작업을 실행하는 동안 오류가 발생했습니다." 이유: Jira에서 소스 문제 '{source issue}'를 찾을 수 없습니다. 맞춤법을 확인하세요'.

404 상태 코드이고 하나 이상의 '문제가 존재하지 않음' 오류가 아닌 경우: '작업 실행 중 오류가 발생했습니다.' 이유: {오류 메시지}

일반

관계 유형 나열

설명

Jira에서 사용 가능한 관계 유형을 나열합니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
필터 키	DDL	다음 중 하나를 선택하세요. 가능한 값은 다음과 같습니다. 이름 안쪽 Outward	아니요	{항목 유형}을 필터링하는 데 사용할 키를 지정하세요.
필터 로직	DDL	지정되지 않음 가능한 값은 다음과 같습니다. 지정되지 않음 같음 포함	아니요	적용할 필터 로직을 지정합니다. 필터링 로직은 '필터 키' 매개변수에 제공된 값을 기반으로 작동합니다.
필터 값	문자열	해당 사항 없음	아니요	필터에 사용할 값을 지정합니다. '같음'을 선택하면 작업에서 결과 중 정확한 일치 항목을 찾으려고 시도합니다. '포함'을 선택하면 지정된 하위 문자열이 포함된 결과를 찾으려고 시도합니다. 이 매개변수에 아무것도 제공되지 않으면 필터가 적용되지 않습니다. 필터링 로직은 '필터 키' 매개변수에 제공된 값을 기반으로 작동합니다.
반환할 최대 레코드 수	정수	50	아니요	반환할 레코드 수를 지정합니다. 아무것도 제공되지 않으면 작업에서 50개의 레코드를 반환합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

[{
    "id": "10000",
    "name": "Blocks",
    "inward": "is blocked by",
    "outward": "blocks",
    "self": "http://172.30.201.69:8080/rest/api/2/issueLinkType/10000"
}]

케이스 월

결과 유형	값 / 설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 데이터를 사용할 수 있는 경우 (is_success = true): 'Jira에서 제공된 기준에 대한 관계 유형을 찾았습니다.' 데이터를 사용할 수 없는 경우 (is_success=false): 'Jira에서 제공된 기준에 대한 관계 유형을 찾을 수 없습니다.' '필터 값' 매개변수가 비어 있는 경우 (is_success=true): '필터가 적용되지 않았습니다. '필터 값' 매개변수가 비어 있습니다.' 작업이 실패하고 플레이북 실행을 중지합니다. '필터 키' 매개변수가 '하나' 선택'으로 설정되고 '필터 논리'가 '같음' 또는 '포함'으로 설정된 경우: '{작업 이름}' 작업을 실행하는 동안 오류가 발생했습니다. 이유: '필터 키' 매개변수에서 필드를 선택해야 합니다.' 반환할 최대 레코드에 잘못된 값이 제공된 경우: '{작업 이름}' 작업을 실행하는 중에 오류가 발생했습니다. 이유: '반환할 최대 레코드'에 잘못된 값이 제공되었습니다. 양수를 입력해야 합니다.' 잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''{작업 이름} 작업 실행 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)	일반
케이스 월 테이블	표 이름: 사용 가능한 관계 테이블 열: 이름 - 이름 안쪽 - 안쪽 Outward - outward	일반

결과 유형

값 / 설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

데이터를 사용할 수 있는 경우 (is_success = true): 'Jira에서 제공된 기준에 대한 관계 유형을 찾았습니다.'

데이터를 사용할 수 없는 경우 (is_success=false): 'Jira에서 제공된 기준에 대한 관계 유형을 찾을 수 없습니다.'

'필터 값' 매개변수가 비어 있는 경우 (is_success=true): '필터가 적용되지 않았습니다. '필터 값' 매개변수가 비어 있습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

'필터 키' 매개변수가 '하나' 선택'으로 설정되고 '필터 논리'가 '같음' 또는 '포함'으로 설정된 경우: '{작업 이름}' 작업을 실행하는 동안 오류가 발생했습니다. 이유: '필터 키' 매개변수에서 필드를 선택해야 합니다.'

반환할 최대 레코드에 잘못된 값이 제공된 경우: '{작업 이름}' 작업을 실행하는 중에 오류가 발생했습니다. 이유: '반환할 최대 레코드'에 잘못된 값이 제공되었습니다. 양수를 입력해야 합니다.'

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''{작업 이름} 작업 실행 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

일반

케이스 월 테이블

표 이름: 사용 가능한 관계

테이블 열:

이름 - 이름
안쪽 - 안쪽
Outward - outward

일반

사용자 검색

Jira에서 사용자를 검색합니다.

항목

이 작업은 항목에서 실행되지 않습니다.

작업 입력

작업을 구성하려면 다음 매개변수를 사용하세요.

매개변수
`User Email Addresses`	선택사항 사용자를 반환할 이메일 주소가 쉼표로 구분된 목록입니다.
`User Names`	선택사항 사용자를 반환할 사용자 이름이 쉼표로 구분된 목록입니다.
`Project`	선택사항 이메일 주소를 검색할 프로젝트의 이름입니다. 제공된 경우 `Project Assignable Users`만 반환됩니다.

작업 출력

작업 출력 유형
케이스 월 연결	해당 사항 없음
케이스 월 링크	해당 사항 없음
케이스 월 테이블	해당 사항 없음
보강 테이블	해당 사항 없음
JSON 결과	사용 가능
스크립트 결과	사용 가능

스크립트 결과

스크립트 결과 이름	값
is_success	True/False

JSON 결과

[
 {
   "Entity": "example",
   "EntityResult": {
     "_resource": "user?accountId={0}",
     "_options": {
       "server": "https://siemplify.atlassian.net",
       "auth_url": "/rest/auth/1/session",
       "context_path": "/",
       "rest_path": "api",
       "rest_api_version": "2",
       "agile_rest_path": "agile",
       "agile_rest_api_version": "1.0",
       "verify": false,
       "resilient": true,
       "async": false,
       "async_workers": 5,
       "client_cert": null,
       "check_update": false,
       "delay_reload": 0,
       "headers": {
         "Cache-Control": "no-cache",
         "Content-Type": "application/json",
         "X-Atlassian-Token": "no-check"
       }
     },
     "_session": "<jira.resilientsession.ResilientSession object>",
     "_base_url": "{server}/rest/{rest_path}/{rest_api_version}/{path}",
     "raw": {
       "self": "https://siemplify.atlassian.net/rest/api/2/user?accountId=example-account-id",
       "accountId": "example-account-id",
       "accountType": "atlassian",
       "emailAddress": "example.user",
       "avatarUrls": {
         "48x48": "https://example.com"
       },
       "displayName": "Example",
       "active": true,
       "timeZone": "UTC",
       "locale": "en_US"
     },
     "self": "https://siemplify.atlassian.net/rest/api/2/user?accountId=example-account-id",
     "accountId": "example-account-id",
     "accountType": "atlassian",
     "emailAddress": "example.user",
     "avatarUrls": "<jira.resources.PropertyHolder object>",
     "displayName": "Example",
     "active": true,
     "timeZone": "UTC",
     "locale": "en_US"
   }
 }
]

케이스 월

이 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명

출력 메시지	메시지 설명
`Successfully found the following users in Jira for project PROJECT_NAME: USER_LIST` `The following users were not found in Jira for project PROJECT_NAME: USER_LIST` `None of the provided users were found in the project PROJECT_NAME`	작업이 완료되었습니다.
`Error executing action "Search Users". Reason: ERROR_REASON`	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

Successfully found the following users in Jira for project PROJECT_NAME: USER_LIST

The following users were not found in Jira for project PROJECT_NAME: USER_LIST

None of the provided users were found in the project PROJECT_NAME

작업이 완료되었습니다.

Error executing action "Search Users".
      Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

커넥터

Jira 커넥터

설명

Jira에서 Google SecOps로 문제를 가져옵니다.

Google SecOps에서 Jira 커넥터 구성

Google SecOps에서 커넥터를 구성하는 방법에 대한 자세한 내용은 커넥터 구성을 참고하세요.

커넥터 매개변수

다음 매개변수를 사용하여 커넥터를 구성합니다.

매개변수	유형	기본값	필수 항목	설명
DeviceProductField	문자열	device_product	예	기기 제품을 확인하는 데 사용되는 필드 이름입니다.
EventClassId	문자열	name	아니요	이벤트 이름(하위 유형)을 결정하는 데 사용되는 필드 이름입니다.
PythonProcessTimeout	문자열	60	예	현재 스크립트를 실행하는 Python 프로세스의 제한 시간 한도(초)입니다.
API 루트	문자열	https://{jira_address}	예	Jira 인스턴스의 API 루트입니다.
사용자 이름	문자열	해당 사항 없음	예	해당 사항 없음
API 토큰	비밀번호	해당 사항 없음	예	Jira 콘솔에서 생성된 토큰입니다. 참고: 이 매개변수는 사용자 이름과 비밀번호 조합을 사용하는 온프레미스 인증의 경우 'Password' 문자열을 포함하는 데 사용할 수 있습니다.
일 전	정수	5	아니요	알림을 가져올 이전 최대 일수입니다.
주기당 최대 티켓 수	정수	10	아니요	한 커넥터 주기에서 가져와 처리할 최대 티켓 수입니다.
프로젝트 이름	문자열	해당 사항 없음	아니요	쉼표로 구분된 프로젝트 이름입니다.
문제 상태	문자열	해당 사항 없음	아니요	쉼표로 구분된 문제의 상태입니다.
할당된 사용자	문자열	해당 사항 없음	아니요	사용자 전체 이름(쉼표로 구분)입니다.
문제 유형	문자열	해당 사항 없음	아니요	쉼표로 구분된 문제 유형입니다.
문제 우선순위	문자열	해당 사항 없음	아니요	쉼표로 구분된 문제 우선순위입니다.
문제 구성요소	문자열	해당 사항 없음	아니요	쉼표로 구분된 문제 구성요소
프록시 서버 주소	문자열	해당 사항 없음	아니요	사용할 프록시 서버의 주소입니다.
프록시 사용자 이름	문자열	해당 사항 없음	아니요	인증할 프록시 사용자 이름입니다.
프록시 비밀번호	비밀번호	해당 사항 없음	아니요	인증할 프록시 비밀번호입니다.
환경 필드 이름	문자열	""	아니요	환경 이름이 저장된 필드의 이름을 설명합니다. 환경 필드를 찾을 수 없으면 환경이 기본 환경입니다.
환경 정규식 패턴	문자열	.*	아니요	'환경 필드 이름' 필드에 있는 값에서 실행할 정규식 패턴입니다. 기본값은 .*로서 모두 포착하고 변경되지 않은 값을 반환합니다. 사용자가 정규식 로직을 통해 환경 필드를 조작할 수 있도록 허용하는 데 사용됩니다. 정규식 패턴이 null이거나 비어 있거나 환경 값이 null인 경우 최종 환경 결과는 기본 환경입니다.

커넥터 규칙

프록시 지원

커넥터가 프록시를 지원합니다.

동적 목록 및 차단 목록

커넥터는 Jira 내부의 특정 라벨에 대해서만 동적 목록 및 차단 목록 규칙을 지원합니다.

작업

동기화 종료 작업

설명

해당 Google SecOps 알림이 종료된 경우 Jira에서 티켓을 종료합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
API 루트	문자열	https://{jira_address}	예	Jira 인스턴스 API 루트 URL입니다.
사용자 이름	문자열	해당 사항 없음	예	Jira 인스턴스에 연결할 사용자 이름입니다.
API 토큰	비밀번호	해당 사항 없음	예	Jira 콘솔에서 생성된 토큰입니다. 참고: 이 매개변수는 사용자 이름과 비밀번호 조합을 사용하는 온프레미스 인증의 경우 'Password' 문자열을 포함하는 데 사용할 수 있습니다.
프로젝트 이름	문자열	쉼표로 구분된 프로젝트 이름	예	작업에서 모니터링해야 하는 Jira 프로젝트 이름(쉼표로 구분)입니다.
최대 이전 일수	정수	1	예	티켓 상태를 뒤로 동기화할 최대 일수입니다.

동기화 댓글 작업

설명

Google SecOps 케이스와 해당 Jira 티켓 간에 댓글을 동기화합니다. 동기화는 양방향입니다. 즉, Google SecOps에서 Jira로, Jira에서 Google SecOps로 동기화됩니다.

이 작업은 Jira 태그가 있는 Google SecOps 케이스만 지원합니다.

작업에서 댓글을 만들 때 접두사를 적용합니다. Google SecOps 사용자가 Google SecOps 케이스에 댓글을 달면 작업에서 Chronicle 댓글 접두사 매개변수를 사용하여 해당 Jira 티켓에 사용자 댓글을 만들고 동기화합니다.

이 기능은 다음 두 가지 목적으로 추가되었습니다.

가시성.
작업에서 추가한 댓글이 다른 쪽에 다시 동기화되어 루프가 발생하는 것을 방지합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
API 루트	문자열	https://{jira_address}	예	Jira 인스턴스 API 루트 URL입니다.
사용자 이름	문자열	해당 사항 없음	예	Jira 인스턴스에 연결할 사용자 이름입니다.
API 토큰	비밀번호	해당 사항 없음	예	Jira 콘솔에서 생성된 토큰입니다. 참고: 이 매개변수는 사용자 이름과 비밀번호 조합을 사용하는 온프레미스 인증의 경우 'Password' 문자열을 포함하는 데 사용할 수 있습니다.
프로젝트 이름	문자열	쉼표로 구분된 프로젝트 이름	예	작업에서 모니터링해야 하는 Jira 프로젝트 이름(쉼표로 구분)입니다.
최대 이전 일수	정수	1	예	티켓 상태를 뒤로 동기화할 최대 일수입니다.
Google SecOps 댓글 접두사	문자열	Google SecOps:	예	동기화 작업에서 Jira 티켓에 대해 생성된 댓글에 추가하는 접두사입니다.
Jira 댓글 접두사	문자열	Jira 댓글 동기화 작업:	예	동기화 작업에서 Google SecOps 알림 케이스 댓글에 추가하는 접두사입니다.

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.