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 管理 > 設定 > ユーザー設定を管理」 「サービス > 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
詳細については、認証の概要をご覧ください。