Voir les violations de l’évaluation de sécurité - Documentation technique Netskope

Utilisez ce point de terminaison pour obtenir les violations de l’évaluation de sécurité issues du dernier scan ou comme instantané temporel. Ce point de terminaison reproduit également l’entrée et la sortie affichées à Cloud Infrastructure > Compliance > Raw Findings.

SSPM V1 est obsolète et le point de terminaison REST API v1 n'est plus supporté pour SSPM, utilisez plutôt le point de terminaison REST API v2. Connectez-vous à votre locataire, allez sur Settings > Tools > REST API v2, et cliquez sur API Documentation. Naviguez jusqu'à la section SPM pour trouver des détails sur les points de terminaison.

Point final de la demande

https://<tenant-URL>/api/v1/security_assessment

Valid parameters are:

Clé	Value	Description
`account_id`	Chaîne de caractères codée en URL	L'identifiant du compte du fournisseur de la plateforme IaaS.
`account_name`	Chaîne de caractères codée en URL	Le nom du compte du fournisseur de la plateforme IaaS.
`cloud_provider`	`azure \| aws \| googlecloud`	Le fournisseur de plateforme IaaS.
`policy_name`	Chaîne de caractères codée en URL	Le nom de la politique d'évaluation de la sécurité.
`profile_name`	Chaîne de caractères codée en URL	Le nom du profil d'évaluation de la sécurité.
`rule_name`	Chaîne de caractères codée en URL	Le nom de la règle d'évaluation de la sécurité.
`resource_category`	Chaîne de caractères codée en URL	Catégorie d'actifs définie par Netskope pour chaque ressource du compte.
`resource_id`	Chaîne de caractères codée en URL	L'identifiant de l'actif créé par le fournisseur de la plateforme IaaS.
`resource_name`	Chaîne de caractères codée en URL	Le nom de l'instance IaaS.
`resource_type`	Chaîne de caractères codée en URL	Le type de ressource défini par Netskope par ressource de compte.
`tag_name`	Chaîne de caractères codée en URL	Le nom de la balise défini dans la ressource du compte du fournisseur de la plate-forme Iaas. Vous devez également fournir la valeur de la balise.
`tag_value`	Chaîne de caractères codée en URL	La valeur de la balise définie dans la ressource du compte du fournisseur de la plate-forme Iaas. Vous devez également indiquer le nom de l'étiquette.
`remediated_by`	`AutoRemediation \| OnDemandRemediation`	Comment la violation de la politique a été corrigée.
`last_remediation_status`	`None \| Started \| Completed \| Errored`	Dernier état de l'assainissement. `None` ne signifie aucune des trois autres options.
`as_of`	Integer	Époque des résultats à ce moment-là. L'heure par défaut est l'heure de la demande si elle n'est pas fournie, et c'est l'heure GMT.
`severity`	`Critical \| High \| Medium \| Low`	La sévérité de la règle d'évaluation de la sécurité.
`limit`	Entier positif inférieur à 10000	Required. Les réponses de l'API REST peuvent renvoyer jusqu'à 10000 événements dans une seule réponse. Vous pouvez utiliser la pagination pour obtenir davantage de résultats.
`skip`	Nombre entier positif	Sauter certains événements (utile pour la pagination en combinaison avec la limite).
`status`	`Passed \| Failed`	L'état de l'évaluation de la sécurité.
`muted`	`Yes \| No`	Renvoie les résultats en sourdine ou non.
`compliance_standard`	Chaîne de caractères codée en URL	Le nom de la norme de conformité, comme CIS-AWSFND-1.2.0, NIST-CSF, etc.
`region`	Pour Azure, les valeurs possibles sont les suivantes : `all` `global` `eastus` `northcentralus` `westus` `centralindia` `centralus` `australiacentral` Pour AWS, les valeurs possibles sont les suivantes : `global` `ap-south-1` `ap-northeast-2` `ap-southeast-1` `ap-southeast-2` `ap-northeast-1` `ca-central-1` `eu-central-1` `eu-west-1` `eu-west-2` `eu-west-3` `eu-north-1` `me-south-1` `us-east-1` `us-east-2` `us-west-1` `us-west-2` Pour Google Cloud, les valeurs possibles sont les suivantes : `asia-east1` `asia-east2` `asia-northeast1` `asia-southeast1` `asia-south1` `europe-north1` `europe-west1` `europe-west2` `europe-west3` `europe-west4` `northamerica-northeast1` `southamerica-east1` `us-central1` `us-east1` `us-east4` `us-west1` `us-west2`	La référence de l'emplacement

Exemple de demande et de réponse

curl -X GET 'https://<tenant-URL>/api/v1/security_assessment?token=<token>&platform=aws&limit=1&skip=0’

{
    "status": "success",
    "msg": "",
    "data": [
        {
            "status": "Passed",
            "account_name": "Rel66AWS",
            "account_id": "215406114230",
            "rule_name": "BPR-AWS | Ensure no user has AdminAccess policy",
            "remediation_steps": "Not Available",
            "resource_name": "gauthami",
            "resource_id": "gauthami",
            "resource_type": "User",
            "resource_category": "Identity",
            "severity": "High",
            "failing_since": "2020-02-12 02:30:17AM", 
             // Will appear only if status = Failed    
            "mute": "true",
             // Will appear only if muted or has been muted in the past        
            "cloud_provider": "AWS",
            "profiles": [
                "AWS Best Practices v1.0.0"
            ],
            "mute_until": "2020-04-14 07:00:00AM",
            // Will appear only if muted or has been muted in the past
            "mute_time": "2020-04-01 06:30:46AM",
            // Will appear only if muted or has been muted in the past               
            "mute_by": "developer@netskope.com",
// Will appear only if muted or has been muted in the past
            "auto_remediation_status": "errored",
            "remediation_action_name": "Ensure User does not have Admin Access Privilege",
            "remediated_by": "auto_remediation",
            "auto_remediation_time": "2019-08-01 06:54:45AM",
            "is_auto_remediation": "true",
            "policies": [
                "ak-ar-policy"
            ],
            "region_name": "global",
            "error_msg": "",
            "last_scan_time": "2019-08-01 06:54:45AM",
            "tags": [
                {
                    "name": "gautami",
                    "value": "1032"
            }],    
            "compliance_standards": [{ 
                "control": "1",
                "description": "Audit/log records are determined, documented, implemented, and reviewed in accordance with policy",           
                "section": "PR.PT",
                "standard": "NIST-CSF-1.1",
                "reference_url": "https://nvlpubs.nist.gov/nistpubs/CSWP/NIST.
CSWP.04162018.pdf"
                },
                {            
                "control": "9",            
                "description": "Ensure a log metric filter and alarm exist for AWS Config configuration changes",
                "appname": "aws",
                "section": "3",
                "standard": "CIS-AWSFND-1.2.0",            
                "reference_url": "https://www.cisecurity.org/benchmark/amazon_web_
services/"        
                }
           ]
}