Microsoft Graph Mail Delegated

이 문서에서는 Microsoft Graph Mail 위임과 Google Security Operations (Google SecOps)를 통합하는 방법을 설명합니다.

시작하기 전에

Google SecOps에서 Microsoft Graph Mail 위임 통합을 구성하기 전에 다음 단계를 완료하세요.

  1. Microsoft Entra 애플리케이션을 만듭니다.

  2. 애플리케이션의 API 권한을 구성합니다.

  3. 클라이언트 보안 비밀번호 만들기

  4. 갱신 토큰 생성

Microsoft Entra 애플리케이션 만들기

Microsoft Entra 앱을 만들려면 다음 단계를 완료하세요.

  1. 사용자 관리자 또는 비밀번호 관리자로 Azure 포털에 로그인합니다.

  2. Microsoft Entra ID를 선택합니다.

  3. 앱 등록 > 새 등록으로 이동합니다.

  4. 애플리케이션 이름을 입력합니다.

  5. 지원되는 적절한 계정 유형을 선택합니다.

  6. 다음 값을 사용하여 리디렉션 URI를 구성합니다.

    1. 플랫폼: Web

    2. 리디렉션 URL: http://localhost

  7. 등록을 클릭합니다.

  8. 애플리케이션 (클라이언트) ID 및 디렉터리 (테넌트) ID 값을 저장하여 통합 매개변수를 구성합니다.

API 권한 구성

통합의 API 권한을 구성하려면 다음 단계를 완료하세요.

  1. Azure 포털에서 API 권한 > 권한 추가로 이동합니다.

  2. Microsoft Graph > 애플리케이션 권한을 선택합니다.

  3. 권한 선택 섹션에서 다음 필수 권한을 선택합니다.

    • Mail.Read
    • Mail.ReadWrite
    • Mail.Send
    • User.Read
    • Directory.Read.All

  4. 권한 추가를 클릭합니다.

  5. ORGANIZATION_NAME에 대한 관리자 동의 허용을 클릭합니다.

    관리자 동의 부여 확인 대화상자가 표시되면 예를 클릭합니다.

클라이언트 보안 비밀번호 만들기

클라이언트 보안 비밀을 만들려면 다음 단계를 완료하세요.

  1. 인증서 및 보안 비밀 > 새 클라이언트 보안 비밀번호로 이동합니다.

  2. 클라이언트 보안 비밀번호에 대한 설명을 입력하고 만료 기한을 설정합니다.

  3. 추가를 클릭합니다.

  4. 통합을 구성할 때 클라이언트 보안 비밀번호 값 매개변수 값으로 사용할 클라이언트 보안 비밀번호 값 (보안 비밀번호 ID 아님)을 저장합니다. 클라이언트 보안 비밀번호 값은 한 번만 표시됩니다.

새로고침 토큰 생성

새로고침 토큰을 생성하려면 다음 단계를 완료하세요.

  1. 통합 매개변수 (Refresh Token 매개변수 제외)를 구성하고 저장합니다.

  2. 선택사항: Google SecOps에서 케이스를 시뮬레이션합니다.

  3. 승인 받기 작업을 실행합니다.

  4. 토큰 생성 작업을 실행합니다.

  5. Refresh Token 매개변수를 구성합니다.

선택사항: 케이스 시뮬레이션

갱신 토큰을 생성하려면 케이스에서 수동 작업을 실행하세요. Google SecOps 인스턴스가 새로 만들어졌고 기존 케이스가 없는 경우 케이스를 시뮬레이션합니다.

Google SecOps에서 케이스를 시뮬레이션하려면 다음 단계를 따르세요.

  1. 왼쪽 탐색 메뉴에서 케이스를 선택합니다.

  2. 케이스 페이지에서 추가 케이스 추가 > 케이스 시뮬레이션을 클릭합니다.

  3. 기본 케이스를 선택하고 만들기를 클릭합니다. 어떤 사례를 시뮬레이션하든 상관없습니다.

  4. 시뮬레이션을 클릭합니다.

    기본값이 아닌 환경이 있고 이를 사용하려면 올바른 환경을 선택하고 시뮬레이션을 클릭합니다.

  5. 케이스 탭에서 새로고침을 클릭합니다. 시뮬레이션한 케이스가 케이스 목록에 표시됩니다.

승인 가져오기 작업 실행

Get Authorization 작업을 수동으로 실행하려면 다음 단계를 완료하세요.

  1. 케이스 탭에서 케이스를 선택하거나 시뮬레이션된 케이스를 사용하여 케이스 보기를 엽니다.

  2. 케이스 보기에서 직접 조치를 클릭합니다.

  3. 직접 조치 검색 필드에 Microsoft Graph Mail Delegated를 입력합니다.

  4. Microsoft Graph Mail Delegated 통합 아래의 결과에서 Get Authorization을 선택합니다. 이 작업은 Microsoft Entra 애플리케이션에 대화형으로 로그인하는 데 사용되는 승인 링크를 반환합니다.

  5. 실행을 클릭합니다.

  6. 작업이 실행된 후 케이스의 케이스 월로 이동합니다. Microsoft Graph Mail Delegated_Get Authorization 작업 레코드에서 더보기를 클릭합니다. 승인 링크를 복사합니다.

  7. 시크릿 모드로 새 브라우저 창을 열고 생성된 승인 URL을 붙여넣습니다. Azure 로그인 페이지가 열립니다.

  8. 통합에 사용한 사용자 인증 정보로 로그인합니다. 로그인하면 브라우저에서 주소 표시줄에 코드가 있는 주소로 리디렉션됩니다.

    애플리케이션이 http://localhost로 리디렉션하므로 브라우저에 오류가 표시될 것으로 예상됩니다.

  9. 주소 표시줄에서 액세스 코드가 포함된 전체 URL을 복사합니다.

토큰 생성 작업 실행

Generate Token 작업을 수동으로 실행하려면 다음 단계를 완료하세요.

  1. 케이스 탭에서 케이스를 선택하거나 시뮬레이션된 케이스를 사용하여 케이스 보기를 엽니다.

  2. 케이스 보기 탭에서 직접 조치를 클릭합니다.

  3. 직접 조치 검색 필드에 Microsoft Graph Mail Delegated를 입력합니다.

  4. Microsoft Graph Mail Delegated 통합 아래의 결과에서 Generate Token을 선택합니다.

  5. Authorization URL 필드에 인증 가져오기 작업을 실행한 후 복사한 액세스 코드가 포함된 전체 URL을 붙여넣습니다.

  6. 실행을 클릭합니다.

  7. 작업이 실행된 후 케이스의 케이스 월로 이동합니다. Microsoft Graph Mail Delegated_Generate Token 작업 레코드에서 View More(더보기)를 클릭합니다.

  8. 생성된 갱신 토큰의 전체 값을 복사합니다.

새로고침 토큰 매개변수 구성

  1. Microsoft Graph 메일 위임 통합의 구성 대화상자로 이동합니다.

  2. 토큰 생성 작업에서 가져온 갱신 토큰 값을 갱신 토큰 필드에 입력합니다.

  3. 저장을 클릭합니다.

  4. 테스트를 클릭하여 구성이 올바른지, 통합이 예상대로 작동하는지 테스트합니다.

통합 매개변수

Microsoft Graph 메일 위임 통합에는 다음 매개변수가 필요합니다.
매개변수 설명
Microsoft Entra ID Endpoint

필수 항목입니다.

통합에서 사용할 Microsoft Entra ID 엔드포인트입니다.

테넌트 유형에 따라 값이 다를 수 있습니다.

기본값은 https://login.microsoftonline.com입니다.
Microsoft Graph Endpoint

필수 항목입니다.

통합에서 사용할 Microsoft Graph 엔드포인트입니다.

테넌트 유형에 따라 값이 다를 수 있습니다.

기본값은 https://graph.microsoft.com입니다.
Client ID

필수 항목입니다.

통합에 사용할 Microsoft Entra 애플리케이션의 클라이언트 (애플리케이션) ID입니다.
Client Secret Value

필수 항목입니다.

통합에 사용할 Microsoft Entra 애플리케이션의 클라이언트 보안 비밀번호 값입니다.
Microsoft Entra ID Directory ID

필수 항목입니다.

