このエンドポイントは、ポリシーに従ってクラウド セキュリティ評価 (CSA) スキャンを開始します。 CSAはIaaSアカウントをスキャンしてコンプライアンス違反を検出し、違反しているアカウントに関連付けられているルールとリソースを表示します。スキャン結果を確認するには、Netskope UI のCloud Infrastructure > Complianceに移動してください。
また、CSA スキャン ステータスを取得するために返されたscan_idハッシュ値を使用します。 CSAスキャンステータスの取得については、こちらをご覧ください。
Request
GET https://<tenant-URL>/api/v1/csa_scan?token=<token>&op=start&name=<policy_name>&scan_start_by=<name>
Valid parameters are:
| 鍵 | Value | デスクリプション |
|---|---|---|
op | start | スキャンを開始します。 |
name | <policy_name> 例： "MYCSA_POLICY" | 必須。Netskope UIにおけるセキュリティ評価ポリシー名。 |
scan_start_by | スキャンを開始するユーザーの名前。 | スキャンを開始するために必要です。 空文字列は指定できません。 |
リクエストとレスポンスの例
curl -X GET https://<tenant-URL>/api/v1/csa_scan?token=<token>&op=start&name=<policy_name>&scan_start_by=<name>
{
"status": "success",
"msg": "Policy scan has been submitted",
"data {
"scan_id": "2e528976d8c01e115d8943519ab7b0f043ead317",
"data": []
}
}
// Success Response
{
"status": "success",
"msg": "Policy scan has been submitted",
"data": []
}
// Error Response for Invalid Policy Name
{
"status": "error",
"errorCode": "General Error",
"errors": [
"A deployed policy by this name does not exist."
]
}
// Error Response for Expired Token
{
"status": "error",
"errorCode": "Authorization Error",
"errors": [
"Invalid REST API Token. Please contact administrator"
]
}
// Error Response for invalid operator
{
"status": "error",
"errorCode": "General Error",
"errors": [
"Invalid op start_end."
]
}