Trend Micro Cloud App Security

통합 버전: 6.0

제품 사용 사례

활성 작업 실행 - 엔티티 보강, 이메일 검색, 차단 목록 업데이트, 이메일/계정 완화

API 토큰을 생성하는 방법

1. 관리 > 자동화 및 통합 API로 이동합니다.
2. '추가' 버튼을 누릅니다.
3. '외부 애플리케이션용'을 선택합니다.
4. '이름'을 입력하고 모든 체크박스를 선택합니다.
5. '토큰 만들기'를 누릅니다.
6. '토큰'을 복사합니다.
7. 통합 구성에서 'API 키' 매개변수를 업데이트합니다.
8. 연결을 테스트합니다.

Google Security Operations에서 Trend Micro Cloud App Security 통합 구성

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

통합 매개변수

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

매개변수 표시 이름	유형	기본값	필수 항목	설명
API 루트	문자열	https://api-eu.tmcas.trendmicro.com	예	Trend Micro Cloud App Security 인스턴스의 API 루트입니다.
API 키	비밀번호	해당 사항 없음	예	Trend Micro Cloud App Security 인스턴스의 API 키입니다.
SSL 확인	체크박스	선택	예	사용 설정하면 Trend Micro Cloud App Security 서버 연결에 대한 SSL 인증서가 유효한지 확인합니다.

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

작업

핑

설명

Google Security Operations Marketplace 탭의 통합 구성 페이지에서 제공된 매개변수를 사용하여 Trend Micro Cloud App Security에 대한 연결을 테스트합니다.

매개변수

해당 사항 없음

실행

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

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션
is_success	is_success=False
is_success	is_success=True

케이스 월

결과 유형	값 / 설명	유형
출력 메시지*	성공한 경우 (is_success = true) - 제공된 연결 매개변수를 사용하여 Trend Micro Cloud App Security 서버에 연결되었습니다. 성공하지 못한 경우 (is_success = false) - Trend Micro Cloud App Security 서버에 연결할 수 없습니다. 오류: {0}".format(exception.stacktrace)	일반

차단 목록에 항목 추가

설명

Trend Micro Cloud App Security의 차단 목록에 항목을 추가합니다. 지원되는 항목: URL, 해시, 이메일 (이메일 주소 패턴과 일치하는 사용자 항목)

참고: SHA-1 해시만 지원됩니다.

매개변수

이름	기본값	필수 항목	설명
해당 사항 없음	해당 사항 없음	해당 사항 없음	해당 사항 없음

실행

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

• URL
• 해시
• 이메일

작업 결과

스크립트 결과

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

케이스 월

케이스	성공	실패	메시지
항목 1개에 성공한 경우	true	거짓	Trend Micro Cloud App Security의 차단 목록에 다음 항목이 추가되었습니다. {\n entity.identifier}
항목 1개에 대해 성공하지 못한 경우	true	거짓	작업이 Trend Micro Cloud App Security의 차단 목록에 다음 항목을 추가할 수 없습니다. {\n entity.identifier}
중복된 경우	true	거짓	다음 항목은 이미 Trend Micro Cloud App Security의 차단 목록에 포함되어 있습니다. {\n entity.identifier}
모든 사용자에게 성공적인 것은 아님	거짓	거짓	Trend Micro Cloud App Security의 정보를 사용하여 추가된 항목이 없습니다.
치명적인 오류, 잘못된 사용자 인증 정보, API 루트	거짓	true	'차단 목록에 항목 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {오류 트레이스백}

이메일 완화

설명

Trend Micro Cloud App Security를 사용하여 이메일을 삭제하거나 격리합니다. 참고: Gmail의 경우 이메일만 삭제할 수 있습니다.

참고: 현재 작업은 완화만 시작하고 완화 실행 상태는 확인하지 않습니다.

매개변수

이름	기본값	필수 항목	설명
메시지 ID	해당 사항 없음	예	완화해야 하는 메시지 ID를 쉼표로 구분하여 지정합니다.
완화 조치	삭제 가능한 값은 다음과 같습니다. 삭제 스팸 격리 저장소	예	적용할 완화 조치를 지정합니다.
서비스	Gmail 가능한 값 Gmail Exchange	예	이메일에 사용되는 서비스를 지정합니다.

실행

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

작업 결과

스크립트 결과

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

케이스 월

케이스	성공	실패	메시지
1개의 message_id에 대해 성공한 경우	참	거짓	Trend Micro Cloud App Security에서 다음 이메일이 성공적으로 완화되었습니다. {\n unique message ids}
1개의 message_id에 대해 성공하지 못한 경우	참	거짓	작업에서 Trend Micro Cloud App Security의 다음 이메일을 완화할 수 없습니다. {\n unique message ids}
모든 사용자에게 성공적인 것은 아님	거짓	거짓	Trend Micro Cloud App Security에 의해 완화된 이메일이 없습니다.
치명적인 오류, 잘못된 사용자 인증 정보, API 루트	거짓	true	'이메일 완화' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {오류 트레이스백}
'격리'가 선택되어 있고 'Gmail'이 서비스인 경우	거짓	true	'이메일 완화' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Gmail 서비스에서만 이메일을 삭제할 수 있습니다.

