ServiceNow를 Google SecOps와 통합

이 문서에서는 ServiceNow를 Google Security Operations (Google SecOps)와 통합하는 방법을 설명합니다.

사용 사례

ServiceNow 통합은 Google SecOps 기능을 사용하여 다음 사용 사례를 지원합니다.

  • 자동화된 사고 티켓팅: SIEM 또는 기타 보안 도구에서 발생하는 보안 알림에서 ServiceNow 사고를 자동으로 만듭니다.

  • 사고 보강 및 대응: 수동 티켓팅을 줄이고 원래 알림의 관련 정보로 사고를 보강하여 사고 대응 워크플로를 간소화합니다.

  • 피싱 해결: 이메일 헤더 수집, 첨부파일 조사, 유사한 이메일 검색과 같은 반복적인 피싱 조사 단계를 자동화하여 대응 시간을 단축합니다.

  • 취약점 해결 조정: 취약점 스캔 결과를 기반으로 패치 또는 완화 조치를 위한 ServiceNow 변경 요청을 자동으로 만들어 취약점 해결 워크플로를 조정합니다.

  • 사용자 수명 주기 자동화: ServiceNow 워크플로의 트리거를 기반으로 다양한 시스템 (액세스 제어, 이메일 플랫폼, 애플리케이션)에서 사용자 프로비저닝 및 프로비저닝 해제 작업을 자동화합니다.

  • 위협 인텔리전스 컨텍스트: ServiceNow 플랫폼에서 직접 가져온 위협 인텔리전스 데이터로 보안 알림을 보강하여 분석가가 대응 조치의 우선순위를 정할 수 있는 더 많은 컨텍스트를 제공합니다.

시작하기 전에

Google SecOps 플랫폼에서 통합을 구성하기 전에 다음 기본 요건을 완료해야 합니다.

  • ServiceNow 사용자 계정: 대상 레코드를 쿼리, 생성, 업데이트할 수 있는 충분한 권한이 있는 전용 사용자 계정입니다.
  • ServiceNow 역할: 계정에 필요한 시스템 역할(sn_incident_write 및 itil)과 저널 댓글을 읽을 수 있는 커스텀 사용자 액세스 구성이 있는지 확인합니다.
  • 네트워크 연결: Google SecOps IP 주소 또는 원격 에이전트 인프라의 트래픽이 ServiceNow 인스턴스 엔드포인트에 도달할 수 있도록 하는 네트워크 구성입니다.
  • 인증 세부정보: 조직의 인증 정책을 결정합니다. 표준 기본 인증 또는 OAuth 2.0 인증을 사용하여 인증할 수 있습니다.

ServiceNow에서 사용자 액세스 구성하기

통합에서 의견을 동기화하고, 필드를 업데이트하고, 작업을 원활하게 실행할 수 있도록 하려면 ServiceNow 플랫폼에서 다음 관리 작업을 수행해야 합니다.

ServiceNow 인터페이스를 탐색하는 방법에 대한 구체적인 안내는 공식 ServiceNow 제품 문서를 참조하세요.

  1. 커스텀 역할 만들기: 역할 > 새로 만들기로 이동하여 API 댓글 액세스 권한을 처리하는 전용 새 역할을 만듭니다.
  2. 새 액세스 제어 목록 (ACL) 규칙 만들기: 통합을 위해서는 댓글 및 작업 메모를 추적하기 위해 sys_journal_field 테이블에 대한 읽기 액세스 권한이 필요합니다. 액세스 제어 > 새로 만들기로 이동합니다. 이 규칙을 만들려면 승격된 권한이 있는 계정으로 로그인해야 합니다.

  3. ACL 매개변수 구성:

    • 유형을 record로 설정합니다.
    • 작업을 read로 설정합니다.
    • Name(이름) 필드의 첫 번째 드롭다운에서 Journal Entry sys_journal_field(분개장 항목)를 선택하고 두 번째 드롭다운에서 -- None --(없음)을 선택합니다.
    • 양식 하단의 역할 필요 목록으로 이동하여 새로 만든 커스텀 주석 역할을 추가합니다. 제출을 클릭합니다.

  4. 통합 계정에 역할 할당: 사용자로 이동하여 전용 통합 계정을 열고 다음 역할을 부여합니다.

    • 댓글을 읽기 위해 만든 커스텀 역할입니다.
    • sn_incident_write: 사고 가져오기 및 사고 업데이트 작업과 같은 기본 상호작용에 필요합니다.
    • itil: CMDB 작업 및 관련 애셋 구성 관리 조회 기능에 필요합니다.

인증 구성 옵션

ServiceNow 통합은 세 가지 인증 방법을 지원합니다. 조직의 보안 요구사항에 맞는 다음 구성 옵션 중 하나를 선택합니다.

옵션 1: OAuth 2.0 클라이언트 사용자 인증 정보 흐름 (권장)

이 방법은 OAuth 2.0 클라이언트 사용자 인증 정보 부여와 사용자 가장을 함께 사용하여 플랫폼에 정적 사용자 비밀번호를 노출하지 않고 데이터 액세스를 안전하게 제한합니다.

1단계: ServiceNow에서 OAuth 엔드포인트 만들기

  1. ServiceNow 탐색 메뉴에서 애플리케이션 레지스트리를 검색하고 새로 만들기를 클릭합니다.
  2. 새로운 인바운드 통합 환경을 선택합니다.
  3. 연결 유형 목록에서 OAuth - 클라이언트 사용자 인증 정보 부여를 선택합니다.
  4. 이름 필드에 엔드포인트 구성에 대한 설명이 포함된 이름을 입력합니다.
  5. ID 프로필 컨텍스트를 설정하는 데 필요한 OAuth 제공업체 이름 또는 식별자를 제공합니다.
  6. OAuth 애플리케이션 사용자 필드에서 가장되고 모든 자동화된 API 활동에 사용될 전용 ServiceNow 사용자 계정을 선택합니다.
  7. 제출 또는 저장을 클릭합니다.
  8. 새로 만든 레지스트리 레코드를 다시 열어 생성된 클라이언트 ID와 클라이언트 보안 비밀번호를 복사하고 보호합니다.

2단계: Google SecOps 내부 구성

  1. Google SecOps에서 응답 > 통합 설정으로 이동하여 ServiceNow 구성 창을 엽니다.
  2. API 루트를 입력합니다(기본 자리표시자 도메인을 실제 ServiceNow 인스턴스 URL로 대체).
  3. 1단계에서 생성된 클라이언트 ID와 클라이언트 보안 비밀번호를 제공합니다.
  4. 사용자 이름, 비밀번호, 갱신 토큰 필드가 완전히 비어 있는지 확인합니다.
  5. OAuth 인증 사용 체크박스 설정을 사용 설정합니다.
  6. 테스트를 클릭하여 연결 핑 테스트를 통해 매개변수를 검증합니다. 성공하면 저장을 클릭합니다.

옵션 2: 기본 인증

이 방법은 직접 사용자 인증 정보 검증을 사용합니다. 설정은 간단하지만 기업에서 다중 인증(MFA)을 적용하거나 기본 인증 헤더를 차단하는 경우 제한될 수 있습니다.

  1. ServiceNow에서 통합 사용자에게 로컬 사용자 이름 및 비밀번호가 있는지 확인합니다.
  2. Google SecOps에서 통합을 구성할 때 API 루트 (기본 자리표시자 도메인을 실제 ServiceNow 인스턴스 URL로 대체), 사용자 이름, 비밀번호를 제공합니다.
  3. OAuth 관련 필드를 비워두고 Use Oauth Authentication가 사용 중지되어 있는지 확인합니다 (체크박스 선택 해제).
  4. 테스트를 클릭하여 연결 매개변수를 검증합니다. 성공하면 저장을 클릭합니다.

