Security Insights API を使用すると、Chrome セキュリティ インサイト機能を有効または無効にしたり、有効化ステータスを確認したりできます。
API メソッドの概要
URL は https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER を基準とした相対パスです。
| 説明 | 相対 URL | HTTP メソッド | 許可されるリクエスト パラメータ |
|---|---|---|---|
| ドメインのインサイトを有効にし、ドメイン内のルート組織部門または特定の組織部門セットの Chrome コネクタを構成する | /enterprise/securityInsights:enable | POST | 省略可 __: targetOus |
| ドメインのインサイトを無効にする | /enterprise/securityInsights:disable | POST | |
| ドメインのインサイトの有効化ステータスを確認する | /enterprise/securityInsights:checkEnablementStatus | GET |
リクエストとレスポンスの例については、コードサンプルをご覧ください。
管理者権限
呼び出すメソッドに応じて、必要な管理者権限が異なります。
| メソッド | 必要な管理者権限 |
|---|---|
| 有効にする | "[組織部門] > [読み取り]" "[サービス] > [Chrome 管理] > [設定] > [ユーザー設定を管理]" "[サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定を管理]" |
| 無効にする | "[組織部門] > [読み取り]" "[サービス] > [Chrome 管理] > [設定] > [ユーザー設定を管理]" "[サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定を管理]" |
| checkEnablementStatus | "[組織部門] > [読み取り]" "[サービス] > [Chrome DLP] > [Chrome DLP アプリケーション インサイトの設定を管理]" [または] "[サービス] > [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
詳細については、認証 の概要をご覧ください。