Microsoft Entra ID (테넌트 ID) 값입니다.
User Mailbox

필수 항목입니다.

통합에서 사용할 메일함입니다.
Refresh Token

필수 항목입니다.

인증에 사용되는 갱신 토큰입니다.
Redirect URL

필수 항목입니다.

Microsoft Entra ID 애플리케이션을 만들 때 구성한 리디렉션 URL입니다.

기본값은 http://localhost입니다.
Mail Field Source

필수 항목입니다.

선택하면 통합에서 사용자 세부정보 mail 속성에서 메일함 주소를 가져옵니다. 선택하지 않으면 통합에서 userPrincipalName 필드에서 메일함 주소를 가져옵니다.

기본적으로 선택되어 있습니다.
Verify SSL

필수 항목입니다.

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

기본적으로 선택되어 있습니다.
Base64 Encoded Private Key

(선택사항)

이메일을 복호화하는 데 사용될 base64 인코딩된 비공개 키를 지정합니다.
Base64 Encoded Certificate

(선택사항)

이메일을 복호화하는 데 사용될 base64로 인코딩된 인증서를 지정합니다.
Base64 Encoded CA certificate

(선택사항)

서명 확인을 위해 base64로 인코딩된 신뢰할 수 있는 CA 인증서를 지정합니다.

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

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

작업

작업을 구성하기 전에 통합에 필요한 권한을 제공하세요. 자세한 내용은 이 문서의 API 권한 구성 섹션을 참고하세요.

이메일 삭제

이메일 삭제 작업을 사용하여 메일함에서 하나 이상의 이메일을 삭제할 수 있습니다. 이 작업을 수행하면 검색 기준에 따라 이메일이 삭제됩니다. 적절한 권한이 있으면 이메일 삭제 작업을 통해 이메일을 다른 편지함으로 이동할 수 있습니다.

이 작업은 비동기식입니다. 필요에 따라 Google SecOps 통합 개발 환경 (IDE)에서 작업 제한 시간을 조정합니다.

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

작업 입력

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

매개변수 설명
Delete In Mailbox

필수 항목입니다.

삭제 작업을 실행할 기본 메일함입니다. 권한이 허용하는 경우 작업은 다른 메일함에서도 검색할 수 있습니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.
Folder Name

필수 항목입니다.

이메일을 검색할 메일함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).
Mail IDs

(선택사항)

특정 이메일 ID가 있는 이메일을 검색하는 필터 조건입니다.

이 파라미터는 검색할 이메일 ID의 쉼표로 구분된 목록을 허용합니다.

이 매개변수가 제공되면 검색에서 Subject Filter 및 Sender Filter 매개변수를 무시합니다.
Subject Filter

(선택사항)

검색할 이메일 제목을 지정하는 필터 조건입니다.
Sender Filter

(선택사항)

요청된 이메일의 발신자를 지정하는 필터 조건입니다.
Timeframe (Minutes)

(선택사항)

이메일을 검색할 기간(분)을 지정하는 필터 조건입니다.
Only Unread

(선택사항)

선택하면 작업에서 읽지 않은 이메일만 검색합니다.

기본적으로 선택되지 않습니다.
How many mailboxes to process in a single batch

(선택사항)

단일 배치 (메일 서버에 대한 단일 연결)에서 처리할 메일함 수입니다.

기본값은 25입니다.

작업 출력

다음 표에서는 이메일 삭제 작업과 관련된 출력 유형을 설명합니다.

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

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

출력 메시지 메시지 설명

Successfully deleted emails in the following mailboxes: MAILBOX_NAME: DELETED_EMAILS_NUMBER

Mailbox MAILBOX was not found.

 작업이 완료되었습니다.

Action was not able to find any emails based on the specified search criteria.

Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 이메일 삭제 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

이메일에서 첨부파일 다운로드

이메일에서 첨부파일 다운로드 작업을 사용하여 제공된 기준에 따라 이메일에서 첨부파일을 다운로드합니다.

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

이 작업은 비동기식입니다. 필요한 경우 Google SecOps IDE에서 스크립트 시간 제한 값을 조정합니다.

이 작업은 \` forward slash or/backslash characters in the names of the downloaded attachments with the_` 밑줄 문자를 대체합니다.

작업 입력

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

매개변수 설명
Search In Mailbox

필수 항목입니다.

검색 작업이 실행되는 기본 메일함입니다. 권한이 허용하는 경우 작업은 다른 메일함에서도 검색할 수 있습니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.
Folder Name

필수 항목입니다.

검색을 실행할 편지함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).
Download Destination

필수 항목입니다.

다운로드한 첨부파일을 저장할 스토리지 유형입니다.

기본적으로 이 작업은 첨부파일을 Cloud Storage 버킷에 저장하려고 시도합니다. 첨부파일을 로컬 파일 시스템에 저장하는 것은 대체 옵션입니다.

가능한 값은 GCP Bucket 및 Local File System입니다. 기본값은 GCP Bucket입니다.
Download Path

필수 항목입니다.

첨부파일을 다운로드할 경로입니다.

Cloud Storage 버킷 또는 로컬 파일 시스템에 첨부파일을 저장할 때 작업에서는 다운로드 경로를 Unix 형식(예: /tmp/test)으로 지정해야 합니다.
Mail IDs

(선택사항)

특정 이메일 ID가 있는 이메일을 검색하는 필터 조건입니다.

이 파라미터는 검색할 이메일 ID의 쉼표로 구분된 목록을 허용합니다.

이 매개변수가 제공되면 검색에서 Subject Filter 및 Sender Filter 매개변수를 무시합니다.
Subject Filter

(선택사항)

검색할 이메일 제목을 지정하는 필터 조건입니다.

이 필터는 contains 로직을 사용합니다.
Sender Filter

(선택사항)

요청된 이메일의 발신자를 지정하는 필터 조건입니다.

이 필터는 equals 로직을 사용합니다.
Download Attachments From EML

(선택사항)

선택하면 EML 파일에서 첨부파일을 다운로드합니다.

기본적으로 선택되지 않습니다.
Download attachments to unique path?

(선택사항)

선택하면 이전에 다운로드한 첨부파일이 덮어쓰이지 않도록 Download Path 매개변수 필드에 제공된 고유 경로에 첨부파일을 다운로드합니다.

기본적으로 선택되지 않습니다.
How many mailboxes to process in a single batch

(선택사항)

단일 배치 (메일 서버에 대한 단일 연결)에서 처리할 메일함 수입니다.

기본값은 25입니다.

작업 출력

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

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

다음 예에서는 이메일에서 첨부파일 다운로드 작업을 사용할 때 수신되는 JSON 결과 출력을 설명합니다.

[
    {
        "attachment_name": "name1.png",
        "downloaded_path": "file_path/name1.png"
    },
    {
        "attachment_name": "name2.png",
        "downloaded_path": "file_path/name2.png"
    }
]
출력 메시지

이메일에서 첨부파일 다운로드 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명

Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: PATHS.

Failed to find emails in MAILBOX with the following mail ids: EMAIL_IDS.

In the mailboxes listed below, emails were found, but there were no attachments to download. Affected mailboxes: MAILBOXES. Mail IDs without attachments to download: LIST_OF_EMAIL_IDS attachments.

 작업이 완료되었습니다.

Failed to find any emails using the provided criteria!

Failed to find any of the provided mailboxes: MAILBOXES

Action failed to run because the provided mailbox folder name FOLDER_NAME was not found in the mailbox MAILBOX개

Error executing action. Reason: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 이메일에서 첨부파일 다운로드 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

첨부된 EML에서 데이터 추출

첨부된 EML에서 데이터 추출 작업을 사용하여 이메일 EML 첨부파일에서 데이터를 가져와 작업 결과로 반환합니다. 이 작업은 .eml, .msg, .ics 파일 형식을 지원합니다.

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

작업 입력

첨부된 EML에서 데이터 추출 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Search In Mailbox

필수 항목입니다.

검색 작업이 실행되는 기본 메일함입니다. 권한이 허용하는 경우 작업은 다른 메일함에서도 검색할 수 있습니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.
Folder Name

(선택사항)

검색을 실행할 편지함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).
Mail IDs

필수 항목입니다.