옵션 3: 갱신 토큰 흐름

조직에서 갱신 토큰 체인을 사용하여 백그라운드에서 프로그래매틱 방식으로 액세스 토큰을 가져오는 OAuth 보안 제어가 필요한 경우 이 방법을 사용합니다.

  1. ServiceNow 인스턴스에서 1단계를 완료하여 클라이언트 ID 및 클라이언트 보안 비밀번호를 생성합니다.
  2. 갱신 토큰 생성 섹션의 단계를 완료하여 유효한 승인 토큰 문자열을 가져옵니다.
  3. Google SecOps에서 ServiceNow 통합 인스턴스 구성 창을 엽니다.
  4. 구성된 사용자 인증 정보를 사용하여 매개변수를 완전히 채웁니다.
    • API 루트 (기본 플레이스홀더 도메인을 실제 ServiceNow 인스턴스 URL로 대체)
    • 사용자 이름
    • 비밀번호
    • 클라이언트 ID
    • 클라이언트 보안 비밀번호
  5. OAuth 인증 사용 체크박스를 선택합니다.
  6. 갱신 토큰 생성 섹션 워크플로에서 가져온 토큰 문자열을 갱신 토큰 필드에 붙여넣습니다.
  7. 테스트를 클릭하여 연결 매개변수를 검증합니다. 성공하면 저장을 클릭합니다.

갱신 토큰 생성 (Google SecOps)

갱신 토큰을 생성하려면 도우미 작업을 실행하도록 통합을 일시적으로 구성해야 합니다.

  1. Google SecOps에서 응답 > 통합 설정으로 이동합니다.
  2. 이 초기 설정 단계에서는 OAuth 인증 사용 체크박스가 선택되지 않은 상태로 유지해야 합니다.
  3. API 루트, 사용자 이름, 비밀번호, 클라이언트 ID, 클라이언트 보안 비밀번호를 사용하여 임시 ServiceNow 통합 인스턴스를 구성하고 저장을 클릭합니다.
  4. 케이스를 시뮬레이션하거나 기존 케이스를 엽니다.
  5. 케이스에서 ServiceNow OAuth 토큰 가져오기 작업을 수동으로 실행합니다.
  6. 최종 통합 인스턴스를 구성할 때 갱신 토큰 필드에 사용할 작업의 JSON 결과에서 refresh_token 값을 복사합니다.

통합 매개변수

ServiceNow 통합에는 다음 매개변수가 필요합니다.

매개변수 설명
Api Root

필수 입력란입니다.

ServiceNow 인스턴스의 API 루트입니다.

기본값은 https://INSTANCE.service-now.com/api/now/v1/입니다.
Username

필수 입력란입니다.

ServiceNow 계정의 사용자 이름입니다.
Password

필수 입력란입니다.

ServiceNow 계정의 비밀번호입니다.
Incident Table

(선택사항)

사고 관련 작업 및 레코드 검색에 사용할 API 테이블 이름 또는 경로입니다.

기본적으로 통합은 table/incident 경로를 사용합니다.
Verify SSL

(선택사항)

선택하면 통합에서 ServiceNow 서버에 연결할 때 SSL 인증서를 검증합니다.

기본적으로 사용 설정됩니다.
Client ID

(선택사항)

ServiceNow 통합의 클라이언트 ID로, 클라이언트 사용자 인증 정보를 사용하는 OAuth 2.0 인증에 필요합니다.

갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Client Secret

(선택사항)

클라이언트 사용자 인증 정보를 사용하는 OAuth 2.0 인증에 필요한 ServiceNow 통합의 클라이언트 보안 비밀번호입니다.

갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Refresh Token

(선택사항)

갱신 토큰을 사용하는 OAuth 2.0 인증에 필요한 ServiceNow 통합의 갱신 토큰입니다.

이 구성된 갱신 토큰은 90일마다 만료됩니다.

갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Use Oauth Authentication

(선택사항)

선택하면 통합에서 OAuth 2.0을 사용하여 인증합니다.

OAuth 2.0 인증을 사용하려면 클라이언트 사용자 인증 정보(Client ID 및 Client Secret) 또는 Refresh Token를 설정해야 합니다.

기본적으로 사용 중지됩니다.

Google SecOps에서 통합을 구성하는 방법에 대한 안내는 통합 구성을 참조하세요.

필요한 경우 이후 단계에서 변경할 수 있습니다. 통합 인스턴스를 구성한 후 플레이북에서 사용할 수 있습니다. 여러 인스턴스를 구성하고 지원하는 방법에 관한 자세한 내용은 다중 인스턴스 지원을 참고하세요.

작업

작업에 대한 자세한 내용은 Workdesk의 대기 중인 작업에 응답 및 케이스에서 수동 작업 실행을 참고하세요.

첨부파일 추가

첨부파일 추가 작업을 사용하여 ServiceNow의 테이블 레코드에 첨부파일을 추가합니다.

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

작업 입력

첨부파일 추가 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

필수 입력란입니다.

첨부파일이 추가된 레코드가 포함된 테이블의 이름입니다.
Record Sys ID

필수 입력란입니다.

첨부파일이 추가되는 레코드의 시스템 ID (sys_id)입니다.
File Path

필수 입력란입니다.

첨부할 파일의 절대 경로를 쉼표로 구분한 목록입니다.
Mode

(선택사항)

같은 이름의 파일이 이미 기록에 있는 경우 작업의 동작입니다.

가능한 값은 다음과 같습니다.

  • Add New Attachment: 이 작업은 파일을 별도의 새 첨부파일로 추가합니다. 이름이 같은 파일이 허용됩니다.
  • Overwrite Existing Attachment: 이 작업은 동일한 이름을 공유하는 기존 연결을 대체합니다.

기본값은 Add New Attachment입니다.

작업 출력

첨부파일 추가 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 첨부파일 추가 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": {
        "size_bytes": "742",
        "file_name": "placeholder_document.txt",
        "sys_mod_count": "0",
        "average_image_color": "",
        "image_width": "",
        "sys_updated_on": "2025-01-01 10:00:00",
        "sys_tags": "",
        "table_name": "incident",
        "sys_id": "TEST_SYS_ID_ATTACH_123456789",
        "image_height": "",
        "sys_updated_by": "admin",
        "download_link": "https://placeholder.service-now.com/api/now/attachment/TEST_SYS_ID_ATTACH_123456789/file",
        "content_type": "multipart/form-data",
        "sys_created_on": "2025-01-01 10:00:00",
        "size_compressed": "438",
        "compressed": "true",
        "state": "pending",
        "table_sys_id": "TEST_SYS_ID_RECORD_ABCDEFG",
        "chunk_size_bytes": "700000",
        "hash": "test_hash_0000000000000000000000000000000000000000000000000000000000000000",
        "sys_created_by": "admin"
    }
}
출력 메시지

첨부파일 추가 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully added the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

Action wasn't able to add the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

No attachments were added to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

 작업이 완료되었습니다.
Error executing action "Add Attachment". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 첨부파일 추가 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

의견 추가

댓글 추가 작업을 사용하여 ServiceNow 이슈에 댓글을 추가합니다.

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

작업 입력

댓글 추가 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Incident Number

필수 입력란입니다.

댓글을 추가할 이슈 번호입니다(INCINCIDENT_NUMBER 형식).
Comment

필수 입력란입니다.

이슈에 추가할 댓글입니다.

작업 출력

댓글 추가 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
스크립트 결과

다음 표에는 댓글 추가 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

댓글 추가 및 답장 대기

