Google SecOps와 EmailV2 통합

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

사용 사례

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

  • 피싱 분류 및 알림: 외부 사용자를 포함한 수신자에게 알림 이메일을 보내고 사용자 응답 (예: 피싱 시도 확인)을 기다리는 비동기 플레이북을 설정하는 프로세스를 자동화합니다.

  • 사고 데이터 보강 및 보관: 기준 (예: 발신자 또는 제목)에 따라 사서함에서 관련 메일을 검색하고 의심스러운 이메일의 모든 첨부파일을 케이스 월에 직접 저장하여 포렌식 분석 및 데이터 보관을 수행합니다.

  • 편지함 관리 및 격리: 악성 이메일 또는 분류된 이메일을 받은편지함에서 스팸 격리 저장소 또는 보관처리 폴더로 자동으로 이동하거나 특정 필터와 일치하는 이메일을 영구적으로 삭제합니다 (예: 여러 폴더에서 알려진 멀웨어 이메일의 모든 사본 삭제).

  • 대화목록 응답 및 공동작업: 대화목록 답장 보내기 작업을 사용하여 기존 이메일 대화목록 내에서 즉각적인 답장 또는 구조화된 응답을 전송하여 필요한 모든 당사자가 관련 보안 업데이트를 계속 확인할 수 있도록 합니다.

시작하기 전에

EmailV2 통합을 사용 설정하여 메일 서버에 성공적으로 연결하려면 구성된 사서함이 IMAP/SMTP를 사용하여 서드 파티 애플리케이션에 액세스 권한을 부여해야 합니다.

Gmail 또는 Google Workspace 계정을 사용하는 경우 앱 비밀번호를 사용하여 인증해야 합니다. Google 서버에 대한 IMAP/SMTP 연결에는 일반 계정 비밀번호가 작동하지 않습니다.

앱 비밀번호를 사용하려면 다음 요구사항을 충족해야 합니다.

  1. 2단계 인증 사용 설정: 앱 비밀번호는 Google 계정에서 2단계 인증이 사용 설정된 경우에만 생성할 수 있습니다. 자세한 내용은 2단계 인증 사용 설정하기를 참고하세요.

  2. 16자리 앱 비밀번호 생성: 통합을 위한 고유한 비밀번호를 만듭니다. 자세한 내용은 앱 비밀번호로 로그인하기를 참고하세요.

IMAP/SMTP에 대한 네트워크 액세스

IMAP을 사용하여 수신 이메일에 액세스하고 처리하고 SMTP를 사용하여 발신 이메일을 보내려면 구성된 계정 사용자 인증 정보를 사용하여 네트워크에 액세스해야 합니다.

네트워크 요구사항

함수 기본 포트 방향 프로토콜
메일 서버 통신 Multivalues 아웃바운드 IMAP/SMTP

통합 매개변수

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

매개변수 설명
IMAP - Use SSL

(선택사항)

선택하면 IMAP 서버에 연결할 때 보안 통신 (SSL/TLS)이 사용 설정됩니다.

기본적으로 사용 설정됩니다.
SMTP - Use Authentication

(선택사항)

선택하면 SMTP 연결에 대한 인증이 사용 설정됩니다.

SMTP 서버가 '개방형 릴레이' 구성이 아니고 발신 이메일을 보내기 위해 사용자 인증 정보가 필요한 경우에 필요합니다.

기본적으로 사용 설정됩니다.
Sender's Address

필수 입력란입니다.

메시지 전송 및 수신을 위해 통합에서 사용하는 사서함의 이메일 주소입니다.
Sender's Display Name

필수 입력란입니다.

통합에서 이메일을 보낼 때 발신자로 표시되는 이름입니다.
SMTP Server Address

(선택사항)

이메일 전송에 사용되는 SMTP 서버의 DNS 호스트 이름 또는 IP 주소입니다(예: smtp.gmail.com).
SMTP Port

(선택사항)