특정 이메일 ID가 있는 이메일을 검색하는 필터 조건입니다.

이 파라미터는 검색할 이메일 ID의 쉼표로 구분된 목록을 허용합니다.
Regex Map JSON

(선택사항)

첨부된 이메일 파일에 적용하고 작업 JSON 결과에 추가 키 값을 생성하는 정규식이 포함된 JSON 정의입니다. 이 매개변수 값의 예는 다음과 같습니다.

{ips: \\b\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\b}

작업 출력

첨부된 EML에서 데이터 추출 작업은 다음 출력을 제공합니다.

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

다음 예에서는 첨부된 EML에서 데이터 추출 작업을 사용할 때 수신되는 JSON 결과 출력을 설명합니다.

[
    {
        "type": "EML",
        "subject": "examplesubject",
        "from": "sender@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.eml"
    },
    {
        "type": "MSG",
        "subject": "examplesubject",
        "from": "user@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>examplehtml</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.msg"
    },
    {
        "type": "ICS",
        "subject": "examplesubject",
        "from": "sender@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.ics"
    }
]
출력 메시지

첨부된 EML에서 데이터 추출 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명

Extracted data from ATTACHMENT_NAMES attached email files. Files: PATHS

Failed to find emails in MAILBOX with the following mail ids: MAIL_ID_LIST

 작업이 완료되었습니다.

Failed to find any emails using the provided criteria!

Failed to find any of the provided mailboxes: MAILBOX_LIST

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 첨부된 EML에서 데이터 추출 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

이메일 전달

이메일 전달 작업을 사용하여 이전 대화목록이 포함된 이메일을 전달합니다. 적절한 권한이 있으면 이 작업은 통합 구성에 지정된 것과 다른 메일함에서 이메일을 보낼 수 있습니다.

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

작업 입력

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

매개변수 설명
Send From

필수 항목입니다.

권한이 허용되는 경우 이메일을 보낼 선택적 이메일 주소입니다.

기본적으로 이메일은 통합 구성에 지정된 기본 메일함에서 전송됩니다.
Folder Name

(선택사항)

이메일을 검색할 메일함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).
Mail ID

필수 항목입니다.

전달할 이메일의 ID입니다.
Subject

필수 항목입니다.

이메일 제목입니다.
Send to

필수 항목입니다.

이메일 수신자의 이메일 주소를 쉼표로 구분한 목록입니다(예: user1@example.com, user2@example.com).
CC

(선택사항)

이메일 참조 필드의 이메일 주소를 쉼표로 구분한 목록입니다.

형식은 Send to 매개변수와 동일합니다.
BCC

(선택사항)

이메일 숨은참조 필드의 이메일 주소를 쉼표로 구분한 목록입니다.

형식은 Send to 매개변수와 동일합니다.
Attachments Paths

(선택사항)

서버에 저장된 파일 첨부파일의 경로를 쉼표로 구분한 목록입니다(예: /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg).
Mail content

필수 항목입니다.

이메일 본문입니다.

작업 출력

다음 표에서는 이메일 전달 작업과 연결된 출력 유형을 설명합니다.

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

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

출력 메시지 메시지 설명
Email with message ID MAIL_ID was forwarded successfully. 작업이 완료되었습니다.

Error executing action "Forward Email" because the provided mail id EMAIL_ID was not found.

Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX: MAILBOX_FOLDER

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 이메일 전달 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

토큰 생성

토큰 생성 작업을 사용하여 위임된 인증으로 통합 구성의 갱신 토큰을 가져옵니다. 승인 받기 작업에서 받은 승인 URL을 사용합니다.

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

처음으로 갱신 토큰을 생성한 후에는 작업이 자동으로 갱신 토큰을 갱신하고 유효하게 유지하도록 갱신 토큰 갱신 작업을 구성하고 활성화하는 것이 좋습니다.

작업 입력

토큰 생성 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Authorization URL

필수 항목입니다. Get Authorization 작업에서 받은 승인 URL입니다. 갱신 토큰을 요청하려면 URL이 필요합니다.

작업 출력

토큰 생성 작업은 다음 출력을 제공합니다.

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

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

출력 메시지 메시지 설명

Successfully fetched the refresh token: TOKEN_VALUE. Enter this token in the integration configuration to authenticate with delegated permissions on behalf of the user that performed the configuration steps. We recommend you to configure a Refresh Token Renewal Job after you generate the initial refresh token so the job automatically renews and keeps the token valid.

 작업이 완료되었습니다.

Failed to generate a token because the authorization URL that you provided is incorrect. The "code" parameter is missing. Make sure to copy the whole URL properly.

Failed to get the refresh token! Error is ERROR_REASON

Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON

작업이 실패했습니다.

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

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

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

승인 가져오기

승인 가져오기 작업을 사용하여 위임된 인증의 액세스 코드가 포함된 링크를 가져옵니다. 전체 링크를 복사하여 토큰 생성 작업에서 사용하여 갱신 토큰을 가져옵니다.

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

작업 입력

없음

작업 출력

인증 받기 작업은 다음 출력을 제공합니다.

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

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

출력 메시지 메시지 설명
Authorization URL generated successfully. To obtain a URL with access code, go to the link below as the user that you configured for the integration. Provide the URL with the access code in the Generate Token action. 작업이 완료되었습니다.

Failed to generate the authorization URL! Error is ERROR_REASON

Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON

작업이 실패했습니다.

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

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

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

Get Mailbox Account Out Of Facility Settings(시설 외부 편지함 계정 설정 가져오기)

Get Mailbox Account Out Of Facility Settings 작업을 사용하여 제공된 Google SecOps User 엔티티의 메일함 계정 부재중 (OOF) 설정을 가져옵니다.

Get Mailbox Account Out Of Facility Settings 작업은 Microsoft Graph API의 베타 버전을 사용합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

없음

작업 출력

Get Mailbox Account Out Of Facility Settings 작업은 다음 출력을 제공합니다.

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

다음 예는 Get Mailbox Account Out Of Facility Settings 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
   "@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/presences/$entity",
   "id": "ID",
   "availability": "Offline",
   "activity": "Offline",
   "statusMessage": null,
   "outOfOfficeSettings": {
       "message": "\n\nOut Of Facility111\n",
       "isOutOfOffice": true
   }
}
출력 메시지

Get Mailbox Account Out Of Facility Settings 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully returned OOF settings for ENTITY_ID.

Failed to find the following usernames in Office 365 service: USERNAME_LIST.

 작업이 완료되었습니다.

Error executing action "Add Identity Protection Detection Comment". Reason: ERROR_REASON

Action wasn't able to find OOF settings for ENTITY_ID.

작업이 실패했습니다.

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

다음 표에는 Get Mailbox Account Out Of Facility Settings 작업을 사용할 때 스크립트 결과 출력의 값이 나와 있습니다.

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

이메일을 정크로 표시

이메일을 정크 메일로 표시 작업을 사용하여 지정된 메일함에서 이메일을 정크 메일로 표시합니다. 이 작업을 수행하면 이메일 발신자가 차단된 발신자 목록에 추가되고 메일이 스팸 메일 폴더로 이동합니다.

이메일을 스팸으로 표시 작업은 Microsoft Graph API의 베타 버전을 사용합니다.

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

작업 입력

이메일을 스팸으로 표시 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Search In Mailbox

필수 항목입니다.

이메일을 검색할 편지함입니다.

기본적으로 이 작업은 통합 구성에 지정된 기본 메일함에서 이메일을 검색하려고 시도합니다. 다른 메일함에서 검색을 실행하려면 작업에 적절한 권한을 구성하세요.

이 매개변수는 쉼표로 구분된 문자열로 여러 값을 허용합니다.
Folder Name

필수 항목입니다.

이메일을 검색할 메일함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).

기본값은 Inbox입니다.
Mail IDs

필수 항목입니다.

스팸으로 표시할 메일의 ID 또는 internetMessageId 값입니다.

이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.

작업 출력

메일을 스팸으로 표시 작업은 다음 출력을 제공합니다.

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

이메일을 스팸으로 표시 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully marked the email as junk.

Failed to find email with ID ID in MAILBOX.

Mailbox MAILBOX was not found.

 작업이 완료되었습니다.

Error executing action "Mark Email as Junk". Reason: ERROR_REASON