댓글 추가 및 답장 대기 작업을 사용하여 ServiceNow 이슈에 댓글을 추가한 다음 해당 이슈에 새 댓글이나 답장이 추가될 때까지 플레이북 실행을 일시중지합니다. 작업의 출력은 새 댓글의 콘텐츠입니다.

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

작업 입력

댓글 추가 및 답장 대기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Incident Number

필수 입력란입니다.

댓글을 추가할 이슈 번호입니다(INCINCIDENT_NUMBER 형식).
Comment

필수 입력란입니다.

이슈에 추가할 댓글입니다.

작업 출력

댓글 추가 및 답장 대기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
스크립트 결과

다음 표에는 댓글 추가 및 답장 대기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
new_comment

기록에 댓글 추가

레코드에 댓글 추가 작업을 사용하여 ServiceNow의 특정 테이블 레코드에 댓글이나 작업 메모를 추가합니다.

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

작업 입력

Add Comment To Record 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

필수 입력란입니다.

댓글 또는 메모를 추가할 테이블의 이름입니다.
Type

필수 입력란입니다.

추가할 댓글 또는 메모의 유형입니다.

가능한 값은 다음과 같습니다.

  • Comment
  • Work Note

기본값은 Comment입니다.
Record Sys ID

필수 입력란입니다.

댓글 또는 작업 메모를 추가할 시스템 ID (sys_id)입니다.
Text

필수 입력란입니다.

댓글 또는 작업 메모의 내용입니다.
Wait For Reply

(선택사항)

선택하면 작업이 비동기식으로 실행되고 새 댓글 또는 작업 메모가 레코드에 추가될 때까지 실행이 일시중지됩니다.

이 작업은 댓글을 추가하면 댓글을 추적하고 작업 메모를 추가하면 작업 메모를 추적합니다.

기본적으로 사용 중지됩니다.

작업 출력

레코드에 댓글 추가 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시에서는 레코드에 댓글 추가 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_id": "4355183607523010ff23f6fd7c1ed0a8",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "Test comment content.",
    "sys_created_by": "admin",
    "element": "comments"
}
출력 메시지

Add Comment To Record 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명
Successfully added COMMENT_OR_NOTE " CONTENT" to TABLE_NAME with Sys_ID SYS_ID in ServiceNow. 작업이 완료되었습니다.
Error executing action "Add Comment To Record". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 레코드에 댓글 추가 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

상위 사고 추가

상위 사고 추가 작업을 사용하여 ServiceNow에서 사고의 상위 사고를 추가합니다.

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

작업 입력

상위 이슈 추가 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Parent Incident Number

필수 입력란입니다.

상위 이슈 번호입니다(INCINCIDENT_NUMBER 형식, 예: INC0000051).

이 작업은 Child Incident Numbers의 모든 사고를 상위 사고의 하위 요소로 추가합니다.
Child Incident Numbers

필수 입력란입니다.

지정된 상위 이슈의 하위 이슈로 설정할 이슈 번호의 쉼표로 구분된 목록입니다. 형식은 INCINCIDENT_NUMBER입니다(예: INC0000051).

작업 출력

상위 이슈 추가 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 상위 사고 추가 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
출력 메시지

상위 이슈 추가 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명
Successfully set PARENT_INCIDENT_NUMBER as the "Parent Incident" for the following incidents in ServiceNow: CHILD_INCIDENT_NUMBERS. 작업이 완료되었습니다.
Error executing action "Add Parent Incident". Reason: ERROR_REASON

작업이 실패했습니다.

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

사고 종료

사고 종료 작업을 사용하여 ServiceNow 사고를 종료합니다.

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

작업 입력

사고 종료 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Incident Number

필수 입력란입니다.

종료할 사고의 번호입니다(INCINCIDENT_NUMBER 형식).
Close Reason

필수 입력란입니다.

사고를 종료하는 이유입니다.
Resolution Code

필수 입력란입니다.

사고의 해결 코드입니다.

가능한 값은 다음과 같습니다.

  • Duplicate
  • Known error
  • No resolution provided
  • Resolved by caller
  • Resolved by change
  • Resolved by problem
  • Resolved by request
  • Solution provided
  • Workaround provided
  • User error

기본값은 Solution provided입니다.
Close Notes

필수 입력란입니다.

사고에 대한 종료 메모입니다.

작업 출력

사고 종료 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
스크립트 결과

다음 표에는 사고 종료 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

알림 사고 만들기

알림 사고 만들기 작업을 사용하여 플레이북 실행을 시작하는 알림의 세부정보를 기반으로 ServiceNow에서 새 사고를 만듭니다.

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

작업 입력

알림 사고 만들기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Impact

필수 입력란입니다.

사고의 영향 수준입니다.

가능한 값은 다음과 같습니다.

  • 높은 경우 1
  • 2(Medium)
  • 3(낮음)

기본값은 1입니다.
Urgency

필수 입력란입니다.

사고의 긴급도 수준입니다.

가능한 값은 다음과 같습니다.

  • 높은 경우 1
  • 2(Medium)
  • 3(낮음)

기본값은 1입니다.
Category

(선택사항)

사고 카테고리입니다.
Assignment Group ID

(선택사항)

사고를 할당할 그룹의 전체 이름입니다.
Assigned User ID

(선택사항)

사고를 할당할 사용자의 전체 이름입니다.
Description

(선택사항)

사고 설명입니다.

작업 출력

알림 사고 만들기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 알림 사고 만들기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
스크립트 결과

다음 표에는 알림 사고 만들기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

사고 만들기

사고 만들기 작업을 사용하여 ServiceNow에서 새 사고를 만듭니다.

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

작업 입력

사고 만들기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Short Description

필수 입력란입니다.

사고에 대한 간단한 설명입니다.
Impact

필수 입력란입니다.

사고의 영향 수준입니다.

가능한 값은 다음과 같습니다.

  • 높은 경우 1
  • 2(Medium)
  • 3(낮음)

기본값은 1입니다.
Urgency

필수 입력란입니다.

사고의 긴급도 수준입니다.

가능한 값은 다음과 같습니다.

  • 높은 경우 1
  • 2(Medium)
  • 3(낮음)

기본값은 1입니다.
Category

(선택사항)

사고 카테고리입니다.
Assignment Group ID

(선택사항)

사고를 할당할 그룹의 전체 이름입니다.

Assigned User ID

(선택사항)

사고를 할당할 사용자의 전체 이름입니다.

Description

(선택사항)

사고 설명입니다.
Custom Fields

(선택사항)

업데이트할 필드 이름과 해당 값이 포함된 JSON 형식 문자열입니다 (예: {"location":"London", "category":"database"}).

이 매개변수를 사용하여 작업 입력으로 명시적으로 정의되지 않은 필드를 수정할 수 있습니다.

작업 출력

이슈 만들기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 사고 만들기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
스크립트 결과

다음 표에는 사고 만들기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
incident_number INCIDENT_NUMBER

Create Record

레코드 만들기 작업을 사용하여 다른 ServiceNow 테이블에 새 레코드를 만듭니다.

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

작업 입력

레코드 만들기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

(선택사항)

새 레코드가 생성되는 ServiceNow 테이블의 이름입니다 (예: incident).
Object Json Data

(선택사항)

새 레코드를 정의하는 데 필요한 필드-값 쌍 (예: 사고 필드 또는 CMDB 항목 속성)이 포함된 JSON 객체입니다.

작업 출력

레코드 만들기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시에서는 레코드 만들기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
스크립트 결과

다음 표에는 레코드 만들기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
object_sys_id OBJECT_SYS_ID

첨부파일 다운로드

첨부파일 다운로드 작업을 사용하여 특정 ServiceNow 레코드에 첨부된 파일과 문서를 Google SecOps 환경의 로컬 폴더에 다운로드합니다.

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

작업 입력