SMTP 서버에 연결하는 데 사용되는 포트 번호입니다(예: 587 또는 465).
IMAP Server Address

(선택사항)

수신 이메일을 검색하는 데 필요한 IMAP 서버의 DNS 호스트 이름 또는 IP 주소입니다(예: imap.gmail.com).
IMAP Port

(선택사항)

IMAP 서버에 연결하는 데 사용되는 포트 번호입니다(예: 993).
Username

필수 입력란입니다.

메일 서버 인증에 필요한 사용자 이름 (일반적으로 전체 이메일 주소)입니다.
Password

필수 입력란입니다.

메일 서버 인증에 필요한 비밀번호입니다.

Gmail 또는 Google Workspace 계정의 경우 Google계정 보안 설정에서 생성된 16자리 앱 비밀번호를 입력해야 합니다.

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

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

작업

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

이메일 삭제

이메일 삭제 작업을 사용하여 지정된 검색 기준과 일치하는 이메일을 편지함에서 삭제합니다. 이 작업을 활용하여 일치하는 첫 번째 이메일을 삭제하거나 일치하는 모든 이메일을 삭제할 수 있습니다.

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

작업 입력

이메일 삭제 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Folder Name

필수 입력란입니다.

작업에서 이메일을 검색하는 편지함 폴더의 쉼표로 구분된 목록입니다.
Message IDs

(선택사항)

검색 및 삭제할 특정 메일 ID의 쉼표로 구분된 목록입니다.

이 목록을 제공하면 Subject Filter, Sender Filter, Recipient Filter가 재정의됩니다.
Subject Filter

(선택사항)

일치하는 이메일의 검색 범위를 좁히는 데 사용되는 제목입니다.
Sender Filter

(선택사항)

일치하는 이메일을 검색하는 데 사용되는 발신자 주소입니다.
Recipient Filter

(선택사항)

일치하는 이메일을 검색하는 데 사용되는 수신자 주소입니다.
Days Back

(선택사항)

작업에서 삭제할 이메일을 검색하는 기간 (일)입니다.

기간은 일 단위로 계산됩니다.

0 값을 사용하면 현재 날짜 내에 수신된 이메일로만 검색이 제한됩니다.

기본값은 0입니다.
Delete all matching emails

(선택사항)

선택하면 지정된 기준과 일치하는 모든 이메일이 삭제되고, 선택하지 않으면 첫 번째 일치 항목만 삭제됩니다.

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

작업 출력

이메일 삭제 작업은 다음 출력을 제공합니다.

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

다음 예시는 이메일 삭제 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "deleted_emails": {
        "email_1_deleted": {
            "message_id": "<a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0@mail.example.com>",
            "deleted_from_folder": "Inbox",
            "subject": "Suspicious Login Alert - Deleted",
            "sender": "noreply@system.com",
            "timestamp": "2025-11-20T14:30:00Z"
        },
        "email_2_deleted": {
            "message_id": "<u1v2w3x4y5z6a7b8c9d0e1f2g3h4i5j6k7l8m9n0@mail.example.com>",
            "deleted_from_folder": "Spam",
            "subject": "Phishing Offer",
            "sender": "scam@badsite.net",
            "timestamp": "2025-11-15T09:15:00Z"
        }
    }
}
출력 메시지

이메일 삭제 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

NUMBER_OF_DELETED_EMAILS email(s) were deleted successfully

Failed to find emails for deletion!

 작업이 완료되었습니다.

Error deleting emails ERROR_REASON

작업이 실패했습니다.

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

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

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

DownloadEmailAttachments

이메일 첨부파일 다운로드 작업을 사용하여 특정 이메일에서 첨부파일을 가져와 Google SecOps 서버의 지정된 경로에 저장합니다.

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

작업 입력

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

매개변수 설명
Folder Name

필수 입력란입니다.

작업에서 이메일을 검색하는 사서함 폴더의 쉼표로 구분된 목록입니다.

기본값은 Inbox입니다.
Download Path

필수 입력란입니다.

