O365 Management API

통합 버전: 9.0

사용 사례

Microsoft 365에서 활동 이벤트를 가져옵니다.

Google Security Operations와 함께 작동하도록 O365 관리 API 구성

제품 권한

자세한 내용은 Office 365 관리 API 시작하기를 참고하세요.

Office 365 관리 활동 API를 통해 데이터에 액세스하려면 먼저 Office 365 조직에 대해 통합 감사 로깅을 사용 설정해야 합니다. Office 365 감사 로그를 사용 설정하면 됩니다. 자세한 내용은 감사 사용 또는 사용 중지하기를 참고하세요.

계정 구성의 경우 절차가 다른 Azure 기반 제품(Defender, Sentinel 등)과 유사합니다. Azure Active Directory에 앱을 등록하고 다음 권한을 부여해야 합니다.

  • Microsoft Graph의 위임된 User.Read 권한
  • Office 365 관리 활동 API의 애플리케이션 ActivityFeed.ReadDlp 권한

Google SecOps에서 O365 관리 API 통합 구성

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

통합 매개변수

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

매개변수 표시 이름 유형 기본값 필수 항목 설명
인스턴스 이름 문자열 해당 사항 없음 No 통합을 구성할 인스턴스의 이름입니다.
설명 문자열 해당 사항 없음 No 인스턴스에 대한 설명입니다.
API 루트 문자열 https://manage.office.com 예 통합에 사용할 API 루트 URL입니다.
Azure Active Directory ID 문자열 해당 사항 없음 예 Azure Active Directory 테넌트 ID입니다. Active Directory > App Registration(앱 등록) > <통합을 위해 구성한 애플리케이션> Directory (tenant) ID(디렉터리(테넌트) ID)에서 확인할 수 있습니다. 예: k48f52ca-0000-4708-8ed0-0000a20a40a
클라이언트 ID 문자열 해당 사항 없음 예 이 통합을 위해 Azure Active Directory의 앱 등록에 추가된 클라이언트 (애플리케이션) ID입니다. 예: 29bf818e-0000-0000-0000-784fb644178d
클라이언트 보안 비밀번호 비밀번호 해당 사항 없음 아니요 Azure AD 앱 등록에 입력된 보안 비밀입니다. 예: XF00000Qc0000000[UZSW7-0?qXb6Qx]
SSL 확인 체크박스 선택 예 원격 API 엔드포인트 SSL 인증서의 유효성을 검사할지 여부를 지정합니다.
원격 실행 체크박스 선택 해제 No 구성된 통합을 원격으로 실행하려면 필드를 선택합니다. 선택하면 원격 사용자(에이전트)를 선택하는 옵션이 나타납니다.
인증서 경로 문자열 해당 사항 없음 아니요 클라이언트 보안 비밀번호 대신 인증서 기반 인증을 사용하는 경우 Google SecOps 서버의 인증서 경로를 지정합니다.
인증서 비밀번호 비밀번호 해당 사항 없음 아니요 선택사항입니다. 인증서가 비밀번호로 보호된 경우 인증서 파일을 여는 비밀번호를 지정합니다.
OAUTH2 로그인 엔드포인트 URL 문자열 https://login.microsoftonline.com 예 OAUTH2 로그인 엔드포인트 URL에 사용할 URL 커넥터를 지정합니다.

작업

핑

설명

Google Security Operations Marketplace 탭의 통합 구성 페이지에서 제공되는 매개변수를 사용하여 O365 Management API 서비스에 대한 연결을 테스트합니다.

매개변수

해당 사항 없음

실행

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

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예시
성공 True/False success:False
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

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

  • 성공한 경우 '제공된 연결 매개변수를 사용하여 O365 Management API에 연결되었습니다.'를 출력합니다.

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

  • 잘못된 사용자 인증 정보 또는 연결 손실과 같은 중대한 오류인 경우: 'O365 관리 API에 연결할 수 없습니다. 오류: {0}".format(exception.stacktrace)
 일반

구독 시작

설명

선택한 Office 365 관리 API 콘텐츠 유형의 구독을 시작합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
다음 계정의 구독을 시작합니다. DDL 콘텐츠 유형 선택, Audit.General 예 정기 결제를 시작할 콘텐츠 유형을 지정합니다.

실행

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

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예시
is_success True/False is_success:False
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

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

  • 성공한 경우: "{0} 콘텐츠 유형의 O365 Management API 구독을 만들었습니다.".format(content_type)를 출력합니다.

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

  • 잘못된 사용자 인증 정보 또는 연결 손실과 같은 심각한 오류인 경우: '명령어를 실행하지 못했습니다. 오류: {0}".format(exception.stacktrace)
 일반