첨부파일 다운로드 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

필수 입력란입니다.

첨부파일을 다운로드할 레코드가 포함된 ServiceNow 테이블의 이름입니다 (예: incident).
Record Sys ID

필수 입력란입니다.

연결이 다운로드되는 레코드의 시스템 ID (sys_id)입니다.
Download Folder Path

필수 입력란입니다.

다운로드한 첨부파일이 저장되는 Google SecOps 환경의 폴더에 대한 절대 경로입니다.
Overewrite

(선택사항)

선택하면 작업에서 같은 이름의 파일을 덮어씁니다.

기본적으로 사용 중지됩니다.

작업 출력

첨부파일 다운로드 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 첨부파일 다운로드 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": [
        {"absolute_file_path" : ["PATH"]
            "size_bytes": "187",
            "file_name": "example.txt",
            "sys_mod_count": "1",
            "average_image_color": "",
            "image_width": "",
            "sys_updated_on": "2020-10-19 09:58:39",
            "sys_tags": "",
            "table_name": "problem",
            "sys_id": "SYS_ID",
            "image_height": "",
            "sys_updated_by": "system",
            "download_link": "https://example.service-now.com/api/now/attachment/ID/file",
            "content_type": "text/plain",
            "sys_created_on": "2020-10-19 09:58:38",
            "size_compressed": "172",
            "compressed": "true",
            "state": "available",
            "table_sys_id": "57771d002f002010c518532a2799b6cc",
            "chunk_size_bytes": "700000",
            "hash": "a4fbb8ab71268903845b59724835274ddc66e095de553c5e0c1da8fecd04ee45",
            "sys_created_by": "admin"
        }
    ]
}
출력 메시지

첨부파일 다운로드 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully downloaded the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

 작업이 완료되었습니다.
Error executing action "Download Attachments". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 첨부파일 다운로드 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

하위 사고 세부정보 가져오기

하위 이슈 세부정보 가져오기 작업을 사용하여 ServiceNow의 상위 이슈를 기반으로 하위 이슈에 대한 정보를 검색합니다.

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

작업 입력

하위 이슈 세부정보 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Parent Incident Number

필수 입력란입니다.

하위 사고 세부정보를 검색할 상위 사고의 번호입니다(INCINCIDENT_NUMBER 형식).
Max Child Incident To Return

(선택사항)

작업이 상위 이슈에서 반환하는 하위 이슈의 최대 개수입니다.

기본값은 50입니다.

작업 출력

하위 사고 세부정보 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 가능
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
케이스 월 테이블

하위 사고 세부정보 가져오기 작업은 다음 표를 제공합니다.

테이블 이름: 하위 사고 세부정보

표 열:

  • Sys ID(sys_id로 매핑됨)
  • 숫자(number로 매핑됨)
  • 간단한 설명(short_description로 매핑됨)
  • 생성일(sys_created_on로 매핑됨)
JSON 결과

다음 예시는 하위 사고 세부정보 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
출력 메시지

하위 이슈 세부정보 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully retrieved information about child incidents related to the PARENT_INCIDENT_NUMBER incident in ServiceNow.

Action wasn't able to retrieve information about the child incidents in ServiceNow. Reason: incident PARENT_INCIDENT_NUMBER was not found.

No child incidents were found.

 작업이 완료되었습니다.
Error executing action "Get Child Incident Details". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 하위 사고 세부정보 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

CMDB 레코드 세부정보 가져오기

CMDB 레코드 세부정보 가져오기 작업을 사용하여 ServiceNow의 동일한 클래스에서 자세한 CMDB 레코드를 가져옵니다.

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

작업 입력

CMDB 레코드 세부정보 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Class Name

필수 입력란입니다.

레코드를 검색할 CMDB 클래스의 이름입니다(예: cmdb_ci_appl).

클래스 이름에 관한 자세한 내용은 클래스 정의 및 메타데이터 보기 및 수정을 참고하세요.
Sys ID

필수 입력란입니다.

세부정보를 가져올 CMDB 레코드의 시스템 ID (sys_id)를 쉼표로 구분한 목록입니다.
Max Records To Return

(선택사항)

각 관계 유형(예: relates to 또는 depends on)에 대해 반환할 최대 레코드 관계 수입니다.

기본값은 50입니다.

작업 출력

CMDB 레코드 세부정보 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 CMDB 레코드 세부정보 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "56f3a7ad7f701200bee45f19befa910f",
                "type": {
                    "display_value": "Members::Member of",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "Example",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ],
        "attributes": {
            "attested_date": "",
            "skip_sync": "false",
            "operational_status": "1",
            "caption": "",
            "cluster_type": "",
            "sys_updated_on": "2016-01-06 19:04:07",
            "attestation_score": "",
            "discovery_source": "",
            "first_discovered": "",
            "sys_updated_by": "example.user",
            "cluster_status": "",
            "due_in": "",
            "sys_created_on": "2016-01-06 16:47:15",
            "sys_domain": {
                "display_value": "global",
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "install_date": "",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "example.user",
            "warranty_expiration": "",
            "cluster_version": "",
            "asset_tag": "",
            "fqdn": "",
            "change_control": "",
            "owned_by": "",
            "checked_out": "",
            "sys_domain_path": "/",
            "delivery_date": "",
            "maintenance_schedule": "",
            "install_status": "1",
            "cost_center": "",
            "attested_by": "",
            "supported_by": "",
            "dns_domain": "",
            "name": "SAP-LB-Win-Cluster",
            "assigned": "",
            "purchase_date": "",
            "subcategory": "Cluster",
            "short_description": "",
            "assignment_group": "",
            "managed_by": "",
            "managed_by_group": "",
            "last_discovered": "",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_win_cluster",
            "manufacturer": "",
            "sys_id": "SYS_ID",
            "cluster_id": "",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!5/!$",
            "vendor": "",
            "mac_address": "",
            "company": "",
            "model_number": "",
            "justification": "",
            "department": "",
            "assigned_to": "",
            "start_date": "",
            "cost": "",
            "comments": "",
            "sys_mod_count": "1",
            "serial_number": "",
            "monitor": "false",
            "model_id": "",
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "support_group": "",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "location": "",
            "asset": "",
            "category": "Resource",
            "fault_count": "0",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "3b3d95297f701200bee45f19befa910c",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "IP-Router-3",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ]
    }
}
출력 메시지

CMDB 레코드 세부정보 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully returned details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST.

Action wasn't able to return details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST

Action wasn't able to return details for CMDB records in the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found.

Action wasn't able to return details for CMDB record with Sys ID SYS_ID in the Class CLASS_NAME in Service Now. Reason: Record with Sys ID SYS_ID was not found in Class CLASS_NAME.

Information about the provided Sys IDs was not found.

 작업이 완료되었습니다.
Error executing action "Get CMDB Record Details". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 CMDB 레코드 세부정보 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

사고 가져오기

사고 가져오기 작업을 사용하여 ServiceNow 사고에 대한 정보를 검색합니다.

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

작업 입력

사고 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Incident Number

필수 입력란입니다.

검색할 ServiceNow 이슈의 고유 식별자이며 INCINCIDENT_NUMBER 형식입니다.

작업 출력

사고 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 사고 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
스크립트 결과

다음 표에는 사고 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
incident_number INCIDENT_NUMBER

OAuth 토큰 가져오기

OAuth 토큰 가져오기 작업을 사용하여 ServiceNow의 OAuth 갱신 토큰을 가져옵니다.

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

작업 입력

없음

작업 출력

OAuth 토큰 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 OAuth 토큰 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "access_token": "Na4Kb1oWpFcYNUnyAjsYldiTMxYF1Cz79Q",
    "refresh_token": "0ryCENbbvfggZbNG9rFFd8_C8X0UgAQSMQkPJNStGwEEt0qNt-F1lw",
    "scope": "useraccount",
    "token_type": "Bearer",
    "expires_in": 1799
}
출력 메시지