다운로드한 첨부파일이 저장되는 Google SecOps 서버의 경로입니다.
Message IDs

(선택사항)

첨부파일을 다운로드할 메일 ID의 쉼표로 구분된 목록입니다.
Subject filter

(선택사항)

이메일 검색 범위를 좁히는 데 사용되는 제목입니다.

작업 출력

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

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

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

출력 메시지 메시지 설명

Downloaded NUMBER_OF_ATTACHMENTS attachments. ATTACHMENT_PATHS

 작업이 완료되었습니다.

failed to download email attachments, the error is: ERROR_REASON

작업이 실패했습니다.

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

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

스크립트 결과 이름 값
attachments_local_paths 저장된 첨부파일의 전체 경로를 쉼표로 구분한 문자열입니다.

이메일 전달

이메일 전달 작업을 사용하여 기존 이메일의 고유한 메시지 ID를 제공하여 이전 대화목록 콘텐츠를 포함한 기존 이메일을 새 수신자에게 보냅니다.

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

작업 입력

이메일 전달 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Folder Name

필수 입력란입니다.

원본 이메일이 있는 편지함 폴더입니다.

  • 여러 폴더를 확인하는 경우 쉼표로 구분된 목록을 제공합니다.
  • 폴더 이름은 IMAP 폴더와 정확히 일치해야 합니다.
  • 폴더 이름에 공백이 포함된 경우 큰따옴표로 묶어야 합니다.

기본값은 Inbox입니다.
Message ID of the email to forward

필수 입력란입니다.

작업이 전달하는 기존 이메일의 고유한 message_id입니다.
Recipients

필수 입력란입니다.

새 수신자의 기본 이메일 주소를 쉼표로 구분한 목록입니다.
CC

(선택사항)

참조 필드에 포함할 이메일 주소의 쉼표로 구분된 목록입니다.
BCC

(선택사항)

숨은참조 필드에 포함할 이메일 주소의 쉼표로 구분된 목록입니다.
Subject

필수 입력란입니다.

전달된 이메일의 제목입니다.
Content

(선택사항)

전달된 이메일에 포함할 추가 본문 콘텐츠입니다.
Return message id for the forwarded email

(선택사항)

선택하면 작업이 JSON 결과에서 새로 전달된 이메일의 고유한 메시지 ID를 반환합니다.

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

(선택사항)

추가 첨부파일의 서버에 있는 파일 경로의 쉼표로 구분된 목록입니다.

작업 출력

이메일 전달 작업은 다음 출력을 제공합니다.

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

다음 예시는 이메일 전달 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
   "Date"
   "message_id"
   "Recipient"
}
출력 메시지

이메일 전달 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Email was forwarded successfully.

Mail was forwarded successfully. Mail message ID is: MESSAGE_ID

 작업이 완료되었습니다.

Failed to forward the email! The Error is ERROR_REASON

작업이 실패했습니다.

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

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

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

이메일을 폴더로 이동

이메일을 폴더로 이동 작업을 사용하여 지정된 소스 폴더에서 사서함 내의 다른 대상 폴더로 이메일을 전송합니다.

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

작업 입력

Move Email to Folder 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Source Folder Name

필수 입력란입니다.

이메일을 이동할 소스 폴더의 이름입니다.
Destination Folder Name

필수 입력란입니다.

이메일이 이동되는 대상 폴더의 이름입니다.
Message IDs

(선택사항)

검색하고 이동할 특정 메일 ID를 쉼표로 구분한 목록입니다.

제공된 경우 이 목록은 Subject Filter를 재정의합니다.
Subject Filter

(선택사항)

일치하는 이메일의 검색 범위를 좁히는 데 사용되는 제목입니다.
Only Unread

(선택사항)

선택하면 검색 결과가 읽지 않은 이메일로만 제한됩니다.

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

작업 출력

이메일을 폴더로 이동 작업은 다음 출력을 제공합니다.

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

