Ce point d'accès lance une analyse CSA (Cloud Security Assessment) conformément à une politique. CSA analyse les comptes IaaS à la recherche de violations de la conformité, puis affiche les règles et les ressources non conformes associées à ces comptes. Pour voir les résultats de l'analyse, allez sur Cloud Infrastructure > Compliance dans l'interface utilisateur de Netskope.
Utilisez également la valeur de hachage scan_id renvoyée pour obtenir l'état d'une analyse CSA. Consultez la section « Obtenir l’état d’une analyse CSA ».
Request
GET https://<tenant-URL>/api/v1/csa_scan?token=<token>&op=start&name=<policy_name>&scan_start_by=<name>
Valid parameters are:
| Clé | Value | Description |
|---|---|---|
op | start | Lance le balayage. |
name | <policy_name> Exemple : "MYCSA_POLICY" | Il s'agit d'une obligation. Le nom de la politique d'évaluation de la sécurité dans l'interface utilisateur de Netskope. |
scan_start_by | Nom de l'utilisateur qui lance l'analyse. | Requis pour le démarrage de l'analyse. Ne peut être une chaîne vide. |
Exemple de demande et de réponse
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."
]
}