OAuth 토큰 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명
Successfully generated Oauth tokens for ServiceNow. Now navigate to the configuration tab and put "refresh_token" value in the "Refresh Token" parameter. Note: "Username" and "Password" parameters can be emptied. 작업이 완료되었습니다.
Error executing action "Get Oauth Token". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 OAuth 토큰 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

레코드 세부정보 가져오기

레코드 세부정보 가져오기 작업을 사용하여 ServiceNow에서 특정 테이블 레코드에 대한 정보를 가져옵니다.

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

작업 입력

레코드 세부정보 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

필수 입력란입니다.

정보를 가져올 레코드가 포함된 ServiceNow 테이블의 이름입니다 (예: incident).
Record Sys ID

필수 입력란입니다.

세부정보를 검색할 특정 ServiceNow 레코드의 시스템 ID (sys_id)입니다.
Fields

(선택사항)

검색된 레코드에서 반환할 특정 필드 (열)의 쉼표로 구분된 목록입니다 (예: sys_id,number,short_description).

값이 제공되지 않으면 작업은 레코드의 기본 필드를 반환합니다.

작업 출력

레코드 세부정보 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 레코드 세부정보 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
출력 메시지

레코드 세부정보 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully retrieved information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow.

Action wasn't able to retrieve information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Reason: ERROR_REASON.

 작업이 완료되었습니다.
Error executing action "Get Record Details". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 레코드 세부정보 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

사용자 세부정보 가져오기

사용자 세부정보 가져오기 작업을 사용하여 ServiceNow의 sys_id 매개변수를 통해 사용자에 대한 정보를 가져옵니다.

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

작업 입력

사용자 세부정보 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
User Sys IDs

(선택사항)

세부정보를 가져올 사용자에 해당하는 시스템 ID의 쉼표로 구분된 목록입니다 (예: sys_id_1,sys_id_2).
Emails

(선택사항)

세부정보를 가져올 사용자에 해당하는 이메일 주소를 쉼표로 구분한 목록입니다 (예: email1@example.com,email2@example.com).

작업 출력

사용자 세부정보 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 가능
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
케이스 월 테이블

사용자 세부정보 가져오기 작업은 다음 표를 제공합니다.

테이블 이름: 사용자 세부정보

표 열:

  • Sys ID(sys_id로 매핑됨)
  • 이름(name로 매핑됨)
  • 사용자 이름(user_name로 매핑됨)
  • 이메일(email로 매핑됨)
JSON 결과

다음 예시는 사용자 세부정보 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": [
        {
            "calendar_integration": "1",
            "country": "",
            "last_position_update": "",
            "user_password": "example",
            "last_login_time": "",
            "source": "",
            "sys_updated_on": "2020-08-29 02:42:42",
            "building": "",
            "web_service_access_only": "false",
            "notification": "2",
            "enable_multifactor_authn": "false",
            "sys_updated_by": "user@example",
            "sys_created_on": "2012-02-18 03:04:52",
            "agent_status": "",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "",
            "vip": "false",
            "sys_created_by": "admin",
            "longitude": "",
            "zip": "",
            "home_phone": "",
            "time_format": "",
            "last_login": "",
            "default_perspective": "",
            "geolocation_tracked": "false",
            "active": "true",
            "sys_domain_path": "/",
            "cost_center": {
                "link": "https://example.service-now.com/api/now/table/cmn_cost_center/ID",
                "value": "ID"
            },
            "phone": "",
            "name": "Example User",
            "employee_number": "",
            "password_needs_reset": "false",
            "gender": "Male",
            "city": "",
            "failed_attempts": "",
            "user_name": "example.user",
            "latitude": "",
            "roles": "",
            "title": "",
            "sys_class_name": "sys_user",
            "sys_id": "SYS_ID",
            "internal_integration_user": "false",
            "ldap_server": "",
            "mobile_phone": "",
            "street": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "department": {
                "link": "https://dev98773.service-now.com/api/now/table/cmn_department/ID",
                "value": "ID"
            },
            "first_name": "Example",
            "email": "example@example.com",
            "introduction": "",
            "preferred_language": "",
            "manager": "",
            "business_criticality": "3",
            "locked_out": "false",
            "sys_mod_count": "4",
            "last_name": "User",
            "photo": "",
            "avatar": "063e38383730310042106710ce41f13b",
            "middle_name": "",
            "sys_tags": "",
            "time_zone": "",
            "schedule": "",
            "on_schedule": "",
            "date_format": "",
            "location": {
                "link": "https://example.service-now.com/api/now/table/cmn_location/ID",
                "value": "ID"
            }
        }
    ]
}
출력 메시지

사용자 세부정보 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully retrieved information about users from ServiceNow with the following Sys IDs: SYS_ID_LIST.

Action wasn't able to retrieve information about the users in ServiceNow with the following Sys IDs: SYS_ID_LIST.

Information about the users with specified Sys IDs was not found in ServiceNow.

 작업이 완료되었습니다.
Error executing action "Get User Details". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 사용자 세부정보 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

CMDB 레코드 나열

CMDB 레코드 나열 작업을 사용하여 ServiceNow에서 동일한 클래스의 CMDB 레코드를 나열합니다.

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

쿼리 필터 생성 중

Query Filter 매개변수는 표준 ServiceNow 인코딩 쿼리 문자열 (sysparm_query)을 허용합니다. 이러한 문자열은 ServiceNow 인터페이스 내에서 직접 생성하거나 (예: 목록 보기에서 필터를 만들고 쿼리 복사 선택) 수동으로 구성할 수 있습니다.

이러한 문자열을 생성하고 사용하는 방법에 대한 안내는 ServiceNow 문서의 인코딩된 쿼리 문자열을 참조하세요.

작업 입력

CMDB 레코드 나열 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Class Name

필수 입력란입니다.

레코드를 검색할 CMDB 클래스의 이름입니다(예: cmdb_ci_appl).

ServiceNow 클래스 이름에 대한 자세한 내용은 클래스 정의 및 메타데이터 보기 및 수정을 참조하세요.
Query Filter

(선택사항)

반환된 레코드를 필터링하는 데 사용되는 인코딩된 쿼리 문자열입니다 (예: sys_idLIKE1^sys_idSTARTSWITH0).

ServiceNow 목록 보기에서 쿼리 복사 옵션을 사용하여 유효한 쿼리 문자열을 생성할 수 있습니다. 자세한 내용은 인코딩된 쿼리 문자열을 참조하세요.
Max Records To Return

(선택사항)

적용된 필터를 기준으로 검색할 최대 레코드 수입니다.

기본값은 50입니다.

작업 출력

CMDB 레코드 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 가능
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
케이스 월 테이블

CMDB 레코드 나열 작업은 다음 표를 제공합니다.

테이블 이름: CLASS_NAME 레코드

표 열:

  • 이름(name로 매핑됨)
  • Sys ID(sys_id로 매핑됨)
JSON 결과

다음 예시에서는 CMDB 레코드 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": [
        {
            "sys_id": "SYS_ID",
            "name": "Example server"
        }
    ]
}
출력 메시지

CMDB 레코드 나열 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully listed CMDB records for the Class CLASS_NAME in ServiceNow.

Action wasn't able to list CMDB records for the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found in Service Now.".format(Class name)

 작업이 완료되었습니다.
Error executing action "List CMDB Records". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 CMDB 레코드 나열 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

기록 댓글 나열

레코드 댓글 나열 작업을 사용하여 ServiceNow의 특정 테이블 레코드와 관련된 댓글을 나열합니다.

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