다음 예시는 이메일을 폴더로 이동 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "emails": {
        "email_1": {
            "message_id": "<4f1e50e8f4027d187a2385a39b83cde46e5b53c1@mail.example.com>",
            "received": "Mon, 24 Nov 2025 10:00:00 +0000",
            "sender": "security-alert@example.com",
            "recipients": "user@example.com",
            "subject": "Phishing Alert: Urgent Action Required",
            "plaintext_body": "Original alert content...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Quarantine"
        },
        "email_2": {
            "message_id": "<a5b6c7d8e9f01g2h3i4j5k6l7m8n9o0p1q2r3s4t@mail.example.com>",
            "received": "Sun, 23 Nov 2025 14:30:00 +0000",
            "sender": "noreply@system.com",
            "recipients": "user@example.com",
            "subject": "System Update Notification",
            "plaintext_body": "System update successful...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Archive"
        }
    }
}
출력 메시지

이메일을 폴더로 이동 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

NUMBER_OF_MOVED_EMAILS mails were successfully moved from SOURCE_FOLDER~ DESTINATION_FOLDER

No mails were found matching the search criteria!

 작업이 완료되었습니다.

Error search emails: ERROR_REASON

작업이 실패했습니다.

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

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

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

핑

Ping 작업을 사용하여 Email V2에 대한 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

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

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

Ping 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully connected to the email server server with the provided connection parameters!

 작업이 완료되었습니다.

Failed to connect to the IMAP server! Error is ERROR_REASON

Failed to connect to the SMTP server! Error is ERROR_REASON

SMTP (or IMAP) configuration is needed to execute action. Please configure STMP (or IMAP) on integration configuration page in Content Hub.

작업이 실패했습니다.

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

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

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

케이스에 이메일 첨부파일 저장

이메일 첨부파일을 케이스에 저장 작업을 사용하여 사서함의 특정 이메일에서 첨부파일을 검색하고 현재 케이스의 케이스 월에 자동으로 저장합니다.

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

작업 입력

이메일 첨부파일을 케이스에 저장 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Folder Name

필수 입력란입니다.

작업에서 이메일을 검색하는 사서함 폴더의 쉼표로 구분된 목록입니다.
Message ID

(선택사항)

첨부파일을 다운로드할 이메일의 고유 메시지 ID입니다.
Attachment To Save

(선택사항)

저장되는 첨부파일의 특정 이름입니다.

값을 제공하지 않으면 이 작업은 이메일의 모든 첨부파일을 케이스 월에 저장합니다.

작업 출력

이메일 첨부파일을 케이스에 저장 작업은 다음 출력을 제공합니다.

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

다음 예시에서는 케이스에 이메일 첨부파일 저장 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "saved_attachments_from_email": {
        "message_id": "<a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0@mail.example.com>",
        "subject": "Email with Malicious Attachment",
        "sender": "external@suspicious.com",
        "attachments_saved": [
            {
                "file_name": "Invoice_Q3_2025.pdf",
                "file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
                "saved_to_case_wall": "True"
            },
            {
                "file_name": "Report_Data.docx",
                "file_hash_md5": "b3e0c1a9f8d7c6b5a4e3d2c1b0a9f8e7",
                "saved_to_case_wall": "True"
            }
        ]
    }
}
출력 메시지

케이스에 이메일 첨부파일 저장 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully saved the following attachments from the email MESSAGE_ID: MESSAGE_INFO

 작업이 완료되었습니다.

Failed to save the email attachments to the case, the error is: ERROR_REASON

작업이 실패했습니다.

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

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

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

이메일 검색

이메일 검색 작업을 사용하여 다양한 필터링 기준을 통해 구성된 사서함 내에서 특정 이메일을 찾습니다.

이 작업은 JSON 파일에서 일치하는 메일에 대한 세부정보를 검색하며, 이는 후속 자동 또는 수동 분석에 사용될 수 있습니다.

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

작업 입력

이메일 검색 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Folder Name

필수 입력란입니다.

작업에서 이메일을 검색하는 편지함 폴더의 쉼표로 구분된 목록입니다.