구독 중지

설명

선택한 Office 365 관리 API 콘텐츠 유형의 구독을 중지합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
다음 구독 중지 DDL 콘텐츠 유형 선택, Audit.General 예 구독을 중지할 콘텐츠 유형을 지정합니다.

실행

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

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예시
is_success True/False is_success:False
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

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

  • 성공한 경우: "{0} 콘텐츠 유형의 O365 관리 API 구독을 중지했습니다.".format(content_type)를 출력합니다.

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

  • 잘못된 사용자 인증 정보 또는 연결 손실과 같은 심각한 오류인 경우: '명령어를 실행하기 위해 연결할 수 없습니다. 오류: {0}".format(exception.stacktrace)
 일반

커넥터

Google SecOps에서 Office 365 Management API 커넥터 구성

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

선택한 커넥터를 구성하려면 다음 표에 나열된 커넥터별 매개변수를 사용하세요.

Office 365 Management API DLP Events Connector

설명

Office 365 Management API에서 DLP 이벤트를 가져옵니다.

커넥터 매개변수

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

매개변수 표시 이름 유형 기본값 필수 항목 설명
제품 필드 이름 문자열 제품 이름 예 제품 필드 이름을 가져오려면 소스 필드 이름을 입력합니다.
이벤트 필드 이름 문자열 작업 예 이벤트 필드 이름을 가져오려면 소스 필드 이름을 입력합니다.
환경 필드 이름 문자열 "" 아니요

환경 이름이 저장된 필드의 이름을 설명합니다.

환경 필드를 찾을 수 없으면 환경이 기본 환경입니다.
환경 정규식 패턴 문자열 .* 아니요

'환경 필드 이름' 필드에 있는 값에서 실행할 정규식 패턴입니다.

기본값은 .*로서 모두 포착하고 변경되지 않은 값을 반환합니다.

사용자가 정규식 로직을 통해 환경 필드를 조작할 수 있도록 허용하는 데 사용됩니다.

정규식 패턴이 null이거나 비어 있거나 환경 값이 null인 경우 최종 환경 결과는 기본 환경입니다.
스크립트 제한 시간(초) 정수 180 예 현재 스크립트를 실행하는 Python 프로세스의 제한 시간 한도입니다.
API 루트 문자열 https://manage.office.com 예 통합에 사용할 API 루트 URL입니다.
Azure Active Directory ID 문자열 해당 사항 없음 예 Azure Active Directory 테넌트 ID입니다. Active Directory > App Registration(앱 등록) > <통합을 위해 구성한 애플리케이션> Directory (tenant) ID(디렉터리(테넌트) ID)에서 확인할 수 있습니다. 예: k48f52ca-0000-4708-8ed0-0000a20a40a
클라이언트 ID 문자열 해당 사항 없음 예 이 통합을 위해 Azure Active Directory의 앱 등록에 추가된 클라이언트 (애플리케이션) ID입니다. 예: 29bf818e-0000-0000-0000-784fb644178d
클라이언트 보안 비밀번호 비밀번호 해당 사항 없음 아니요 Azure AD 앱 등록에 입력된 보안 비밀입니다. 예: XF00000Qc0000000[UZSW7-0?qXb6Qx]
SSL 확인 체크박스 선택 예 원격 API 엔드포인트 SSL 인증서의 유효성을 검사할지 여부를 지정합니다.
작업 유형 필터 문자열 해당 사항 없음 아니요 DLP 이벤트에 사용할 수 있는 작업 유형은 DlpRuleMatch, DlpRuleUndo, DlpInfo입니다. 파라미터가 차단 목록으로 작동합니다. 이 파라미터에 아무것도 지정되지 않은 경우 기본적으로 가능한 모든 작업 유형을 수집합니다. 이 매개변수에 작업 유형이 지정된 경우 이 작업 유형의 이벤트는 수집되지 않습니다. 매개변수에서 쉼표로 구분된 문자열로 여러 값을 허용합니다.
정책 필터 유형 문자열 해당 사항 없음 아니요 매개변수를 사용하여 이벤트에 있는 경우 이벤트가 수집되지 않는 정책 이름을 지정할 수 있습니다. 파라미터가 차단 목록으로 작동합니다. 기본적으로 아무것도 지정하지 않으면 가능한 모든 정책 유형을 수집합니다. 매개변수에서 쉼표로 구분된 문자열로 여러 값을 허용합니다.
발견 항목을 마스크 처리하시겠어요? 체크박스 선택 해제 아니요 커넥터가 DLP 정책 위반을 트리거한 민감한 정보 검색 결과를 마스킹해야 하는지 여부를 지정합니다.
가져올 최대 이벤트 수 정수 50 예 커넥터 반복당 처리할 이벤트 수입니다.
최대 시간을 뒤로 가져오기 정수 8 예 이벤트를 가져올 위치의 시간입니다. O365 관리 API는 지난 7일 동안의 이벤트만 반환할 수 있습니다.
뒤로 가져오기 시간 간격 (분) 정수 240 예 최대 시간에서 뒤로 이벤트를 가져오는 데 사용할 시간 간격 커넥터입니다. O365 테넌트가 사용 중이면 많은 이벤트 blob을 반환할 수 있습니다. 따라서 이 매개변수(분 단위)를 사용하여 더 작은 세그먼트에서 최대 시간을 뒤로 분할하고 개별적으로 처리할 수 있습니다. 시간 간격은 총 24시간을 초과할 수 없습니다.
이벤트 패딩 기간 (분) 정수 60 예 이벤트 패딩 기간(분)은 커넥터가 새 이벤트를 확인하는 데 사용할 최소 시간 간격을 지정합니다.
허용 목록을 차단 목록으로 사용 체크박스 선택 해제 예 사용 설정하면 허용 목록이 차단 목록으로 사용됩니다.
프록시 서버 주소 문자열 아니요 사용할 프록시 서버의 주소입니다.
프록시 사용자 이름 문자열 아니요 인증할 프록시 사용자 이름입니다.
프록시 비밀번호 비밀번호 아니요 인증할 프록시 비밀번호입니다.
인증서 경로 문자열 아니요 클라이언트 보안 비밀번호 대신 인증서 기반 인증을 사용하는 경우 Google SecOps 서버의 인증서 경로를 지정합니다.
인증서 비밀번호 비밀번호 아니요 선택사항입니다. 인증서가 비밀번호로 보호된 경우 인증서 파일을 여는 비밀번호를 지정합니다.
OAUTH2 로그인 엔드포인트 URL 문자열 https://login.microsoftonline.com 예 OAUTH2 로그인 엔드포인트 URL에 커넥터가 사용할 URL을 지정합니다.