Failed to find any emails based on provided parameters!

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.

작업이 실패했습니다.

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

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

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

이메일을 스팸 아님으로 표시

이메일을 정크 메일 아님으로 표시 작업을 사용하여 특정 편지함의 이메일을 정크 메일 아님으로 표시합니다. 이 작업을 수행하면 발신자가 차단된 발신자 목록에서 삭제되고 메일이 받은편지함 폴더로 이동합니다.

이메일을 스팸 아님으로 표시 작업은 Microsoft Graph API의 베타 버전을 사용합니다.

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

작업 입력

이메일을 스팸 아님으로 표시 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Search In Mailbox

필수 항목입니다.

이메일을 검색할 편지함입니다.

기본적으로 이 작업은 통합 구성에 지정된 기본 메일함에서 이메일을 검색하려고 시도합니다. 다른 메일함에서 검색을 실행하려면 작업에 적절한 권한을 구성하세요.

이 매개변수는 쉼표로 구분된 문자열로 여러 값을 허용합니다.
Folder Name

필수 항목입니다.

이메일을 검색할 메일함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).
Mail IDs

필수 항목입니다.

스팸으로 표시할 메일의 ID 또는 internetMessageId 값입니다.

이 매개변수는 쉼표로 구분된 문자열로 여러 값을 허용합니다.

작업 출력

메일을 스팸으로 표시 안 함 작업은 다음 출력을 제공합니다.

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

이메일을 스팸 아님으로 표시 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully marked the email as not junk.

Failed to find email with ID ID in MAILBOX.

Mailbox MAILBOX was not found.

 작업이 완료되었습니다.

Error executing action "Mark Email as Not Junk". Reason: ERROR_REASON

Failed to find any emails based on provided parameters!

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.

작업이 실패했습니다.

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

다음 표에는 이메일을 스팸으로 표시 안 함 작업을 사용할 때 스크립트 결과 출력의 값이 나와 있습니다.

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

이메일을 폴더로 이동

Move Email To Folder 작업을 사용하여 소스 이메일 폴더에서 사서함의 다른 폴더로 하나 이상의 이메일을 이동합니다. 적절한 권한이 있으면 이 작업으로 이메일을 통합 구성에 제공된 이메일 주소와 다른 이메일 주소로 이동할 수 있습니다.

이 작업은 비동기식입니다. 필요에 따라 Google SecOps 통합 개발 환경 (IDE)에서 작업 제한 시간을 조정합니다.

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

작업 입력

이메일을 폴더로 이동 작업을 구성하려면 다음 매개변수를 사용하세요.

매개변수 설명
Move In Mailbox

필수 항목입니다.

이동 작업이 실행되는 기본 편지함입니다. 권한이 허용하는 경우 작업은 다른 메일함에서도 검색할 수 있습니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.

Source Folder Name

필수 항목입니다.

이메일을 이동할 소스 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).
Destination Folder Name

필수 항목입니다.

이메일을 이동할 대상 폴더입니다.

Inbox/folder_name/subfolder_name 형식으로 매개변수 값을 제공합니다. 이 매개변수는 대소문자를 구분하지 않습니다.
Mail IDs

(선택사항)

특정 이메일 ID가 있는 이메일을 검색하는 필터 조건입니다.

이 파라미터는 검색할 이메일 ID의 쉼표로 구분된 목록을 허용합니다.

이 매개변수가 제공되면 검색에서 Subject Filter 및 Sender Filter 매개변수를 무시합니다.
Subject Filter

(선택사항)

검색할 이메일 제목을 지정하는 필터 조건입니다.

이 필터는 contains 로직을 사용합니다.
Sender Filter

(선택사항)

요청된 이메일의 발신자를 지정하는 필터 조건입니다.

이 필터는 equals 로직을 사용합니다.
Timeframe (Minutes)

(선택사항)

이메일을 검색할 기간(분)을 지정하는 필터 조건입니다.
Only Unread

(선택사항)

선택하면 작업에서 읽지 않은 이메일만 검색합니다.

기본적으로 선택되지 않습니다.
How many mailboxes to process in a single batch

(선택사항)

단일 배치 (메일 서버에 대한 단일 연결)에서 처리할 메일함 수입니다.

기본값은 25입니다.

작업 출력

다음 표에서는 이메일을 폴더로 이동 작업과 관련된 출력 유형을 설명합니다.

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

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

출력 메시지 메시지 설명

Successfully moved emails in the following mailboxes: MAILBOX: MOVED_EMAILS_NUMBER

Mailbox MAILBOX was not found.

 작업이 완료되었습니다.

Action was not able to find any emails based on the specified search criteria.

Action failed to move any emails because the provided source folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Action failed to move any emails because the provided destination folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 이메일을 폴더로 이동 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

핑

Ping 작업을 사용하여 Microsoft Graph 메일 서비스에 대한 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

다음 표에서는 Ping 작업과 관련된 출력 유형을 설명합니다.

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

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

출력 메시지 메시지 설명
Successfully connected to the Microsoft Graph mail service with the provided connection parameters! 작업이 완료되었습니다.
Failed to connect to the Microsoft Graph mail service! Error is ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 Ping 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

Microsoft 검색 쿼리 실행

Microsoft 검색 쿼리 실행 작업을 사용하여 Microsoft 검색 엔진을 사용한 검색을 실행합니다. 검색에서는 지정한 기본 또는 고급 쿼리를 사용합니다. Microsoft 검색에 대한 자세한 내용은 Microsoft Graph의 Microsoft 검색 API 개요를 참고하세요.

엔티티 범위에 따라 Microsoft 검색 쿼리 실행 작업을 사용하려면 추가 권한을 구성해야 할 수 있습니다. 특정 엔티티 유형에 필요한 권한에 대한 자세한 내용은 Microsoft Search API를 사용하여 데이터 쿼리를 참고하세요. 통합 권한을 구성하는 방법에 관한 자세한 내용은 API 권한 구성을 참고하세요.

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

작업 입력

Microsoft 검색 쿼리 실행 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Entity Types To Search

(선택사항)

검색 응답에 예상되는 리소스 유형의 쉼표로 구분된 목록입니다.

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

  • acronym
  • bookmark
  • chatMessage
  • drive
  • driveItem
  • event
  • externalItem
  • list
  • listItem
  • message
  • person
  • site
Fields To Return

(선택사항)

검색 응답에 반환할 필드입니다. 이 매개변수를 구성하지 않으면 작업에서 사용 가능한 모든 필드를 반환합니다.
Search Query

(선택사항)

검색을 실행할 쿼리입니다. 검색어 예시에 대한 자세한 내용은 Microsoft Search API를 사용하여 Outlook 메시지 검색을 참고하세요.
Max Rows To Return

(선택사항)

작업에서 반환할 최대 행 수입니다. 이 매개변수를 구성하지 않으면 작업에서 기본값을 사용합니다.

기본값은 25입니다.
Advanced Query

(선택사항)

다른 작업 매개변수로 검색 쿼리를 구성하는 대신 사용할 전체 검색 페이로드입니다. 검색 페이로드를 JSON 문자열로 포맷합니다. 이 매개변수를 구성하면 작업에서 다른 모든 매개변수를 무시합니다.

작업 출력

Microsoft 검색 쿼리 실행 작업은 다음 출력을 제공합니다.

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

Microsoft 검색 쿼리 실행 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully retrieved results for the provided search query.

No results found for the provided query.

 작업이 완료되었습니다.

Failed to construct a search query based on the provided parameters. Please check, if you specified all parameters properly.

Failed to run the search because the API doesn't support the provided combination of entities. See Microsoft documentation for supported entity combinations - URL. The error is ERROR_REASON

Failed to run the search as the provided advanced search query is invalid! Error is ERROR_REASON

Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON

작업이 실패했습니다.

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

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

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

이메일을 케이스에 저장

Save Email To The Case(케이스에 이메일 저장) 작업을 사용하여 이메일 또는 이메일 첨부파일을 Google SecOps 케이스 월에 저장합니다. 적절한 권한이 있으면 이 작업을 통해 통합 구성에 제공된 사서함이 아닌 다른 사서함의 이메일을 저장할 수 있습니다.

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

작업 입력

Save Email To The Case 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Search In Mailbox