기본값은 Inbox입니다.
Subject Filter

(선택사항)

일치하는 이메일의 검색 범위를 좁히는 데 사용되는 제목입니다.
Sender Filter

(선택사항)

일치하는 이메일을 검색하는 데 사용되는 발신자 주소입니다.
Recipient Filter

(선택사항)

일치하는 이메일을 검색하는 데 사용되는 수신자 주소입니다.
Time frame (minutes)

필수 입력란입니다.

검색에서 이메일을 되돌아보는 기간 (분)입니다.

기본값은 60입니다.
Only Unread

(선택사항)

선택하면 읽지 않은 이메일만 검색됩니다.

기본적으로 사용 중지됨
Max Emails To Return

필수 입력란입니다.

작업에서 결과로 반환하는 최대 이메일 수입니다.

기본값은 100입니다.

작업 출력

이메일 검색 작업은 다음 출력을 제공합니다.

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

다음 예시는 이메일 검색 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "emails": {
        "email_1": {
            "message id": "<CAJP=A_uGkttoWc1eahvP43rWVEsdk77nMu1FomhgRjRSmySLLg@mail.example.com>",
            "received": "Mon, 26 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "user@test.example",
            "recipients": "user1@example.com,user2@example.com",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "pdfdocument.pdf",
            "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        },
        "email_2": {
            "message id": "<WEAA=D_uGkttoWc1eahvP43rWVEsdk77nMu1FomhgRjRSmySLLg@mail.example.com>",
            "received": "Wen, 21 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "user@test.example",
            "recipients": "user3@example.com",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "photo.jpg",        "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
            "attachmment_2": "word_document.docx",
            "attachment_2_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        }
    }
}
출력 메시지

이메일 검색 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Search found NUMBER_OF_FOUND_EMAILS emails based on the provided search criteria

Search didn't found any matching emails

 작업이 완료되었습니다.

Search didn't completed successfully due to error: ERROR_REASON

작업이 실패했습니다.

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

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

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

이메일 보내기

이메일 보내기 작업을 사용하여 구성된 사서함에서 여러 수신자에게 이메일을 보냅니다.

이 작업은 선택적으로 메시지 ID를 반환하며, 이 ID는 사용자의 이메일 대기 작업에서 사용자 응답을 추적하고 플레이북 실행을 제어하는 데 사용할 수 있습니다.

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

작업 입력

이메일 보내기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Recipients

필수 입력란입니다.

기본 수신자 이메일 주소입니다.

여러 주소는 쉼표로 구분해야 합니다.
CC

(선택사항)

참조 (CC) 필드에 포함할 이메일 주소입니다.

여러 주소는 쉼표로 구분해야 합니다.
Bcc

(선택사항)

숨은참조 (Bcc) 필드에 포함할 이메일 주소입니다.

여러 주소는 쉼표로 구분해야 합니다.
Subject

필수 입력란입니다.

이메일 메시지의 제목입니다.
Content

필수 입력란입니다.

이메일 메시지의 본문 콘텐츠입니다.
Return message id for the sent email

(선택사항)

선택하면 작업이 JSON 결과에서 고유한 메시지 ID를 반환합니다.

이 ID는 사용자의 이메일 대기 작업에서 응답을 추적하는 데 사용할 수 있습니다.

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

(선택사항)

서버에 있는 첨부파일의 절대 파일 경로를 쉼표로 구분한 목록입니다.

작업 출력

이메일 보내기 작업은 다음 출력을 제공합니다.

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

다음 예시는 이메일 보내기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "message_id": "<4f1e50e8f4027d187a2385a39b83cde46e5b53c1-10013525-100078757@example.com>"
}
출력 메시지

이메일 보내기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Mail sent successfully.

Mail sent successfully. Mail message ID is: MESSAGE_ID

 작업이 완료되었습니다.

Execution Failed: ERROR_REASON

작업이 실패했습니다.

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

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

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

