Microsoft Sentinel용 Google Workspace(G Suite)(Azure Functions 사용) 커넥터
Google Workspace 데이터 커넥터는 REST API 통해 Google Workspace 활동 이벤트를 Microsoft Sentinel에 수집하는 기능을 제공합니다. 커넥터는 잠재적인 보안 위험을 검사하고, 팀의 공동 작업 내용을 분석하며, 구성 문제를 분석하고, 로그인 주체 및 시기를 추적하며, 관리자 활동을 분석하고, 사용자가 콘텐츠를 만들고 공유하는 방법을 이해하며, 조직에서 더 많은 이벤트를 검토하는 데 도움을 주는 이벤트를 가져올 수 있는 기능을 제공합니다.
자동 생성된 콘텐츠입니다. 변경은 솔루션 공급자에게 문의하세요.
커넥터 특성
| 커넥터 특성 | 설명 |
|---|---|
| Azure Function 앱 코드 | https://aka.ms/sentinel-GWorkspaceReportsAPI-functionapp |
| Log Analytics 테이블 | GWorkspace_ReportsAPI_admin_CL GWorkspace_ReportsAPI_calendar_CL GWorkspace_ReportsAPI_drive_CL GWorkspace_ReportsAPI_login_CL GWorkspace_ReportsAPI_mobile_CL GWorkspace_ReportsAPI_token_CL GWorkspace_ReportsAPI_user_accounts_CL |
| 데이터 수집 규칙 지원 | 현재 지원되지 않음 |
| 다음에서 지원 | Microsoft Corporation |
쿼리 샘플
Google Workspace 이벤트 - 모든 활동
GWorkspaceActivityReports
| sort by TimeGenerated desc
Google Workspace 이벤트 - 관리자 활동
GWorkspace_ReportsAPI_admin_CL
| sort by TimeGenerated desc
Google Workspace 이벤트 - 달력 활동
GWorkspace_ReportsAPI_calendar_CL
| sort by TimeGenerated desc
Google Workspace 이벤트 - 드라이브 활동
GWorkspace_ReportsAPI_drive_CL
| sort by TimeGenerated desc
Google Workspace 이벤트 - 로그인 활동
GWorkspace_ReportsAPI_login_CL
| sort by TimeGenerated desc
Google Workspace 이벤트 - 모바일 활동
GWorkspace_ReportsAPI_mobile_CL
| sort by TimeGenerated desc
Google Workspace 이벤트 - 토큰 활동
GWorkspace_ReportsAPI_token_CL
| sort by TimeGenerated desc
Google Workspace 이벤트 - 사용자 계정 활동
GWorkspace_ReportsAPI_user_accounts_CL
| sort by TimeGenerated desc
필수 조건
Google Workspace(G Suite)(Azure Functions 사용)와 통합하려면 다음이 있는지 확인합니다.
- Microsoft.Web/sites 권한: 함수 앱을 만들려면 Azure Functions에 대한 읽기 및 쓰기 권한이 필요합니다. Azure Functions에 대해 자세히 알아보려면 설명서를 참조하세요.
- REST API 자격 증명/권한: REST API에는GooglePickleString이 필요합니다. API에 대한 자세한 내용은 설명서를 참조하세요. 아래 구성 섹션에서 자격 증명을 가져오는 지침을 찾습니다. 여기에서 모든 요구 사항을 확인하고 지침을 따를 수도 있습니다.
공급업체 설치 지침
참고 항목
이 커넥터는 Azure Functions를 사용하여 Google Reports API에 연결하여 Microsoft Sentinel로 해당 로그를 풀합니다. 이로 인해 추가 데이터 수집 비용이 발생할 수 있습니다. 자세한 내용은 Azure Functions 가격 책정 페이지를 확인하세요.
(선택 단계) Azure Key Vault에 작업 영역과 API 권한 부여 키 또는 토큰을 안전하게 저장합니다. Azure Key Vault는 키 값을 저장하고 검색하는 안전한 메커니즘을 제공합니다. 지침에 따라 Azure 함수 앱에서 Azure Key Vault를 사용합니다.
참고: 이 데이터 커넥터는 예상대로 작동하도록 솔루션의 일부로 배포되는 Kusto 함수 기반 파서에 따라 작동합니다. Log Analytics에서 함수 코드를 보려면 Log Analytics/Microsoft Sentinel 로그 블레이드를 열고, Functions를 클릭하고, GWorkspaceReports 별칭을 검색하고, 함수 코드를 로드하거나 쿼리의 두 번째 줄에서 여기를 클릭하거나, GWorkspaceReports 디바이스의 호스트 이름 및 로그스트림에 대한 기타 고유 식별자를 입력합니다. 솔루션 설치/업데이트 후 함수가 활성화되는 데 일반적으로 10~15분이 소요됩니다.
1단계 - Google Pickel String을 얻기 위한 필수 구성 요소 확인
- Python 3 이상이 설치되어 있습니다.
- pip 패키지 관리 도구를 사용할 수 있습니다.
- API 액세스를 사용하도록 설정된 Google Workspace 도메인입니다.
- 관리자 권한이 있는 해당 도메인의 Google 계정입니다.
2단계 - Google Reports API에 대한 구성 단계
- 작업 영역 관리자 자격 증명 https://console.cloud.google.com을 사용하여 Google 클라우드 콘솔에 로그인합니다.
- 검색 옵션(위쪽 가운데에서 사용 가능)을 사용하여 API 및 서비스를 검색합니다.
- API 및 서비스 ->API 및 서비스 사용하도록 설정에서 이 프로젝트의관리자 SDK API를 사용하도록 설정합니다.
- API 및 서비스 ->OAuth 동의 화면으로 이동합니다. 아직 구성되지 않은 경우 다음 단계를 사용하여 OAuth 동의 화면을 만듭니다.
- 앱 이름 및 기타 필수 정보를 제공합니다.
- API 액세스를 사용하도록 설정된 권한 있는 도메인을 추가합니다.
- 범위 섹션에서 관리자 SDK API 범위를 추가합니다.
- 테스트 사용자 섹션에서 도메인 관리자 계정이 추가되었는지 확인합니다.
- API 및 서비스 ->자격 증명으로 이동하여 OAuth 2.0 클라이언트 ID를 만듭니다.
- 위쪽에서 자격 증명 만들기를 클릭하고 Oauth 클라이언트 ID를 선택합니다.
- 애플리케이션 유형 드롭다운에서 웹 애플리케이션을 선택합니다.
- 웹앱에 적합한 이름을 제공하고 권한 있는 리디렉션 URI 중 하나로 http://localhost:8081/을 추가합니다.
- 만들기를 클릭하면 표시되는 팝업에서 JSON을 다운로드합니다. 이 파일의 이름을 “credentials.json”으로 바꿉니다.
- Google Pickel String을 가져오려면 credentials.json 저장되는 동일한 폴더에서 python 스크립트를 실행합니다.
- 로그인을 위해 팝업되면 도메인 관리자 계정 자격 증명을 사용하여 로그인합니다.
참고: 이 스크립트는 Windows 운영 체제에서만 지원됩니다. 7. 이전 단계의 출력에서 Google Pickle String(작은따옴표 안에 포함)을 복사하여 편리하게 유지합니다. 함수 앱 배포 단계에서 Google Pickle String이 필요합니다.
3단계 - 다음 두 가지 배포 옵션 중 하나를 선택하여 커넥터 및 관련 Azure 함수 배포합니다.
중요: 작업 영역 데이터 커넥터를 배포하기 전에 작업 영역 ID 및 작업 영역 기본 키(다음에서 복사 가능)는 물론, Workspace GooglePickleString을 즉시 사용할 수 있도록 합니다.
옵션 1 - ARM(Azure Resource Manager) 템플릿
ARM 템플릿을 사용하여 Google Workspace 데이터 커넥터를 자동으로 배포하려면 이 메서드를 사용합니다.
아래에서 Azure에 배포 단추를 클릭합니다.
선호하는 구독, 리소스 그룹 및 위치를 선택합니다.
작업 영역 ID, 작업 영역 키, GooglePickleString을 입력하고 배포합니다.
위에 명시된 사용 약관에 동의합니다 확인란을 선택합니다.
구매를 클릭하여 배포합니다.
옵션 2 - Azure Functions 수동 배포
다음 단계별 지침을 사용하여 Azure Functions(Visual Studio Code를 통한 배포)를 통해 Google Workspace 데이터 커넥터를 수동으로 배포합니다.
1. 함수 앱 배포
참고: Azure 함수 개발을 하기 위해서는 VS Code를 준비해야 합니다.
Azure 함수 앱 파일을 다운로드합니다. 로컬 개발용 컴퓨터에 보관 파일을 추출합니다.
VS Code를 시작합니다. 메인 메뉴에서 파일을 선택하고 폴더 열기를 선택합니다.
추출된 파일에서 최상위 폴더를 선택합니다.
작업 표시줄에서 Azure 아이콘을 선택한 다음, Azure: Functions 영역에서 함수 앱에 배포 버튼을 선택합니다. 아직 로그인하지 않은 경우 작업 표시줄에서 Azure 아이콘을 선택한 다음, Azure: Functions 영역에서 Azure에 로그인을 선택합니다. 이미 로그인되어 있는 경우 다음 단계로 이동합니다.
프롬프트에서 다음 정보를 제공합니다.
a. 폴더 선택: 작업 영역에서 폴더를 선택하거나 함수 앱을 포함하는 폴더를 찾습니다.
b. 구독 선택: 사용할 구독을 선택합니다.
c. Azure에서 새 함수 앱 만들기를 선택합니다(고급 옵션은 선택하지 않음)
d. 함수 앱에 대해 전역적으로 고유 이름을 입력합니다. URL 경로에 유효한 이름을 입력합니다. 입력한 이름이 Azure Functions에서 고유한지 확인하기 위해 유효성을 검사합니다. (예: GWorkspaceXXXXX).
e. 런타임 선택: Python 3.8을 선택합니다.
f. 새 리소스의 위치 선택 성능 향상 및 비용 절감을 위해 Microsoft Sentinel이 있는 곳과 동일한 영역을 선택합니다.
배포가 시작됩니다. 함수 앱을 만들고 배포 패키지가 적용되면 알림이 표시됩니다.
함수 앱 구성을 위해 Azure Portal로 이동합니다.
2. 함수 앱 구성
함수 앱에서 함수 앱 이름을 선택하고 구성을 선택합니다.
애플리케이션 설정 탭에서 ** 새 애플리케이션 설정**을 선택합니다.
각 문자열 값(대/소문자 구분)을 사용하여 다음 애플리케이션 설정을 개별적으로 추가합니다. GooglePickleString WorkspaceID WorkspaceKey logAnalyticsUri(선택 사항)
(선택 사항) 필요한 경우 기본 지연을 변경합니다.
참고: 수집 지연에 대한 다음 기본값이 Google 설명서를 기반으로 Google Workspace의 다양한 로그 집합에 추가되었습니다. 환경 요구 사항에 따라 수정할 수 있습니다. 페치 지연 - 10분 달력 패치 지연 - 6시간 채팅 페치 지연 - 1일 사용자 계정 페치 지연 - 3시간 로그인 페치 지연 - 6시간
logAnalyticsUri를 사용하여 전용 클라우드에 대한 로그 분석 API 엔드포인트를 재정의합니다. 예를 들어, 퍼블릭 클라우드의 경우 값을 비워 둡니다. Azure GovUS 클라우드 환경의 경우
https://<CustomerId>.ods.opinsights.azure.us형식으로 값을 지정합니다.모든 애플리케이션 설정을 입력한 후 저장을 클릭합니다.
다음 단계
자세한 내용을 보려면 Azure Marketplace의 관련 솔루션으로 이동합니다.