필수 항목입니다.

검색 작업이 실행되는 기본 메일함입니다. 권한이 허용하는 경우 작업은 다른 메일함에서도 검색할 수 있습니다.
Folder Name

(선택사항)

이메일을 검색할 메일함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).
Mail ID

필수 항목입니다.

검색할 이메일 ID의 쉼표로 구분된 목록입니다.

이메일 보내기 작업을 사용하여 이메일을 보낸 경우 매개변수 값을 {SendEmail.JSONResult|id} 또는 {SendEmail.JSONResult|internetMessageId} 자리표시자로 설정합니다.
Save Only Email Attachments

(선택사항)

선택하면 지정된 이메일의 첨부파일만 저장됩니다.

기본적으로 선택되지 않습니다.
Attachment To Save

(선택사항)

Save Only Email Attachments 매개변수를 선택하면 이 매개변수로 지정된 첨부파일만 작업에서 저장합니다.

이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.
Base64 Encode

(선택사항)

선택하면 이메일 파일을 base64 형식으로 인코딩합니다.

기본적으로 선택되지 않습니다.

작업 출력

다음 표에서는 이메일을 케이스에 저장 작업과 관련된 출력 유형을 설명합니다.

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

다음 첨부파일은 케이스에 이메일 저장 작업과 연결되어 있습니다.

  • EMAIL_SUBJECT.eml: 작업에서 이메일을 저장하는 경우

  • 작업에서 첨부파일을 저장하는 경우 첨부파일 이름에 파일 확장자가 포함됩니다(있는 경우).

JSON 결과

다음 예에서는 이메일을 케이스에 저장 작업을 사용할 때 수신되는 JSON 결과 출력을 설명합니다.

{
    "id": "ID",
    "createdDateTime": "2024-02-16T14:10:34Z",
    "eml_info": "example_info",
    "lastModifiedDateTime": "2024-02-16T14:10:41Z",
    "changeKey": "cxsdjjh",
    "categories": [],
    "receivedDateTime": "2024-02-16T14:10:35Z",
    "sentDateTime": "2024-02-16T14:09:36Z",
    "hasAttachments": true,
    "internetMessageId": "INTERNET_MESSAGE_ID",
    "subject": "all attachments",
    "bodyPreview": "all the attachments",
    "importance": "normal",
    "parentFolderId": "PARENT_FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "example-index",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com/",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "<html><head>example-html</head></html>"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
        "flagStatus": "notFlagged"
    }
}
출력 메시지

케이스 월에서 이메일을 케이스에 저장 작업은 다음과 같은 출력 메시지를 제공합니다.

출력 메시지 메시지 설명

Email successfully saved!

Successfully saved the following attachments: ATTACHMENTS_LIST

The following attachments were not found in email with mail id: EMAIL_ID: ATTACHMENTS_LIST

 작업이 완료되었습니다.

Mailbox MAILBOX_NAME was not found.

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX_NAME

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 Save Email To The Case 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

이메일 검색

이메일 검색 작업을 사용하여 제공된 검색 기준에 따라 기본 메일함에서 이메일 검색을 실행합니다. 적절한 권한이 있으면 이 작업으로 다른 메일함에서 검색을 실행할 수 있습니다.

이 작업은 비동기식입니다. 필요에 따라 Google SecOps IDE에서 작업 제한 시간을 조정합니다.

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

작업 입력

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

매개변수 설명
Search In Mailbox

필수 항목입니다.

검색 작업이 실행되는 기본 메일함입니다. 권한이 허용하는 경우 작업은 다른 메일함에서도 검색할 수 있습니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.

상당수의 메일함에 대해 복잡한 검색을 실행하려면 Exchange 확장 프로그램 팩 통합을 사용하세요.
Folder Name

필수 항목입니다.

이메일을 검색할 편지함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).
Subject Filter

(선택사항)

검색할 이메일 제목을 지정하는 필터 조건입니다.

이 필터는 contains 로직을 사용합니다.
Sender Filter

(선택사항)

요청된 이메일의 발신자를 지정하는 필터 조건입니다.

이 필터는 equals 로직을 사용합니다.
Timeframe (Minutes)

(선택사항)

이메일을 검색할 기간(분)을 지정하는 필터 조건입니다.
Max Emails To Return

(선택사항)

작업에서 반환할 이메일 수입니다.

값을 설정하지 않으면 API 기본값이 사용됩니다.

기본값은 10입니다.
Only Unread

(선택사항)

선택하면 작업에서 읽지 않은 이메일만 검색합니다.

기본적으로 선택되지 않습니다.
All Fields To Return

(선택사항)

선택하면 작업에서 획득한 이메일에 대해 사용 가능한 모든 필드를 반환합니다.

기본적으로 선택되지 않습니다.
How many mailboxes to process in a single batch

(선택사항)

단일 배치 (메일 서버에 대한 단일 연결)에서 처리할 메일함 수입니다.

기본값은 25입니다.

작업 출력

다음 표에서는 이메일 검색 작업과 연결된 출력 유형을 설명합니다.

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

케이스 월에서 이메일 검색 작업을 수행하면 다음 표가 제공됩니다.

표 제목: 일치하는 메일

열:

  • 메일 ID
  • 제목
  • 발신자
  • 수신기
  • 수신일
출력 메시지

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

Action was not able to find any emails based on the specified search criteria.

출력 메시지 메시지 설명

Successfully found emails in the following mailboxes: MAILBOX: FOUND_EMAILS_NUMBER

Mailbox MAILBOX was not found.

 작업이 완료되었습니다.

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 이메일 검색 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

이메일 보내기

이메일 보내기 작업을 사용하여 특정 사서함에서 임의의 수신자 목록으로 이메일을 보냅니다.

이 작업은 일반 텍스트 또는 HTML 형식의 이메일을 보낼 수 있습니다. 적절한 권한이 있으면 작업에서 통합 구성에 지정된 사서함이 아닌 다른 사서함에서 이메일을 보낼 수 있습니다.

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

작업 입력

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

매개변수 설명
Send From

필수 항목입니다.

권한이 허용되는 경우 이메일을 보낼 선택적 이메일 주소입니다.

기본적으로 이 작업은 통합 구성에 지정된 기본 메일함에서 이메일을 보냅니다.
Subject

필수 항목입니다.

이메일 제목입니다.
Send to

필수 항목입니다.

이메일 수신자의 이메일 주소를 쉼표로 구분한 목록입니다(예: user1@example.com, user2@example.com).
CC

(선택사항)

이메일 참조 필드의 이메일 주소를 쉼표로 구분한 목록입니다.

형식은 Send to 매개변수와 동일합니다.
BCC

(선택사항)

이메일 숨은참조 필드의 이메일 주소를 쉼표로 구분한 목록입니다.

형식은 Send to 매개변수와 동일합니다.
Attachments Paths

(선택사항)

서버에 저장된 파일 첨부파일의 경로를 쉼표로 구분한 목록입니다(예: /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg).
Attachments Location

필수 항목입니다.

첨부파일이 저장되는 위치입니다.

기본적으로 이 작업은 Cloud Storage 버킷에서 첨부파일을 업로드하려고 시도합니다.

가능한 값은 GCP Bucket 또는 Local File System입니다. 기본값은 GCP Bucket입니다.
Mail Content Type

(선택사항)

이메일 콘텐츠의 유형입니다.

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

  • Text
  • HTML

기본값은 Text입니다.
Mail Content

필수 항목입니다.

이메일 본문입니다.
Reply-To Recipients

(선택사항)

Reply-To 헤더에 사용할 수신자의 쉼표로 구분된 목록입니다.

답장 대상 헤더를 사용하여 답장 이메일을 보낸사람 필드의 발신자 주소 대신 지정된 이메일 주소로 리디렉션합니다.

작업 출력

다음 표에서는 이메일 보내기 작업과 연결된 출력 유형을 설명합니다.

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

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

출력 메시지 메시지 설명

Email was sent successfully.

 작업이 완료되었습니다.

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 이메일 보내기 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

이메일 HTML 보내기

이메일 HTML 보내기 작업을 사용하여 특정 사서함에서 Google SecOps HTML 템플릿을 사용하는 이메일을 임의의 수신자 목록으로 보냅니다. 적절한 권한이 있으면 이 작업은 기본 메일함이 아닌 다른 메일함에서 이메일을 보낼 수 있습니다.

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