대화목록 답장 보내기

대화목록 답장 보내기 작업을 사용하여 원래 메일 ID를 사용하여 기존 이메일 대화목록 내에서 새 메일을 답장으로 보냅니다.

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

작업 입력

대화목록 답장 보내기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Message ID

필수 입력란입니다.

답장이 전송되는 메일의 고유 ID입니다.
Folder Name

필수 입력란입니다.

작업에서 원본 이메일을 검색하는 편지함 폴더의 쉼표로 구분된 목록입니다.

폴더 이름은 IMAP 폴더와 정확히 일치해야 합니다. 이름에 공백이 포함된 경우 큰따옴표로 묶어야 합니다 (예: '[Gmail]/All Mail').

기본값은 Inbox입니다.
Content

필수 입력란입니다.

답장 메시지의 본문 콘텐츠입니다.
Attachment Paths

(선택사항)

답장에 포함할 첨부파일의 서버에 있는 파일 경로를 쉼표로 구분한 목록입니다.
Reply All

(선택사항)

선택하면 원본 이메일 대화목록의 모든 수신자에게 답장이 전송됩니다.

이 매개변수는 Reply To보다 우선 적용됩니다.

기본적으로 사용 설정됩니다.
Reply To

(선택사항)

답장을 받을 특정 이메일 주소의 쉼표로 구분된 목록입니다.

Reply All가 사용 중지되어 있고 값이 제공되지 않으면 답장은 원본 이메일의 발신자에게만 전송됩니다.

작업 출력

스레드 답장 보내기 작업은 다음 출력을 제공합니다.

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

다음 예시는 대화목록 답장 보내기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "message_id": "<162556278608.14165.480701790user@example>",
    "recipients": "test@example.com"
}
출력 메시지

대화목록 답장 보내기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully sent reply to the message with ID MESSAGE_ID in Exchange.

 작업이 완료되었습니다.

Error executing action "Send Thread Reply". Reason: ERROR_REASON

작업이 실패했습니다.

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

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

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

사용자 이메일 기다리기

사용자의 이메일 대기 작업을 사용하여 플레이북 실행을 일시중지하고 이전에 이메일 전송 작업으로 전송된 메일에 대한 답장을 사서함에서 모니터링합니다.

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

작업 입력

사용자의 이메일 대기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Email Message_id

필수 입력란입니다.

작업에서 답장을 추적하는 전송된 이메일의 고유 메시지 ID입니다.

이메일 보내기 작업을 사용하여 메일을 보낸 경우 SendEmail.JSONResult.message_id를 자리표시자로 선택하세요.
Email Date

필수 입력란입니다.

원래 이메일이 전송된 시점을 나타내는 타임스탬프입니다. 작업은 이 값을 사용하여 답장 기간을 계산합니다.

이메일 보내기 작업을 사용하여 메시지를 보낸 경우 자리표시자 SendEmail.JSONResult.email_date를 사용합니다.
Email Recipients

필수 입력란입니다.

작업이 답장을 기다리는 수신자 이메일 주소의 쉼표로 구분된 목록입니다.

이메일 보내기 작업을 사용하여 메시지를 보낸 경우 자리표시자 SendEmail.JSONResult.email_date를 사용합니다.
Wait stage timeout (minutes)

(선택사항)

대기 단계를 시간 초과로 표시하기 전에 작업이 응답을 기다리는 시간 (분)입니다.

기본값은 1440입니다.
Wait for all recipients to reply?

(선택사항)

선택하면 플레이북이 모든 수신자의 응답을 기다린 후 진행됩니다. 그렇지 않으면 첫 번째 답장을 받은 후 진행됩니다.

기본적으로 사용 설정됩니다.
Wait stage exclude pattern

(선택사항)

특정 답장 (예: 자동 부재중 메시지)이 유효한 응답으로 간주되지 않도록 제외하는 데 사용되는 정규 표현식 패턴입니다.
Folder to check for reply

(선택사항)