커넥터 규칙

허용 목록 / 차단 목록

커넥터에 허용 목록/차단 목록 지원 기능이 있습니다.

프록시 지원

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

Office 365 Management API 감사 일반 이벤트 커넥터

설명

Office 365 Management API에서 Audit.General 이벤트를 가져옵니다. 먼저 '구독 시작' 작업을 실행하여 Audit.General 이벤트에 대한 구독을 사용 설정했는지 확인하세요.

Office 365 Management API 감사 일반 이벤트 커넥터에는 다음 권한이 필요합니다.

  • Microsoft Graph에서 위임된 User.Read, email, profile 권한
  • Office 365 관리 활동 API의 애플리케이션 ActivityFeed.ReadDlp 및 ActivityFeed.Read 권한

커넥터 매개변수

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

매개변수 표시 이름 유형 기본값 필수 항목 설명
제품 필드 이름 문자열 제품 이름 예 제품 필드 이름을 가져오려면 소스 필드 이름을 입력합니다.
이벤트 필드 이름 문자열 작업 예 이벤트 필드 이름을 가져오려면 소스 필드 이름을 입력합니다.
환경 필드 이름 문자열 "" 아니요

환경 이름이 저장된 필드의 이름을 설명합니다.

환경 필드를 찾을 수 없으면 환경이 기본 환경입니다.
환경 정규식 패턴 문자열 .* 아니요

'환경 필드 이름' 필드에 있는 값에서 실행할 정규식 패턴입니다.

기본값은 .*로서 모두 포착하고 변경되지 않은 값을 반환합니다.

사용자가 정규식 로직을 통해 환경 필드를 조작할 수 있도록 허용하는 데 사용됩니다.

