Security Insights API를 사용하면 Chrome 보안 통계 기능을 사용 설정 또는 사용 중지하고, 사용 설정 상태를 확인하며, 통계 데이터 (예: 콘텐츠 전송 및 URL 방문)를 쿼리할 수 있습니다.
API 메서드 간략한 개요
URL은 https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER를 기준으로 합니다.
| 설명 | 상대 URL | Http 메소드 | 허용된 요청 매개변수 |
|---|---|---|---|
| 도메인의 통계를 사용 설정하고 도메인의 루트 OU/특정 OU 집합에 Chrome 커넥터를 구성합니다. | /enterprise/securityInsights:enable | POST | 선택사항: targetOus |
| 도메인의 통계를 사용 중지합니다. | /enterprise/securityInsights:disable | POST | |
| 도메인의 통계 사용 설정 상태를 확인합니다. | /enterprise/securityInsights:checkEnablementStatus | YouTube 최신 소식 | |
| 도메인의 대략적인 콘텐츠 전송 요약을 쿼리합니다. | /enterprise/securityInsights:queryContentTransfers | YouTube 최신 소식 | 선택사항: filter |
| 사용자/도메인/콘텐츠 카테고리별 분석이 포함된 콘텐츠 전송 요약을 쿼리합니다. | /enterprise/securityInsights:queryContentTransfersBreakdowns | YouTube 최신 소식 | 선택사항: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| 도메인의 대략적인 URL 방문 요약을 쿼리합니다. | /enterprise/securityInsights:queryUrlVisits | YouTube 최신 소식 | 선택사항: filter |
| 사용자/도메인별 분석이 포함된 URL 방문 요약을 쿼리합니다. | /enterprise/securityInsights:queryUrlVisitsBreakdowns | YouTube 최신 소식 | 선택사항: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
요청 및 응답 예시는 코드 샘플을 참고하세요.
구독 요구사항
다음 API 메서드를 사용하려면 활성 Chrome Enterprise Premium 구독이 필요합니다. 고객에게 이 구독이 없어도 요청이 차단되지는 않지만 쿼리 결과가 비어 있습니다.
queryUrlVisitsqueryUrlVisitsBreakdowns
관리자 권한
호출되는 메서드에 따라 필요한 관리자 권한이 다릅니다.
| 메서드 | 필요한 관리자 권한 |
|---|---|
| 사용 설정 | '조직 단위 > 읽기' '서비스 > Chrome 관리 > 설정 > 사용자 설정 관리' '서비스 > Chrome DLP > Chrome DLP 애플리케이션 통계 설정 관리' |
| 사용 중지 | '조직 단위 > 읽기' '서비스 > Chrome 관리 > 설정 > 사용자 설정 관리' '서비스 > Chrome DLP > Chrome DLP 애플리케이션 통계 설정 관리' |
| checkEnablementStatus | "조직 단위 > 읽기" "서비스 > Chrome DLP > Chrome DLP 애플리케이션 통계 설정 관리" 또는 "서비스 > Chrome DLP > Chrome DLP 애플리케이션 통계 설정 보기" |
| queryContentTransfers | '서비스 > Chrome DLP > Chrome DLP 애플리케이션 통계 설정 보기' |
| queryContentTransfersBreakdowns | '서비스 > Chrome DLP > Chrome DLP 애플리케이션 통계 설정 보기' |
| queryUrlVisits | '서비스 > Chrome DLP > Chrome DLP 애플리케이션 통계 설정 보기' |
| queryUrlVisitsBreakdowns | '서비스 > Chrome DLP > Chrome DLP 애플리케이션 통계 설정 보기' |
관리자 역할 및 권한을 관리하려면 '관리 콘솔 -> 관리자 역할'로 이동하세요.
API 범위
API를 사용 설정 및 사용 중지하려면 다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/chrome.management.securityinsights
checkEnablementStatus 및 모든 쿼리 메서드의 경우 다음 두 범위 중 하나를 사용할 수 있습니다.
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
자세한 내용은 인증 개요를 참조하세요.