작업이 사용자의 답장을 검색하는 편지함 폴더의 쉼표로 구분된 목록입니다.

이 매개변수는 대소문자를 구분합니다.

기본값은 Inbox입니다.
Fetch Response Attachments

(선택사항)

선택하면 수신자의 답장에 포함된 모든 첨부파일이 작업 결과의 첨부파일로 저장됩니다.

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

작업 출력

사용자의 이메일 기다리기 작업은 다음 출력을 제공합니다.

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

다음 예시에서는 사용자의 이메일 대기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "Responses":
    {[
     "user1@example.com": "Approved",
     "user2@example.com": "",
     "user3@example.com": ""
     ]}
}
스크립트 결과

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

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

커넥터

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

일반 IMAP 이메일 커넥터

일반 IMAP 이메일 커넥터를 사용하여 IMAP 메일에 주기적으로 연결하여 지정된 편지함에서 새 이메일을 확인합니다. 커넥터는 거의 실시간으로 새 이메일을 처리하여 Google SecOps 플랫폼 내에서 맥락에 맞는 알림 및 케이스로 변환합니다.

알려진 문제 및 제한사항

  1. Outlook 첨부파일 (.eml): 중요한 헤더가 누락된 경우 커넥터가 Microsoft Outlook에서 .eml 형식으로 변환된 첨부파일을 처리하지 못할 수 있습니다. Google SecOps는 여전히 이메일에 대한 알림을 만들지만 첨부파일을 기반으로 하는 이벤트는 없습니다. 다음 로그는 이 문제를 나타냅니다.

    Error Code 1: Encountered an email object with missing headers. Please
visit documentation portal for more details.

  2. 누락된 파일 이름: 이메일 헤더에 파일 이름이 없는 첨부된 메일 파일을 처리할 때 커넥터는 고유한 자리표시자 파일 이름인 Undefined_{UUID}.eml를 할당하여 첨부파일이 Google SecOps에서 이벤트로 표시되도록 합니다.

이메일 케이스 전달

Google SecOps는 이메일 서버와 통신하여 이메일을 검색하고 수집하며, 거의 실시간으로 번역 및 컨텍스트화를 위해 이메일을 플랫폼에 전달하여 보안 알림으로 표시합니다.

커넥터 규칙

  • 커넥터는 SSL/TLS를 사용하여 이메일 서버와의 암호화된 통신을 보장합니다.
  • 커넥터는 IMAP 및 IMAPS 트래픽 모두에 프록시를 사용하여 메일 서버에 연결하는 것을 지원합니다.
  • 커넥터를 사용하면 여러 편지함 폴더에서 이메일을 검색할 수 있습니다. Folder 매개변수는 쉼표로 구분된 대소문자를 구분하는 폴더 이름 목록을 허용합니다.
  • 커넥터는 유니코드 인코딩을 지원하므로 영어 이외의 언어로 전송된 이메일을 처리할 수 있습니다.

커넥터 입력

일반 IMAP 이메일 커넥터에는 다음 매개변수가 필요합니다.

매개변수 설명
Default Environment

(선택사항)

수집된 알림이 할당되는 환경의 이름입니다.
Run Every

(선택사항)

커넥터가 새 이메일을 확인하기 위해 실행되는 빈도입니다.

기본값은 00:00:10:00 (10분)입니다.
Product Field Name

필수 입력란입니다.

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

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

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

필수 입력란입니다.

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

기본값은 event_name_mail_type입니다.
Additional headers to extract from emails

(선택사항)

커넥터 처리 중에 이메일 메시지에서 추출할 커스텀 헤더 필드의 쉼표로 구분된 목록입니다.
Script Timeout (Seconds)

필수 입력란입니다.

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

기본값은 60입니다.
IMAP Server Address

필수 입력란입니다.

연결할 IMAP 서버의 IP 주소 또는 DNS 호스트 이름입니다.

기본값은 imap.gmail.com입니다.
IMAP Port

필수 입력란입니다.