정규식 패턴이 null이거나 비어 있거나 환경 값이 null인 경우 최종 환경 결과는 기본 환경입니다.
스크립트 제한 시간(초) 정수 180 예 현재 스크립트를 실행하는 Python 프로세스의 제한 시간 한도입니다.
API 루트 문자열 https://manage.office.com 예 통합에 사용할 API 루트 URL입니다.
Azure Active Directory ID 문자열 해당 사항 없음 예 Azure Active Directory 테넌트 ID입니다. Active Directory > App Registration(앱 등록) > <통합을 위해 구성한 애플리케이션> Directory (tenant) ID(디렉터리(테넌트) ID)에서 확인할 수 있습니다. 예: k48f52ca-0000-4708-8ed0-0000a20a40a
클라이언트 ID 문자열 해당 사항 없음 예 이 통합을 위해 Azure Active Directory의 앱 등록에 추가된 클라이언트 (애플리케이션) ID입니다. 예: 29bf818e-0000-0000-0000-784fb644178d
클라이언트 보안 비밀번호 비밀번호 해당 사항 없음 아니요 Azure AD 앱 등록에 입력된 보안 비밀입니다. 예: XF00000Qc0000000[UZSW7-0?qXb6Qx]
인증서 경로 문자열 해당 사항 없음 아니요 클라이언트 보안 비밀번호 대신 인증서 기반 인증을 사용하는 경우 Google SecOps 서버의 인증서 경로를 지정합니다.
인증서 비밀번호 비밀번호 해당 사항 없음 아니요 선택사항입니다. 인증서가 비밀번호로 보호된 경우 인증서 파일을 여는 비밀번호를 지정합니다.
OAUTH2 로그인 엔드포인트 URL 문자열 https://login.microsoftonline.com 아니요 OAUTH2 로그인 엔드포인트 URL에 커넥터가 사용할 URL을 지정합니다.
SSL 확인 체크박스 선택 예 원격 API 엔드포인트 SSL 인증서의 유효성을 검사할지 여부를 지정합니다.
작업 유형 필터 문자열 해당 사항 없음 아니요 audit.general 스키마에는 SearchAirBatch, SearchCustomTag 등 다양한 작업 유형이 있을 수 있습니다. 이 파라미터에 아무것도 지정되지 않은 경우 기본적으로 가능한 모든 작업 유형을 수집합니다. 이 매개변수에 작업 유형이 지정된 경우 이 작업 유형의 이벤트는 수집되지 않습니다. 매개변수에서 쉼표로 구분된 문자열로 여러 값을 허용합니다.
상태 필터 문자열 해당 사항 없음 아니요 이 매개변수는 이벤트에 있는 경우 이벤트가 수집되지 않는 상태를 지정하는 데 사용할 수 있습니다. 파라미터가 차단 목록으로 작동합니다. 아무것도 지정하지 않은 경우 기본적으로 가능한 모든 상태 유형을 수집합니다. 매개변수에서 쉼표로 구분된 문자열로 여러 값을 허용합니다.
작업 및 상태 필터를 허용 목록으로 사용 체크박스 선택 해제 예 사용 설정하면 작업 및 상태 필터가 허용 목록으로 작동하며 기본적으로는 차단 목록입니다.
추가 이벤트를 생성하는 항목 키 CSV 해당 사항 없음 아니요 데이터의 Audit.General 엔티티 섹션에 표시되는 경우 관련 하위 섹션을 사용하여 추가 Google SecOps 이벤트를 생성해야 하는 키를 지정합니다.
가져올 최대 이벤트 수 정수 50 예 커넥터 반복당 처리할 이벤트 수입니다.
최대 시간을 뒤로 가져오기 정수 8 예 이벤트를 가져올 위치의 시간입니다. O365 관리 API는 지난 7일 동안의 이벤트만 반환할 수 있습니다.
뒤로 가져오기 시간 간격 (분) 정수 240 예 최대 시간에서 뒤로 이벤트를 가져오는 데 사용할 시간 간격 커넥터입니다. O365 테넌트가 사용 중이면 많은 이벤트 blob을 반환할 수 있습니다. 따라서 이 매개변수(분 단위)를 사용하여 더 작은 세그먼트에서 최대 시간을 뒤로 분할하고 개별적으로 처리할 수 있습니다. 시간 간격은 총 24시간을 초과할 수 없습니다.
이벤트 패딩 기간 (분) 정수 60 예 이벤트 패딩 기간(분)은 커넥터가 새 이벤트를 확인하는 데 사용할 최소 시간 간격을 지정합니다.
허용 목록을 차단 목록으로 사용 체크박스 선택 해제 예 사용 설정하면 허용 목록이 차단 목록으로 사용됩니다.
프록시 서버 주소 문자열 아니요 사용할 프록시 서버의 주소입니다.
프록시 사용자 이름 문자열 아니요 인증할 프록시 사용자 이름입니다.
프록시 비밀번호 비밀번호 아니요 인증할 프록시 비밀번호입니다.

커넥터 규칙

허용 목록 / 차단 목록

커넥터에 허용 목록/차단 목록 지원 기능이 있습니다.

프록시 지원

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

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