작업 입력

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

매개변수 설명
Send From

필수 항목입니다.

권한이 허용되는 경우 이메일을 보낼 선택적 이메일 주소입니다.

기본적으로 이 작업은 통합 구성에 지정된 기본 메일함에서 이메일을 보냅니다.
Subject

필수 항목입니다.

이메일 제목입니다.
Send to

필수 항목입니다.

이메일 수신자의 이메일 주소를 쉼표로 구분한 목록입니다(예: user1@example.com, user2@example.com).
CC

(선택사항)

이메일 참조 필드의 이메일 주소를 쉼표로 구분한 목록입니다.

형식은 Send to 매개변수와 동일합니다.
BCC

(선택사항)

이메일 숨은참조 필드의 이메일 주소를 쉼표로 구분한 목록입니다.

형식은 Send to 매개변수와 동일합니다.
Attachments Paths

(선택사항)

제공할 첨부파일의 전체 경로입니다(예: /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg).

쉼표로 구분된 문자열로 여러 값을 제공할 수 있습니다.
Email HTML Template

필수 항목입니다.

사용할 HTML 템플릿의 유형입니다.

가능한 값은 Email HTML Template 및 Dynamically generated list of available templates입니다.

기본값은 Email HTML Template입니다.
Mail Content

필수 항목입니다.

이메일 본문입니다.
Reply-To Recipients

(선택사항)

Reply-To 헤더에 사용할 수신자의 쉼표로 구분된 목록입니다.

답장 대상 헤더를 사용하여 답장 이메일을 보낸사람 필드에 명시된 발신자의 주소 대신 특정 이메일 주소로 리디렉션합니다.
Attachment Location

필수 항목입니다.

첨부파일이 저장되는 위치입니다.

기본적으로 이 작업은 Cloud Storage 버킷에서 첨부파일을 업로드하려고 시도합니다.

가능한 값은 GCP Bucket 또는 Local File System입니다. 기본값은 GCP Bucket입니다.

작업 출력

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

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

다음 예에서는 이메일 HTML 보내기 작업을 사용할 때 수신되는 JSON 결과 출력을 설명합니다.

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "example-key",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "outlook.com",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "ID",
    "conversationId": "ID",
    "conversationIndex": "INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}
출력 메시지

케이스 월에서 이메일 HTML 보내기 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명
Email was sent successfully. 작업이 완료되었습니다.

Action failed to run because the HTML template was not specified.

Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 이메일 HTML 보내기 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

대화목록 답장 보내기

Send Thread Reply(대화목록 답장 보내기) 작업을 사용하여 이메일 대화목록에 대한 답장으로 메시지를 보냅니다. 적절한 권한이 있으면 통합 구성에 지정된 사서함이 아닌 다른 사서함에서 이메일을 보낼 수 있습니다.

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

작업 입력

Send Thread Reply 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Send From

필수 항목입니다.

권한이 허용되는 경우 이메일을 보낼 선택적 이메일 주소입니다.

기본적으로 이 작업은 통합 구성에 지정된 기본 메일함에서 이메일을 보냅니다.
Mail ID

필수 항목입니다.

검색할 이메일 ID입니다.
Folder Name

(선택사항)

이메일을 검색할 메일함 폴더입니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).

기본값은 Inbox입니다.
Attachments Paths

(선택사항)

서버에 저장된 파일 첨부파일의 경로를 쉼표로 구분한 목록입니다(예: /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg).
Mail Content

필수 항목입니다.

이메일 본문입니다.
Reply All

(선택사항)

선택하면 이 작업은 원본 이메일과 관련된 모든 수신자에게 답장을 보냅니다.

기본적으로 선택되지 않습니다.

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

(선택사항)

답장을 보낼 이메일을 쉼표로 구분한 목록입니다.

값을 제공하지 않고 Reply All 체크박스가 선택 해제되어 있으면 작업에서 원래 이메일 발신자에게만 답장을 보냅니다.

Reply All 체크박스를 선택하면 작업에서 이 매개변수를 무시합니다.
Attachments Location

필수 항목입니다.

첨부파일이 저장되는 위치입니다.

기본적으로 이 작업은 Cloud Storage 버킷에서 첨부파일을 업로드하려고 시도합니다.

가능한 값은 GCP Bucket 또는 Local File System입니다. 기본값은 GCP Bucket입니다.

작업 출력

다음 표에서는 Send Thread Reply 작업과 연결된 출력 유형을 설명합니다.

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

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

출력 메시지 메시지 설명
Successfully sent reply to the mail with ID: EMAIL_ID 작업이 완료되었습니다.
Error executing action "Send Thread Reply". Reason: if you want to send a reply only to your own email address, you need to work with "Reply To" parameter.

작업이 실패했습니다.

Reply To 매개변수 값을 확인합니다.

Error executing action "Send Thread Reply" because the provided mail id EMAIL_ID was not found.

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 Send Thread Reply(스레드 답장 보내기) 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

투표 이메일 보내기

투표 이메일 보내기 작업을 사용하여 미리 정의된 답변 옵션이 포함된 이메일을 보냅니다. 이 작업은 Google SecOps HTML 템플릿을 사용하여 이메일을 서식 지정합니다. 적절한 권한이 있으면 투표 이메일 보내기 작업을 통해 기본 편지함이 아닌 다른 편지함에서 이메일을 보낼 수 있습니다.

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

작업 입력

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

매개변수 설명
Send From

필수 항목입니다.

권한이 허용되는 경우 이메일을 보낼 선택적 이메일 주소입니다.

기본적으로 이 작업은 통합 구성에 지정된 기본 메일함에서 이메일을 보냅니다.
Subject

필수 항목입니다.

이메일 제목입니다.
Send to

필수 항목입니다.

이메일 수신자의 이메일 주소를 쉼표로 구분한 목록입니다(예: user1@example.com, user2@example.com).
CC

(선택사항)

이메일 참조 필드의 이메일 주소를 쉼표로 구분한 목록입니다.

형식은 Send to 매개변수와 동일합니다.
BCC

(선택사항)

이메일 숨은참조 필드의 이메일 주소를 쉼표로 구분한 목록입니다.

형식은 Send to 매개변수와 동일합니다.
Attachments Paths

(선택사항)

제공할 첨부파일의 전체 경로입니다(예: /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg).

쉼표로 구분된 문자열로 여러 값을 제공할 수 있습니다.
Email HTML Template

필수 항목입니다.

사용할 HTML 템플릿의 유형입니다.

가능한 값은 Email HTML Template 및 Dynamically generated list of available templates입니다.

기본값은 Email HTML Template입니다.
Reply-To Recipients

(선택사항)

Reply-To 헤더에 사용할 수신자의 쉼표로 구분된 목록입니다.

Reply-To 헤더를 사용하여 답장 이메일을 From 필드에 명시된 발신자의 주소 대신 지정된 이메일 주소로 리디렉션합니다.
Structure of voting options

필수 항목입니다.

수신자에게 전송할 투표의 구조입니다.

가능한 값은 Yes/No 또는 Approve/Reject입니다. 기본값은 Yes/No입니다.

Attachment Location

필수 항목입니다.

첨부파일이 저장되는 위치입니다.

기본적으로 이 작업은 Cloud Storage 버킷에서 첨부파일을 업로드하려고 시도합니다.

가능한 값은 GCP Bucket 또는 Local File System입니다. 기본값은 GCP Bucket입니다.

작업 출력

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

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

다음 예에서는 투표 이메일 보내기 작업을 사용할 때 수신되는 JSON 결과 출력을 설명합니다.

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "KEY",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "<example-message-ID>",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "CONVERSATION_INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}
출력 메시지

케이스 월에서 투표 이메일 보내기 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명
Email was sent successfully. 작업이 완료되었습니다.

Action failed to run because the HTML template was not specified.

Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 투표 이메일 보내기 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

사용자 이메일 대기

이메일 보내기 작업을 사용하여 보낸 이메일을 기반으로 사용자의 응답을 기다리려면 사용자의 이메일 대기 작업을 사용하세요.