작업 입력

레코드 댓글 나열 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

필수 입력란입니다.

댓글을 나열할 레코드가 포함된 ServiceNow 테이블의 이름입니다 (예: incident).
Record Sys ID

필수 입력란입니다.

댓글을 나열할 레코드의 시스템 ID (sys_id)입니다.
Type

필수 입력란입니다.

검색할 댓글 또는 메모의 유형입니다.

가능한 값은 다음과 같습니다.

  • Comment
  • Work Note

기본값은 Comment입니다.
Max Results To Return

(선택사항)

반환할 최대 댓글 또는 작업 메모 수입니다.

기본값은 50입니다.

작업 출력

레코드 댓글 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시에서는 레코드 댓글 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
출력 메시지

레코드 댓글 나열 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No CONTENT_TYPE were found for TABLE_NAME with Sys ID SYS_ID in ServiceNow.

 작업이 완료되었습니다.
Error executing action "List Record Comments". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 레코드 댓글 나열 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

사용자 관련 레코드 나열 작업을 사용하여 ServiceNow의 사용자와 관련된 테이블의 레코드를 나열합니다.

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

작업 입력

사용자 관련 레코드 나열 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

필수 입력란입니다.

관련 레코드를 검색할 ServiceNow 테이블의 이름입니다 (예: incident).
Usernames

필수 입력란입니다.

관련 레코드를 검색할 사용자 이름의 쉼표로 구분된 목록입니다.
Max Days Backwards

필수 입력란입니다.

현재 날짜로부터 관련 레코드를 검색할 이전 일수입니다.

기본값은 1입니다.
Max Records To Return

(선택사항)

사용자별로 반환할 최대 레코드 수입니다.

기본값은 50입니다.

작업 출력

사용자 관련 레코드 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시에서는 사용자와 관련된 레코드 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-19 14:18:40",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010008",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-19 14:18:40",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-19 14:18:20",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "TEST",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": "",
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
         "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
출력 메시지

사용자 관련 레코드 나열 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully retrieved related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

Action wasn't able to retrieve related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

No related table records were retrieved for the provided users.

작업이 완료되었습니다.
Error executing action "List Records Related To User". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 사용자 관련 레코드 나열 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

핑

핑 작업을 사용하여 ServiceNow에 대한 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

핑 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
스크립트 결과

다음 표에는 핑 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

사고 업데이트

사고 업데이트 작업을 사용하여 사고 정보를 업데이트합니다.

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

작업 입력

사고 업데이트 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Incident Number

필수 입력란입니다.

업데이트할 ServiceNow 사고의 고유 식별자이며 INCINCIDENT_NUMBER 형식입니다.
Short Description

(선택사항)

사고에 대한 간단한 설명입니다.
Impact

(선택사항)

사고의 영향 수준입니다.

가능한 값은 다음과 같습니다.

  • 높은 경우 1
  • 2(Medium)
  • 3(낮음)

기본값은 1입니다.
Urgency

(선택사항)

사고의 긴급도 수준입니다.

가능한 값은 다음과 같습니다.

  • 높은 경우 1
  • 2(Medium)
  • 3(낮음)

기본값은 1입니다.
Category

(선택사항)

사고의 카테고리입니다.
Assignment Group ID

(선택사항)

사고를 할당할 그룹의 전체 이름입니다.
Assigned User ID

(선택사항)

사고를 할당할 사용자의 전체 이름입니다.
Description

(선택사항)

사고에 대한 설명입니다.
Incident State

(선택사항)

라벨(예: New 또는 In Progress) 대신 이슈 상태의 기본 ServiceNow 값 (예: 1 또는 in_progress)입니다.
Custom Fields

(선택사항)

업데이트할 필드 이름과 해당 값이 포함된 JSON 형식 문자열입니다 (예: {"location":"London", "category":"database"}).

이 매개변수를 사용하여 작업 입력으로 명시적으로 정의되지 않은 필드를 수정할 수 있습니다.

작업 출력

사고 업데이트 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 사고 업데이트 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
스크립트 결과

다음 표에는 사고 업데이트 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
incident_number INCIDENT_NUMBER

레코드 업데이트

레코드 업데이트 작업을 사용하여 ServiceNow의 다양한 테이블에 속한 기존 레코드를 수정합니다.

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

작업 입력

레코드 업데이트 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

(선택사항)

업데이트할 레코드가 포함된 ServiceNow 테이블의 이름입니다 (예: incident).
Object Json Data

필수 입력란입니다.

레코드에 적용할 필드-값 쌍이 포함된 JSON 객체입니다(예: {"short_description": "Updated description"}).
Record Sys ID

필수 입력란입니다.

업데이트할 특정 레코드의 시스템 ID (sys_id)입니다.

작업 출력

레코드 업데이트 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 레코드 업데이트 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
스크립트 결과

다음 표에는 레코드 업데이트 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
record_sys_id RECORD_SYS_ID

댓글 대기

댓글 대기 작업을 사용하여 ServiceNow의 특정 테이블 레코드에 댓글 또는 작업 메모가 추가될 때까지 플레이북 실행을 일시중지합니다.

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

작업 입력

댓글 대기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

필수 입력란입니다.

댓글을 기다릴 레코드가 포함된 ServiceNow 테이블의 이름입니다 (예: incident).
Record Sys ID

필수 입력란입니다.

댓글을 모니터링할 레코드의 시스템 ID (sys_id)입니다.
Type

필수 입력란입니다.

작업이 대기해야 하는 댓글 또는 메모의 유형입니다.

가능한 값은 다음과 같습니다.

  • Comment
  • Work Note

기본값은 Comment입니다.
Wait Mode

필수 입력란입니다.

작업이 대기를 중지하고 진행되는 시점을 결정하는 조건입니다.

가능한 값은 다음과 같습니다.

  • Until Timeout: 작업은 전체 제한 시간 동안 대기한 후 누적된 모든 댓글을 반환합니다.
  • Until First Message: 작업이 시작된 후 첫 번째 새 댓글 또는 작업 메모가 게시될 때까지 작업이 대기합니다.
  • Until Specific Text: Text에 지정된 텍스트가 포함된 댓글 또는 작업 메모가 게시될 때까지 작업이 대기합니다.

기본값은 Until Timeout입니다.
Text

(선택사항)

새 댓글 또는 작업 메모 내에서 작업이 대기하는 특정 텍스트 문자열입니다.

이 매개변수는 Wait Mode 값으로 Until Specific Text가 선택된 경우에만 사용됩니다.

작업 출력

댓글 대기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 댓글 대기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
출력 메시지

댓글 대기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No new CONTENT_TYPE were added during the timeframe of action execution to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

 작업이 완료되었습니다.
Error executing action "Wait For Comments". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.
스크립트 결과

다음 표에는 댓글 대기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

필드 업데이트 대기

필드 업데이트 대기 작업을 사용하여 ServiceNow 데이터 레코드의 특정 필드가 예상 값 중 하나로 업데이트될 때까지 플레이북 실행을 일시중지합니다.

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

작업 입력

필드 업데이트 대기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Table Name

필수 입력란입니다.

모니터링할 레코드가 포함된 ServiceNow 테이블의 이름입니다(예: incident).
Record Sys ID

필수 입력란입니다.

필드 업데이트를 모니터링할 레코드의 시스템 ID (sys_id)입니다.
Field - Column Name

필수 입력란입니다.

작업에서 변경사항을 모니터링하는 열 (필드)의 이름입니다.
Field - Values

필수 입력란입니다.

모니터링되는 필드에서 발견되면 작업이 대기를 중지하고 진행하도록 하는 쉼표로 구분된 값 목록입니다 (예: In Progress,Resolved).