IMAP 서버에 연결하는 데 사용되는 포트 번호입니다.

기본값은 993입니다.
Username

필수 입력란입니다.

커넥터가 이메일을 가져오는 편지함의 사용자 이름입니다.

기본값은 username입니다.
Password

필수 입력란입니다.

이메일을 가져오는 데 사용되는 편지함의 비밀번호입니다.

기본값은 1입니다.
Folder to check for emails

필수 입력란입니다.

커넥터가 이메일을 검색하는 편지함 폴더의 쉼표로 구분된 목록입니다.

이 매개변수는 대소문자를 구분합니다.

기본값은 Inbox입니다.
Server Time Zone

(선택사항)

메일 서버에 구성된 시간대입니다.

기본값은 UTC입니다.
Environment Regex Pattern

(선택사항)

이벤트 필드 데이터를 조작하고 환경 이름을 추출하는 데 사용되는 정규 표현식 패턴입니다.
IMAP USE SSL

(선택사항)

선택하면 커넥터가 SSL/TLS를 사용하여 메일 서버에 대한 보안 IMAP 연결을 설정합니다.

기본적으로 사용 설정됩니다.
Unread Emails Only

(선택사항)

선택하면 커넥터가 읽지 않은 이메일만 가져옵니다.

기본적으로 사용 설정됩니다.
Mark Emails as Read

(선택사항)

선택하면 커넥터에서 이메일을 가져온 후 읽음으로 표시됩니다.

기본적으로 사용 설정됩니다.
Attach Original EML

(선택사항)

선택하면 원본 메일이 생성된 알림에 .eml 파일로 첨부됩니다.

기본적으로 사용 중지됩니다.
Regex expressions to handle forwarded emails

(선택사항)

전달된 이메일에서 원래 제목, 발신자, 수신자 필드를 추출하는 정규 표현식 패턴이 포함된 JSON 한 줄 문자열입니다.
Exclusion Body Regex

(선택사항)

본문 콘텐츠가 패턴과 일치하는 경우 이메일을 수집에서 제외하는 데 사용되는 정규 표현식 패턴입니다(예: ([N|n]ewsletter)|([O|o]ut of office)).
Exclusion Subject Regex

(선택사항)

제목이 패턴과 일치하는 경우 이메일을 수집에서 제외하는 데 사용되는 정규 표현식 패턴입니다(예: ([N|n]ewsletter)|([O|o]ut of office)).
Offset Time In Days

필수 입력란입니다.

커넥터가 메일을 가져오는 최대 일수 (최대 기간)입니다.

이 값은 초기 실행 또는 커넥터 타임스탬프가 만료되는 경우의 대체 값으로도 사용되므로 사용 중지된 기간 동안 알림이 수집됩니다.

기본값은 5입니다.
Max Emails Per Cycle

필수 입력란입니다.

커넥터가 단일 폴링 주기에서 처리하는 최대 이메일 수입니다.

기본값은 10입니다.
Proxy Server Address

(선택사항)

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

(선택사항)

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

(선택사항)

프록시 서버 인증 비밀번호입니다.
Create a Separate Siemplify Alert per Attached Mail File?

(선택사항)

선택하면 커넥터가 메일 내에서 발견된 모든 첨부 이메일 파일에 대해 별도의 알림을 만듭니다.

이 기능은 이벤트 매핑이 첨부된 이메일 파일에서 항목을 만들도록 설정된 경우에 유용합니다.

기본적으로 사용 중지됩니다.
Original Received Mail Prefix

(선택사항)

모니터링되는 편지함에서 수신된 원본 이메일에서 추출된 키 (받는사람, 보낸사람, 제목 등)에 추가된 프리픽스 (예: orig)입니다.

기본값은 orig입니다.
Attached Mail File Prefix

(선택사항)

이메일 내에서 발견된 첨부된 메일 파일에서 추출된 키 (받는사람, 보낸사람, 제목 등)에 추가된 프리픽스 (예: attach)입니다.

기본값은 attach입니다.

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