엔티티 이메일 검색

설명

Trend Micro Cloud App Security의 엔티티를 기반으로 이메일을 검색합니다. 지원되는 항목: URL, 해시, 이메일 (이메일 주소 패턴과 일치하는 사용자 항목), 이메일 제목, 파일 이름, IP

참고: SHA-1 및 SHA256 해시만 지원됩니다.

매개변수

이름	기본값	필수 항목	설명
최대 이전 일수	30	아니요	이메일을 검색할 이전 기간(일)을 지정합니다. 최댓값은 90입니다. 기본값: 30
반환할 최대 이메일 수	100	아니요	반환할 이메일 수를 지정합니다. 기본값: 100

실행

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

• URL
• 해시
• 이메일
• 이메일 제목
• 파일 이름
• IP 주소

작업 결과

스크립트 결과

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

JSON 결과

emails=[{list of unique emails}]

케이스 월

케이스	성공	실패	메시지
데이터가 있는 경우:	true	거짓	Trend Micro Cloud App Security에서 제공된 엔티티와 관련된 이메일에 관한 정보를 반환했습니다.
데이터를 사용할 수 없는 경우	거짓	거짓	Trend Micro Cloud App Security에서 엔티티와 관련된 이메일에 대한 정보가 발견되지 않았습니다.
치명적인 오류, 잘못된 사용자 인증 정보, API 루트	거짓	true	'엔티티 이메일 검색' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {오류 트레이스백}
'최대 이전 일수'가 90보다 큰 경우	거짓	true	'엔티티 이메일 검색' 작업을 실행하는 동안 오류가 발생했습니다. 이유: '최대 이전 일수'는 1~90일 범위에 있어야 합니다.

항목 보강

설명

Trend Micro Cloud App Security의 정보로 항목을 보강합니다. 지원되는 항목: URL, 해시, 이메일 (이메일 주소 패턴과 일치하는 사용자 항목)

참고: 이 작업은 보강 중에 URL의 도메인 부분을 사용합니다.

매개변수

이름	기본값	필수 항목	설명
해당 사항 없음	해당 사항 없음	해당 사항 없음	해당 사항 없음

실행

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

• URL
• 해시
• 이메일

작업 결과

스크립트 결과

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

JSON 결과

blocked_url = [URL entities that were found]
blocked_hashes = [hashes entities that were found]
blocked_senders = [User entities that were found]

케이스 월

케이스	성공	실패	메시지
항목 1개에 성공한 경우	true	거짓	Trend Micro Cloud App Security에서 다음 항목에 대한 정보를 가져왔습니다. {\n entity.identifier}
항목 1개에 대해 성공하지 못한 경우	true	거짓	작업에서 Trend Micro Cloud App Security에서 다음 항목에 관한 정보를 가져올 수 없습니다. {\n entity.identifier}
모든 사용자에게 성공적인 것은 아님	거짓	거짓	Trend Micro Cloud App Security의 정보를 사용하여 보강된 항목이 없습니다.
치명적인 오류, 잘못된 사용자 인증 정보, API 루트	거짓	true	'항목 보강' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {오류 트레이스백}

계정 완화

설명

Trend Micro Cloud App Security를 통해 사용자 계정에 대한 완화 조치를 수행합니다.

참고: Exchange 계정만 지원됩니다.

매개변수

이름	기본값	필수 항목	설명
이메일 주소	해당 사항 없음	예	완화해야 하는 이메일 주소를 쉼표로 구분하여 지정합니다.
완화 조치	계정 사용 중지 MFA 사용 설정 비밀번호 재설정 로그인 세션 취소	예	적용할 완화 조치를 지정합니다.

실행

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

작업 결과

스크립트 결과

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

케이스 월

케이스	성공	실패	메시지
이메일 주소 1개에 대해 성공한 경우	true	거짓	Trend Micro Cloud App Security에서 다음 계정의 문제가 해결되었습니다. {\n 이메일 주소}
항목 1개에 대해 성공하지 못한 경우	true	거짓	Trend Micro Cloud App Security에서 다음 계정을 완화할 수 없습니다. {\n 이메일 주소}
모든 사용자에게 성공적인 것은 아님	거짓	거짓	Trend Micro Cloud App Security의 정보를 사용하여 완화된 계정이 없습니다.
비동기 메시지	거짓	거짓	완화 작업이 완료될 때까지 기다리는 중입니다.
치명적인 오류, 잘못된 사용자 인증 정보, API 루트	거짓	true	'계정 완화' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {오류 트레이스백}

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