이 작업은 비동기식입니다. 필요에 따라 Google SecOps IDE에서 작업 제한 시간을 조정합니다.

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

작업 입력

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

매개변수 설명
Mail ID

필수 항목입니다.

이메일의 ID입니다.

이메일 보내기 작업을 사용하여 이메일을 보낸 경우 매개변수 값을 {SendEmail.JSONResult|id} 또는 {SendEmail.JSONResult|internetMessageId} 자리표시자로 설정합니다.
Wait for All Recipients To Reply?

(선택사항)

선택하면 작업은 시간 제한에 도달하거나 첫 번째 답장을 진행할 때까지 모든 수신자의 응답을 기다립니다.

기본적으로 선택되어 있습니다.
Wait Stage Exclude Pattern

(선택사항)

대기 단계에서 특정 답글을 제외하는 정규 표현식입니다. 이 매개변수는 이메일 본문과 함께 작동합니다.

예를 들어 Out of Office.* 정규 표현식을 구성하면 작업에서 자동 부재중 메시지를 수신자 답장으로 간주하지 않고 실제 사용자의 답장을 기다립니다.
Folder To Check For Reply

(선택사항)

사용자 답장을 검색할 편지함 이메일 폴더입니다. 검색은 질문이 포함된 이메일이 전송된 편지함에서 실행됩니다.

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

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

(선택사항)

선택되어 있고 수신자 답장에 첨부파일이 포함된 경우 이 작업은 답장을 가져와 작업 결과에 첨부파일로 추가합니다.

기본적으로 선택되지 않습니다.

작업 출력

다음 표에서는 사용자의 이메일 대기 작업과 관련된 출력 유형을 설명합니다.

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

다음 케이스 월 첨부파일은 사용자의 메일 대기 작업과 연결되어 있습니다.

유형: 항목

첨부파일 콘텐츠: 제목, 파일 이름 (확장자 포함, 있는 경우), fileContent

  • 제목: RECIPIENT_EMAIL 답장 첨부파일
  • 파일 이름: ATTACHMENT_FILENAME + FILE_EXTENSION
  • fileContent: CONTENT_OF_THE_ATTACHED_FILE
케이스 월 테이블

사용자로부터 메일 대기 작업은 다음 표를 생성할 수 있습니다.

표 제목: 일치하는 메일

열:

  • 메일 ID
  • 수신일
  • 발신자
  • 수신자
  • 제목
출력 메시지

사용자로부터 메일 대기 작업은 다음과 같은 출력 메시지를 제공합니다.

출력 메시지 메시지 설명

Found the user EMAIL_RECIPIENT reply: USER_REPLY

Timeout getting reply from user: EMAIL_RECIPIENT.

 작업이 완료되었습니다.

Action failed to receive any replies until timeout.

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 사용자로부터 이메일 대기 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

투표 이메일 결과 대기

투표 이메일 결과 대기 작업을 사용하여 투표 이메일 보내기 작업을 사용하여 보낸 투표 이메일을 기반으로 사용자 응답을 기다립니다.

이 작업은 비동기식입니다. 필요에 따라 Google SecOps IDE에서 작업 제한 시간을 조정합니다.

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

작업 입력

투표 결과 이메일 대기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Vote Mail Sent From

필수 항목입니다.

투표 이메일 보내기 작업에서 이메일을 보낸 메일함입니다.

기본값은 통합 구성에서 지정한 메일함입니다.

선택적으로 투표 메일이 다른 메일함에서 전송되는 경우 이 매개변수에 다른 값을 설정할 수 있습니다.
Mail ID

필수 항목입니다.

이메일의 ID입니다.

Send Vote Email 작업을 사용하여 이메일을 보내는 경우 매개변수 값을 SendVoteEmail.JSONResult|id 또는 SendEmail.JSONResult|internetMessageId 자리표시자로 설정합니다.

이메일 ID를 반환하려면 이메일 검색 작업을 사용하면 됩니다.
Wait for All Recipients To Reply?

(선택사항)

선택하면 작업은 시간 제한에 도달하거나 첫 번째 답장을 진행할 때까지 모든 수신자의 응답을 기다립니다.

기본적으로 선택되어 있습니다.
Wait Stage Exclude Pattern

(선택사항)

대기 단계에서 특정 답글을 제외하는 정규 표현식입니다.

이 매개변수는 이메일 본문과 함께 작동합니다.

예: 자동 부재중 메시지는 수신자 답장으로 간주되지 않으며 실제 사용자 답장을 기다립니다.
Folder To Check For Reply

(선택사항)

사용자의 답장을 검색할 편지함 이메일 폴더입니다. 검색은 질문이 포함된 이메일이 전송된 편지함에서 실행됩니다.

이 매개변수는 여러 폴더에서 사용자 응답을 확인할 폴더의 쉼표로 구분된 목록을 허용합니다.

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

기본값은 Inbox입니다.
Folder To Check For Sent Mail

(선택사항)

보낸 메일을 검색할 메일함 폴더입니다. 질문이 포함된 이메일을 보낸 편지함입니다.

이 매개변수는 여러 폴더에서 사용자 응답을 확인할 폴더의 쉼표로 구분된 목록을 허용합니다.

이 매개변수는 대소문자를 구분합니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).

기본값은 Sent Items입니다.
Fetch Response Attachments

(선택사항)

이 옵션을 선택하고 수신자 답장에 첨부파일이 포함된 경우 이 작업은 답장을 가져와 케이스 월에 첨부파일로 추가합니다.

기본적으로 선택되지 않습니다.

작업 출력

Wait For Vote Email Results 작업은 다음 출력을 제공합니다.

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

다음 케이스 월 첨부파일은 투표 결과 대기 이메일 작업과 연결되어 있습니다.

유형: 항목

첨부파일 콘텐츠: 제목, 파일 이름 (확장자 포함, 있는 경우), fileContent

  • 제목: RECIPIENT_EMAIL 답장 첨부파일
  • 파일 이름: ATTACHMENT_FILENAME + FILE_EXTENSION
  • fileContent: CONTENT_OF_THE_ATTACHED_FILE
케이스 월 테이블

케이스 월에서 이메일 결과 대기 작업은 다음 표를 생성합니다.

표 제목: 일치하는 메일

열:

  • 메일 ID
  • 수신일
  • 발신자
  • 수신자
  • 제목
JSON 결과

다음 예에서는 투표 결과 이메일 대기 작업을 사용할 때 수신되는 JSON 결과 출력을 설명합니다.

{
    "Responses": [
        {
            "recipient": "user@example.com",
            "vote": "Approve"
        }
    ]
}
출력 메시지

Wait For Vote Email Results 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명

Found the user EMAIL_RECIPIENT reply: USER_REPLY.

Exceeded timeout to get a reply from user: EMAIL_RECIPIENT.

 작업이 완료되었습니다.

Action failed to receive any replies until timeout.

Failed to execute action, the error is: ERROR_REASON

작업이 실패했습니다.

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

다음 표에서는 Wait For Vote Email Results 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

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

커넥터

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

Microsoft Graph Mail 위임 커넥터

Microsoft Graph Mail Delegated Connector를 사용하여 Microsoft Graph 메일 서비스에서 이메일을 가져옵니다.

Microsoft Graph Mail Delegated Connector는 Microsoft 365에서 위임된 인증을 사용하며 Microsoft 365에 연결하려면 사용자의 대화형 로그인이 필요합니다.

동적 목록을 사용하여 정규 표현식을 통해 이메일 본문 및 제목 부분에서 지정된 값을 필터링합니다. 기본적으로 커넥터는 정규 표현식을 사용하여 이메일에서 URL을 필터링합니다.

커넥터 기본 요건

Microsoft Graph Mail Delegated Connector를 사용하려면 통합 매개변수를 구성하고 갱신 토큰을 생성해야 합니다.

커넥터 입력

Microsoft Graph Mail Delegated Connector에는 다음 매개변수가 필요합니다.
매개변수 설명
Product Field Name

필수 항목입니다.

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

기본값은 device_product입니다.

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

필수 항목입니다.

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

기본값은 event_name입니다.
Environment Field Name

(선택사항)

환경 이름이 저장된 필드의 이름입니다.

환경 필드를 찾을 수 없는 경우 환경은 ""로 설정됩니다.