작업 출력

필드 업데이트 대기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
스크립트 결과

다음 표에는 필드 업데이트 대기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
updated_field UPDATED_FIELD

상태 업데이트 대기

상태 업데이트 대기 작업을 사용하여 특정 ServiceNow 사고 상태가 예상 값 중 하나로 업데이트될 때까지 플레이북 실행을 일시중지합니다.

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

작업 입력

상태 업데이트 대기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Incident Number

필수 입력란입니다.

모니터링할 ServiceNow 이슈의 고유 식별자이며 INCINCIDENT_NUMBER 형식입니다.
Statuses

필수 입력란입니다.

도달하면 작업이 대기를 중지하고 진행하도록 하는 사고 상태의 쉼표로 구분된 목록입니다(예: In Progress,Resolved).

작업 출력

상태 업데이트 대기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
스크립트 결과

다음 표에는 상태 업데이트 대기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
new_status STATUS

커넥터

Google SecOps에서 커넥터를 구성하는 방법에 대한 자세한 내용은 데이터 수집 (커넥터)을 참조하세요.

ServiceNow 커넥터

ServiceNow 커넥터를 사용하여 ServiceNow에서 이슈를 검색합니다.

동적 쿼리 목록 작업

ServiceNow 커넥터에서 동적 목록은 커넥터가 ServiceNow를 쿼리하는 데 사용하는 sysparm_query를 수정합니다. 이렇게 하면 레코드 유형에 지원되는 필드를 기준으로 레코드를 필터링할 수 있습니다.

필터를 정의하려면 다음 형식으로 하나의 필드-값 쌍을 포함하도록 각 동적 목록 항목을 구성합니다. FIELD_NAME=VALUE.

예를 들면 category=security입니다.

Use whitelist as a blacklist가 사용 설정되면 커넥터가 쿼리 로직을 반전시켜 동적 목록이 필터가 아닌 차단 목록으로 작동합니다.

커넥터 입력

ServiceNow 커넥터에는 다음 매개변수가 필요합니다.

매개변수 설명
Product Field Name

필수 입력란입니다.

제품 이름이 저장된 필드의 이름입니다.

제품 이름은 주로 매핑에 영향을 미칩니다. 커넥터의 매핑 프로세스를 간소화하고 개선하기 위해 기본값은 코드에서 참조되는 대체 값으로 확인됩니다. 이 매개변수에 잘못된 입력이 있으면 기본적으로 대체 값으로 확인됩니다.

기본값은 Product Name입니다.
Event Field Name

필수 입력란입니다.

이벤트 이름 (하위 유형)을 결정하는 필드의 이름입니다.

기본값은 sys_class_name입니다.
Rule Generator

(선택사항)

레코드 검색 중에 적용할 특정 쿼리 또는 규칙 집합을 정의하는 값이 있는 필드의 이름입니다.
Api Root

필수 입력란입니다.

ServiceNow 인스턴스의 API 루트입니다.

기본값은 https://INSTANCE.service-now.com/api/now/v1/입니다.
Username

필수 입력란입니다.

ServiceNow 계정의 사용자 이름입니다.
Password

필수 입력란입니다.

ServiceNow 계정의 비밀번호입니다.
Verify SSL

(선택사항)

선택하면 통합에서 ServiceNow 서버에 연결할 때 SSL 인증서를 검증합니다.

기본적으로 사용 설정됩니다.
Use sys_domain Environment

(선택사항)

선택하면 커넥터가 ServiceNow sys_domain 필드를 수집된 케이스의 환경으로 사용합니다.

이 필드가 누락되었거나 사용할 수 없는 경우 커넥터는 기본적으로 Environment 매개변수에 지정된 값을 사용합니다.
Days Backwards

(선택사항)

현재 시간으로부터 기록을 가져올 이전 일수입니다.

이 매개변수는 초기 커넥터 실행에 사용되거나 이전 커넥터 타임스탬프가 만료된 경우 대체 값으로 사용됩니다.

기본값은 5입니다.
Disable Overflow

(선택사항)

선택하면 커넥터가 Google SecOps 오버플로 메커니즘을 무시합니다.
Max Incidents Per Cycle

(선택사항)

각 커넥터 반복 중에 검색할 최대 이슈 수입니다.

기본값은 10입니다.
Environments Whitelist

(선택사항)

커넥터가 Google SecOps로 수집할 쉼표로 구분된 환경(도메인) 목록입니다(예: env1,env2).
Use whitelist as a blacklist

(선택사항)

선택하면 커넥터가 동적 목록을 차단 목록으로 사용합니다.

기본적으로 사용 중지됩니다.
PythonProcessTimeout

필수 입력란입니다.

현재 스크립트를 실행하는 Python 프로세스의 제한 시간 한도(초)입니다.

기본값은 60입니다.
Incident Table

(선택사항)

사고 관련 작업 및 레코드 검색에 사용할 API 테이블 이름 또는 경로입니다.

기본적으로 통합은 table/incident 경로를 사용합니다.
Client ID

(선택사항)

ServiceNow 통합의 클라이언트 ID로, 클라이언트 사용자 인증 정보를 사용하는 OAuth 2.0 인증에 필요합니다.

갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Client Secret

(선택사항)

클라이언트 사용자 인증 정보를 사용하는 OAuth 2.0 인증에 필요한 ServiceNow 통합의 클라이언트 보안 비밀번호입니다.

갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Refresh Token

(선택사항)

갱신 토큰을 사용하는 OAuth 2.0 인증에 필요한 ServiceNow 통합의 갱신 토큰입니다.

이 구성된 갱신 토큰은 90일마다 만료됩니다.

갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Assignment Group

(선택사항)

커넥터가 레코드를 수집해야 하는 할당 그룹의 이름입니다.
Use Oauth Authentication

(선택사항)

선택하면 통합에서 OAuth 2.0을 사용하여 인증합니다.

OAuth 2.0 인증을 사용하려면 클라이언트 사용자 인증 정보(Client ID 및 Client Secret) 또는 Refresh Token를 설정해야 합니다.

기본적으로 사용 중지됩니다.
Server Time Zone

(선택사항)

ServiceNow 서버에 구성된 시간대입니다 (예: UTC 또는 Asia/Jerusalem).

기본값은 UTC입니다.
Table Name

(선택사항)

레코드를 검색할 테이블의 이름입니다(예: incident).
Event Name

(선택사항)

레코드가 수집될 때 생성되는 Google SecOps 이벤트의 이름입니다 (예: ServiceNowEvent).
Proxy Server Address

(선택사항)

사용할 프록시 서버의 주소입니다.
Proxy Username

(선택사항)

인증할 프록시 사용자 이름입니다.
Proxy Password

(선택사항)

인증할 프록시 비밀번호입니다.
Get User Information

(선택사항)

선택하면 커넥터가 사고와 관련된 사용자에 대한 정보를 추가로 검색합니다.

기본적으로 사용 중지됩니다.

작업

작업에 대한 자세한 내용은 새 작업 구성 및 고급 예약을 참조하세요.

ServiceNow - 종료된 이슈 동기화

ServiceNow - 종료된 이슈 동기화 작업을 사용하여 종료된 ServiceNow 이슈를 해당 Google SecOps 알림 및 케이스와 동기화합니다.

이 작업은 ServiceNow 태그와 사고 번호가 포함된 TICKET_ID 컨텍스트 값이 포함된 알림 및 케이스로 수집된 ServiceNow 사고를 처리합니다.

작업 매개변수

ServiceNow - 종료된 이슈 동기화 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
API Root 필수

ServiceNow 인스턴스의 API 루트입니다. 기본값은 https://INSTANCE.service-now.com/api/now/v1/입니다.
Username 필수

