Attributs de ressource

Voici des descriptions et des exemples de l'Resourcesobjet dans le AWS Format de recherche de sécurité (ASFF). Pour plus d’informations sur ces champs, consultez Ressources.

ApplicationArn

Identifie le nom de ressource Amazon (ARN) de l'application impliquée dans la recherche.

Exemple

"ApplicationArn": "arn:aws:resource-groups:us-west-2:123456789012:group/SampleApp/1234567890abcdef0"

ApplicationName

Identifie le nom de l'application impliquée dans la recherche.

Exemple

"ApplicationName": "SampleApp"

DataClassification

L'interface DataClassificationCe champ fournit des informations sur les données sensibles détectées sur la ressource.

Exemple

"DataClassification": {
    "DetailedResultsLocation": "Path_to_Folder_Or_File",
    "Result": {
        "MimeType": "text/plain",
        "SizeClassified": 2966026,
        "AdditionalOccurrences": false,
        "Status": {
            "Code": "COMPLETE",
            "Reason": "Unsupportedfield"
        },
       "SensitiveData": [
            {
                "Category": "PERSONAL_INFORMATION",
                "Detections": [
                    {
                        "Count": 34,
                        "Type": "GE_PERSONAL_ID",
                        "Occurrences": {
                            "LineRanges": [
                                {
                                    "Start": 1,
                                    "End": 10,
                                    "StartColumn": 20
                                }
                            ],
                            "Pages": [],
                            "Records": [],
                            "Cells": []
                        }
                    },
                    {
                        "Count": 59,
                        "Type": "EMAIL_ADDRESS",
                        "Occurrences": {
                            "Pages": [
                                {
                                    "PageNumber": 1,
                                    "OffsetRange": {
                                        "Start": 1,
                                        "End": 100,
                                        "StartColumn": 10
                                     },
                                    "LineRange": {
                                        "Start": 1,
                                        "End": 100,
                                        "StartColumn": 10
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "Count": 2229,
                        "Type": "URL",
                        "Occurrences": {
                           "LineRanges": [
                               {
                                   "Start": 1,
                                   "End": 13
                               }
                           ]
                       }
                   },
                   {
                       "Count": 13826,
                       "Type": "NameDetection",
                       "Occurrences": {
                            "Records": [
                                {
                                    "RecordIndex": 1,
                                    "JsonPath": "$.ssn.value"
                                }
                            ]
                        }
                   },
                   {
                       "Count": 32,
                       "Type": "AddressDetection"
                   }
               ],
               "TotalCount": 32
           }
        ],
        "CustomDataIdentifiers": {
            "Detections": [
                 {
                     "Arn": "1712be25e7c7f53c731fe464f1c869b8", 
                     "Name": "1712be25e7c7f53c731fe464f1c869b8", 
                     "Count": 2,
                 }
            ],
            "TotalCount": 2
        }
    }
}

Détails

L'interface DetailsCe champ fournit des informations supplémentaires sur une seule ressource à l'aide des objets appropriés. Chaque ressource doit être fournie dans un objet de ressource distinct dans l'Resourcesobjet.

Notez que si la taille de la recherche dépasse le maximum de 240 Ko, l'Detailsobjet est supprimé de la recherche. Pour les résultats de contrôle qui utilisent AWS Config règles, vous pouvez consulter le détail des ressources sur le AWS Config console.

Security Hub fournit un ensemble de détails sur les ressources disponibles pour les types de ressources pris en charge. Ces détails correspondent aux valeurs de l'Typeobjet. Utilisez les types fournis dans la mesure du possible.

Par exemple, si la ressource est un compartiment S3, définissez la ressource Type sur AwsS3Bucket et fournissez les détails de la ressource dans l'AwsS3Bucketobjet.

L'Otherobjet vous permet de fournir des champs et des valeurs personnalisés. Vous utilisez l'Otherobjet dans les cas suivants :

• Le type de ressource (la valeur de la ressourceType) n'a pas d'objet de détails correspondant. Pour fournir des détails sur la ressource, vous utilisez l'Otherobjet.

• L'objet correspondant au type de ressource n'inclut pas tous les champs que vous souhaitez renseigner. Dans ce cas, utilisez l'objet de détails correspondant au type de ressource pour renseigner les champs disponibles. Utilisez l'Otherobjet pour renseigner les champs qui ne figurent pas dans l'objet spécifique au type.

• Le type de ressource n'est pas l'un des types fournis. Dans ce cas, définissez Resource.Type et utilisez l'Otherobjet pour renseigner les informations. Other

Exemple

"Details": {
  "AwsEc2Instance": {
    "IamInstanceProfileArn": "arn:aws:iam::123456789012:role/IamInstanceProfileArn",
    "ImageId": "ami-79fd7eee",
    "IpV4Addresses": ["1.1.1.1"],
    "IpV6Addresses": ["2001:db8:1234:1a2b::123"],
    "KeyName": "testkey",
    "LaunchedAt": "2018-09-29T01:25:54Z",
    "MetadataOptions": {
      "HttpEndpoint": "enabled",
      "HttpProtocolIpv6": "enabled",
      "HttpPutResponseHopLimit": 1,
      "HttpTokens": "optional",
      "InstanceMetadataTags": "disabled"
    },
    "NetworkInterfaces": [
    {
      "NetworkInterfaceId": "eni-e5aa89a3"
    }
    ],
    "SubnetId": "PublicSubnet",
    "Type": "i3.xlarge",
    "VirtualizationType": "hvm",
    "VpcId": "TestVPCIpv6"
  },
  "AwsS3Bucket": {
    "OwnerId": "da4d66eac431652a4d44d490a00500bded52c97d235b7b4752f9f688566fe6de",
    "OwnerName": "acmes3bucketowner"
  },
  "Other": { "LightPen": "blinky", "SerialNo": "1234abcd"}  
}

Id

Identifiant du type de ressource donné.

Dans AWS ressources identifiées par Amazon Resource Names (ARNs), il s'agit duARN.

Dans AWS ressources manquantesARNs, il s'agit de l'identifiant tel que défini par le AWS service qui a créé la ressource.

Pour les non-initiés AWS ressources, il s'agit d'un identifiant unique associé à la ressource.

Exemple

"Id": "arn:aws:s3:::amzn-s3-demo-bucket"

Partition

Partition dans laquelle se trouve la ressource. Une partition est un groupe de Régions AWS. Chaque Compte AWS est limité à une partition.

Les partitions suivantes sont prises en charge :

• aws – Régions AWS

• aws-cn – Régions en Chine

• aws-us-gov – AWS GovCloud (US) Region

Exemple

"Partition": "aws"

Région

Le code du Région AWS où se trouve cette ressource. Pour obtenir la liste des codes de région, consultez la section Points de terminaison régionaux.

Exemple

"Region": "us-west-2"

ResourceRole

Identifie le rôle de la ressource dans le résultat. Une ressource est soit la cible de l'activité de recherche, soit l'acteur qui a effectué l'activité.

Exemple

"ResourceRole": "target"

Balises

Ce champ fournit des informations sur la clé de balise et la valeur de la ressource impliquée dans une recherche. Vous pouvez étiqueter les ressources prises en charge par le GetResources fonctionnement du AWS Resource Groups Marquage. API Security Hub appelle cette opération via le rôle lié au service et récupère les balises de ressources si le AWS Le Resource.Id champ Security Finding Format (ASFF) est rempli avec le AWS ressourceARN. IDsLes ressources non valides sont ignorées.

Vous pouvez ajouter des balises de ressources aux résultats ingérés par Security Hub, notamment aux résultats issus de Services AWS et des produits tiers.

L'ajout de balises indique les balises associées à une ressource au moment du traitement de la recherche. Vous ne pouvez inclure l'Tagsattribut que pour les ressources associées à une balise. Si une ressource n'a pas de balise associée, n'incluez pas d'attribut Tags dans le résultat.

L'inclusion de balises de ressources dans les résultats élimine le besoin de créer des pipelines d'enrichissement des données ou d'enrichir manuellement les métadonnées des résultats de sécurité. Vous pouvez également utiliser des balises pour rechercher ou filtrer les résultats et les informations et créer des règles d'automatisation.

Pour plus d'informations sur les restrictions applicables aux balises, consultez la section Limites et exigences relatives à la dénomination des balises.

Vous ne pouvez fournir que des balises qui existent sur un AWS ressource dans ce domaine. Pour fournir des données qui ne sont pas définies dans le AWS Format de recherche de sécurité, utilisez le sous-champ Other Détails.

Exemple

"Tags": {
    "billingCode": "Lotus-1-2-3",
    "needsPatching": "true"
}

Type

Type de ressource pour laquelle vous fournissez des informations.

Dans la mesure du possible, utilisez l'un des types de ressources fournis, tel que AwsEc2Instance ou AwsS3Bucket.

Si le type de ressource ne correspond à aucun des types de ressources fournis, définissez la ressource Type sur et utilisez le sous-champ Other Détails pour renseigner les détails. Other

Les valeurs prises en charge sont répertoriées sous Ressources.

Exemple

"Type": "AwsS3Bucket"