Environment Regex Pattern

(선택사항)

Environment Field Name 필드에 있는 값에서 실행할 정규 표현식 패턴입니다. 이 매개변수를 사용하면 정규 표현식 로직을 사용하여 환경 필드를 조작할 수 있습니다.

기본값 .*를 사용하여 필요한 원시 Environment Field Name 값을 가져옵니다.

정규 표현식 패턴이 null이거나 비어 있거나 환경 값이 null인 경우 최종 환경 결과는 ""입니다.
Email Exclude Pattern

(선택사항)

스팸이나 뉴스 등 특정 이메일을 인제스트에서 제외하는 정규 표현식입니다.

이 매개변수는 이메일의 제목과 본문 모두에서 작동합니다.
Script Timeout (Seconds)

필수 항목입니다.

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

기본값은 300입니다.
Microsoft Entra ID Endpoint

필수 항목입니다.

통합에서 사용할 Microsoft Entra 엔드포인트입니다.

기본값은 https://login.microsoftonline.com입니다.
Microsoft Graph Endpoint

필수 항목입니다.

통합에서 사용할 Microsoft Graph 엔드포인트입니다.

기본값은 https://graph.microsoft.com입니다.
Mail Address

필수 항목입니다.

커넥터에서 사용할 이메일 주소입니다.
Refresh Token

필수 항목입니다.

인증에 사용되는 갱신 토큰입니다.
Client ID

필수 항목입니다.

Microsoft Entra 애플리케이션의 애플리케이션 (클라이언트) ID입니다.
Client Secret Value

필수 항목입니다.

Microsoft Entra 애플리케이션의 클라이언트 보안 비밀번호 값입니다.
Microsoft Entra ID Directory ID

필수 항목입니다.

Microsoft Entra ID (테넌트 ID) 값입니다.
Folder to check for emails

필수 항목입니다.

이메일을 검색할 이메일 폴더입니다. 이 매개변수는 여러 폴더에서 사용자 응답을 검색할 폴더의 쉼표로 구분된 목록을 허용합니다. 하위 폴더를 지정하려면 / 슬래시를 사용합니다(예: Inbox/Subfolder).

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

기본값은 Inbox입니다.
Offset Time In Hours

필수 항목입니다.

첫 번째 커넥터 반복 전에 이메일을 가져올 시간 수입니다. 이 매개변수는 커넥터를 처음 사용 설정한 후의 초기 커넥터 반복에 적용됩니다. 커넥터는 최신 커넥터 반복의 타임스탬프가 만료될 때 이 매개변수를 대체 값으로 사용할 수 있습니다.

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

필수 항목입니다.

커넥터 반복마다 가져올 이메일 수입니다.

기본값은 10입니다.
Unread Emails Only

(선택사항)

선택하면 커넥터가 읽지 않은 이메일에서만 케이스를 생성합니다.

기본적으로 선택되지 않습니다.
Mark Emails as Read

(선택사항)

선택하면 커넥터가 수집 후 이메일을 읽음으로 표시합니다.

기본적으로 선택되지 않습니다.
Disable Overflow

(선택사항)

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

기본적으로 선택되지 않습니다.
Verify SSL

필수 항목입니다.

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

기본적으로 선택되어 있습니다.
Original Received Mail Prefix

(선택사항)

모니터링된 메일함에서 수신된 원본 이메일에서 추출된 이벤트 키 (예: to, from, subject)에 추가할 접두사입니다.

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

(선택사항)

모니터링되는 메일함에서 수신된 첨부 이메일 파일에서 추출된 이벤트 키 (예: to, from, subject)에 추가할 접두사입니다.

기본값은 attach입니다.
Create a Separate Google Secops Alert per Attached Mail File

(선택사항)

선택하면 커넥터가 첨부된 이메일 파일마다 하나의 알림을 포함하여 여러 알림을 생성합니다.

이 동작은 여러 이메일 파일이 첨부된 이메일을 처리하고 첨부된 이메일 파일에서 엔티티를 생성하도록 Google SecOps 이벤트 매핑을 설정할 때 유용합니다.

기본적으로 선택되지 않습니다.
Attach Original EML

(선택사항)

선택하면 커넥터가 원본 이메일을 케이스 정보에 EML 파일로 첨부합니다.

기본적으로 선택되지 않습니다.
Headers to add to events

(선택사항)

Google SecOps 이벤트에 추가할 이메일 헤더의 쉼표로 구분된 문자열입니다(예: DKIM-Siganture, Received, From).

헤더의 정확한 일치를 구성하거나 이 매개변수 값을 정규 표현식으로 설정할 수 있습니다.

커넥터는 구성된 값을 internetMessageHeaders 목록에서 필터링하고 Google SecOps 이벤트에 추가합니다.

커넥터가 이벤트에 헤더를 추가하지 못하도록 하려면 매개변수 값을 None로 설정합니다.

기본적으로 커넥터는 사용 가능한 모든 헤더를 추가합니다.
Case Name Template

(선택사항)

맞춤 케이스 이름입니다.

이 매개변수를 구성하면 커넥터가 Google SecOps SOAR 이벤트에 custom_case_name라는 새 키를 추가합니다.

[name of the field] 형식으로 자리표시자를 제공할 수 있습니다.

예: Phishing - [event_mailbox]

자리표시자의 경우 커넥터는 첫 번째 Google SecOps SOAR 이벤트를 사용합니다. 커넥터는 문자열 값을 포함하는 키만 처리합니다.
Alert Name Template

(선택사항)

맞춤 알림 이름입니다.

[name of the field] 형식으로 자리표시자를 제공할 수 있습니다.

예: Phishing - [event_mailbox]

자리표시자의 경우 커넥터는 첫 번째 Google SecOps SOAR 이벤트를 사용합니다. 커넥터는 문자열 값을 포함하는 키만 처리합니다. 값을 제공하지 않거나 잘못된 템플릿을 제공하면 커넥터에서 기본 알림 이름을 사용합니다.
Proxy Server Address

(선택사항)

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

(선택사항)

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

(선택사항)

인증할 프록시 비밀번호입니다.
Mail Field Source

(선택사항)

선택하면 통합에서 사용자 세부정보 mail 속성에서 메일함 주소를 가져옵니다. 선택하지 않으면 통합에서 userPrincipalName 필드에서 메일함 주소를 가져옵니다.

기본적으로 선택되어 있습니다.
Base64 Encoded Private Key

(선택사항)

이메일을 복호화하는 데 사용될 base64 인코딩된 비공개 키를 지정합니다.
Base64 Encoded Certificate

(선택사항)

이메일을 복호화하는 데 사용될 base64로 인코딩된 인증서를 지정합니다.
Base64 Encoded CA certificate

(선택사항)

서명 확인을 위해 base64로 인코딩된 신뢰할 수 있는 CA 인증서를 지정합니다.

커넥터 규칙

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

작업

Google SecOps에서 작업을 구성하려면 다음 단계를 완료하세요.

  1. 왼쪽 탐색 메뉴에서 응답 > 작업 스케줄러를 선택합니다.
  2. 작업 탭에서 추가 새 작업 만들기를 클릭합니다.
  3. 목록에서 필요한 작업을 선택하고 저장을 클릭합니다.
  4. 작업 구성으로 진행합니다.

갱신 토큰 갱신 작업

갱신 토큰 갱신 작업을 사용하여 통합의 갱신 토큰을 주기적으로 업데이트합니다.

기본적으로 갱신 토큰은 90일마다 만료됩니다. 새로고침 토큰을 최신 상태로 유지하려면 이 작업을 7일 또는 14일마다 자동으로 실행하도록 구성하는 것이 좋습니다.

작업 입력

새로고침 토큰 갱신 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Integration Environments

(선택사항)

갱신 토큰을 업데이트할 통합 환경입니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.

이 매개변수를 구성하려면 모든 환경 이름을 "" 큰따옴표로 묶습니다(예: "Default environment", "Environment 1", "Environment 5").
Connector Names

(선택사항)

새로고침 토큰을 업데이트할 커넥터 이름입니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.

이 매개변수를 구성하려면 모든 커넥터 이름을 "" 큰따옴표로 묶습니다(예: "Microsoft Graph Mail Delegated Connector", "Connector 2", "Connector 5").

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