ServiceNow 인스턴스의 사용자 이름입니다.
Password 필수

ServiceNow 인스턴스의 비밀번호입니다.
Verify SSL 선택사항

선택하면 통합에서 ServiceNow 서버에 연결할 때 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다.
Client ID 선택사항

ServiceNow 통합의 클라이언트 ID로, 클라이언트 사용자 인증 정보를 사용하는 OAuth 2.0 인증에 필요합니다. 갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Client Secret 선택사항

클라이언트 사용자 인증 정보를 사용하는 OAuth 2.0 인증에 필요한 ServiceNow 통합의 클라이언트 보안 비밀번호입니다. 갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Refresh Token 선택사항

갱신 토큰을 사용하는 OAuth 2.0 인증에 필요한 ServiceNow 통합의 갱신 토큰입니다. 이 구성된 갱신 토큰은 90일마다 만료됩니다. 갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Use OAuth Authentication 선택사항

선택하면 통합에서 OAuth 2.0을 사용하여 인증합니다. OAuth 2.0 인증을 사용하려면 클라이언트 사용자 인증 정보 (Client ID 및 Client Secret) 또는 Refresh Token를 설정해야 합니다. 기본적으로 사용 중지됩니다.
Max Hours Backwards 선택사항

종료된 사고를 검색하고 동기화하기 위해 현재 시간으로부터 거슬러 올라가는 시간입니다. 기본값은 24입니다.
Table Name 필수

종료된 이슈를 검색할 데이터베이스 테이블의 이름입니다 (예: incident).

ServiceNow - 사고 동기화

ServiceNow - Sync Incidents 작업을 사용하여 ServiceNow 사고 필드 및 첨부파일을 Google SecOps의 관련 케이스 및 알림과 동기화합니다.

이 작업을 실행하려면 ServiceNow 통합 사용자에게 ITIL (itil) 역할이 있어야 합니다. 자세한 내용은 ServiceNow 문서의 기본 시스템 역할을 참조하세요.

직무 요건

작업이 올바르게 작동하려면 Google SecOps 케이스 또는 알림에 다음이 구성되어 있는지 확인합니다(Sync Level 매개변수에 따라 다름).

  • 태그: 케이스에 ServiceNow Incident Sync 태그가 있어야 합니다.
  • 컨텍스트 값: 케이스 또는 알림에는 쉼표로 구분된 ServiceNow 이슈 번호 목록이 포함된 TICKET_ID 컨텍스트 키가 있어야 합니다 (예: INC0000050,INC0000051). Siemplify Utilities 통합의 범위 컨텍스트 값 설정 작업을 사용하여 TICKET_ID 컨텍스트 값을 설정합니다.

작업 매개변수

ServiceNow - 사고 동기화 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
API Root 필수

ServiceNow 인스턴스의 API 루트입니다. 기본값은 https://INSTANCE.service-now.com/api/now/v1/입니다.
Username 선택사항

ServiceNow 인스턴스의 사용자 이름입니다.

기본 비밀번호 인증을 사용하여 인증하는 경우 이 매개변수가 필요합니다.
Password 선택사항

ServiceNow 인스턴스의 비밀번호입니다.

기본 비밀번호 인증을 사용하여 인증하는 경우 이 매개변수가 필요합니다.
Sync Level 필수

작업에서 데이터를 동기화하는 수준입니다. 가능한 값: Case, Alert. 기본값은 Case입니다.
Max Hours Backwards 필수

동기화할 케이스를 검색하기 위해 현재 시간으로부터 거슬러 올라갈 수 있는 최대 시간입니다. 기본값은 24입니다.
Verify SSL 선택사항

선택하면 통합에서 ServiceNow 서버에 연결할 때 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다.
Use OAuth Authentication 선택사항

선택하면 작업에서 기본 인증 대신 OAuth 인증을 사용합니다. 선택하면 Client ID, Client Secret, Refresh Token 매개변수가 필요합니다. 기본적으로 사용 중지됩니다.
Client ID 선택사항

ServiceNow 애플리케이션의 클라이언트 ID입니다. Use OAuth Authentication가 선택된 경우 필수입니다.
Client Secret 선택사항

ServiceNow 애플리케이션의 클라이언트 보안 비밀번호입니다. Use OAuth Authentication가 선택된 경우 필수입니다.
Refresh Token 선택사항

ServiceNow 애플리케이션의 갱신 토큰입니다. Use OAuth Authentication가 선택된 경우 필수입니다.

테이블 레코드 댓글 동기화

테이블 레코드 댓글 동기화 작업을 사용하여 ServiceNow 테이블 레코드와 Google SecOps 케이스 간에 댓글을 동기화합니다.

작업 매개변수

테이블 레코드 댓글 동기화 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
API Root 필수

ServiceNow 인스턴스의 API 루트입니다. 기본값은 https://INSTANCE.service-now.com/api/now/v1/입니다.
Username 필수

ServiceNow 인스턴스의 사용자 이름입니다.
Password 필수

ServiceNow 인스턴스의 비밀번호입니다.
Verify SSL 선택사항

선택하면 통합에서 ServiceNow 서버에 연결할 때 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다.
Client ID 선택사항

ServiceNow 통합의 클라이언트 ID로, 클라이언트 사용자 인증 정보를 사용하는 OAuth 2.0 인증에 필요합니다. 갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Client Secret 선택사항

클라이언트 사용자 인증 정보를 사용하는 OAuth 2.0 인증에 필요한 ServiceNow 통합의 클라이언트 보안 비밀번호입니다. 갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Refresh Token 선택사항

갱신 토큰을 사용하는 OAuth 2.0 인증에 필요한 ServiceNow 통합의 갱신 토큰입니다. 이 구성된 갱신 토큰은 90일마다 만료됩니다. 갱신 토큰 또는 클라이언트 사용자 인증 정보를 사용하여 인증할 수 있습니다. 갱신 토큰과 클라이언트 사용자 인증 정보가 모두 구성된 경우 통합은 인증에 갱신 토큰을 사용합니다.
Use OAuth Authentication 선택사항

선택하면 통합에서 OAuth 2.0을 사용하여 인증합니다. OAuth 2.0 인증을 사용하려면 클라이언트 사용자 인증 정보 (Client ID 및 Client Secret) 또는 Refresh Token를 설정해야 합니다. 기본적으로 사용 중지됩니다.
Table Name 필수

댓글을 동기화할 레코드를 검색할 ServiceNow 테이블의 이름입니다 (예: incident).

태그별로 테이블 레코드 댓글 동기화

태그별 테이블 레코드 댓글 동기화 작업을 사용하여 ServiceNow 테이블 레코드와 Google SecOps 케이스 간에 댓글을 동기화합니다.

직무 요건

작업이 올바르게 작동하려면 Google SecOps 케이스에 다음 두 태그가 있어야 합니다.

  • ServiceNow TABLE_NAME(여기서 <var class="readonly">TABLE_NAME</var>은 ServiceNow 테이블의 이름입니다(예: incident)).
  • ServiceNow TicketId: TICKET_ID (여기서 <var class="readonly">TICKET_ID</var>는 해당 레코드의 시스템 ID 또는 번호)

작업 매개변수

태그별 테이블 레코드 댓글 동기화 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
API Root 필수

ServiceNow 인스턴스의 API 루트입니다. 기본값은 https://INSTANCE.service-now.com/api/now/v1/입니다.
Username 필수

ServiceNow 인스턴스의 사용자 이름입니다.
Password Mandatory

ServiceNow 인스턴스의 비밀번호입니다.
Table Name 필수

검색할 데이터베이스 테이블의 이름입니다(예: incident).
Verify SSL 선택사항

선택하면 통합에서 ServiceNow 서버에 연결할 때 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다.

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