Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
BatchImportFindings per trovare fornitori
I fornitori di ricerca possono utilizzare il BatchImportFindings operazione per creare nuove scoperte in AWS Security Hub CSPM. Possono anche utilizzare questa operazione per aggiornare i risultati che hanno creato. I fornitori di servizi di ricerca non possono aggiornare i risultati che non hanno creato.
I clienti, i SIEM, il ticketing, il SOAR e altri tipi di strumenti devono utilizzare BatchUpdateFindings operazione per apportare aggiornamenti relativi alla loro indagine sui risultati della ricerca di fornitori. Per ulteriori informazioni, consulta BatchUpdateFindings per i clienti.
Quando Security Hub CSPM riceve un BatchImportFindings richiesta di creare o aggiornare un risultato, genera automaticamente un Security Hub Findings
- Imported evento in Amazon EventBridge. Puoi intraprendere un'azione automatica su quell'evento. Per ulteriori informazioni, consulta Utilizzo EventBridge per la risposta e la correzione automatiche.
Prerequisiti per l'utilizzo di BatchImportFindings
BatchImportFindings deve essere chiamato da uno dei seguenti:
-
L'account associato ai risultati. L'identificatore dell'account associato deve corrispondere al valore di
AwsAccountIdattributo per il risultato. -
Un account consentito come integrazione ufficiale dei partner CSPM di Security Hub.
Security Hub CSPM può accettare la ricerca di aggiornamenti solo per gli account su cui Security Hub CSPM è abilitato. Anche il provider di risultati deve essere abilitato. Se Security Hub CSPM è disabilitato o l'integrazione del provider di ricerca non è abilitata, i risultati vengono restituiti nel FailedFindings elenco, con un InvalidAccess errore.
Determinazione per creare o aggiornare un risultato
Per determinare se creare o aggiornare un risultato, Security Hub CSPM controlla ID campo. Se il valore di ID non corrisponde a un risultato esistente, Security Hub CSPM crea un nuovo risultato.
Se ID corrisponde a un risultato esistente, Security Hub CSPM verifica UpdatedAt campo per l'aggiornamento e procede come segue:
-
Se
UpdatedAtl'aggiornamento corrisponde o si verifica primaUpdatedAtsulla base dei risultati esistenti, Security Hub CSPM ignora la richiesta di aggiornamento. -
Se
UpdatedAtl'aggiornamento avviene dopoUpdatedAtin base al risultato esistente, Security Hub CSPM aggiorna il risultato esistente.
Restrizioni alla ricerca di aggiornamenti con BatchImportFindings
I fornitori di ricerca non possono usare BatchImportFindings per aggiornare i seguenti attributi di un risultato esistente:
-
Note -
UserDefinedFields -
VerificationState -
Workflow
Security Hub CSPM ignora qualsiasi contenuto fornito in un BatchImportFindings richiesta di questi attributi. I clienti, o le entità che agiscono per loro conto (come gli strumenti di biglietteria), possono utilizzare BatchUpdateFindings per aggiornare questi attributi.
Aggiornamento dei risultati con FindingProviderFields
Inoltre, la ricerca di fornitori non dovrebbe essere BatchImportFindings per aggiornare i seguenti attributi di primo livello in AWS Security Finding Format (ASFF):
-
Confidence -
Criticality -
RelatedFindings -
Severity -
Types
Invece, la ricerca dei fornitori dovrebbe utilizzare il FindingProviderFields oggetto per fornire valori per questi attributi.
Esempio
"FindingProviderFields": { "Confidence": 42, "Criticality": 99, "RelatedFindings":[ { "ProductArn": "arn:aws:securityhub:us-west-2::product/aws/guardduty", "Id": "123e4567-e89b-12d3-a456-426655440000" } ], "Severity": { "Label": "MEDIUM", "Original": "MEDIUM" }, "Types": [ "Software and Configuration Checks/Vulnerabilities/CVE" ] }
Per BatchImportFindings le richieste, Security Hub CSPM gestisce i valori negli attributi di primo livello e in FindingProviderFields come segue.
- (Preferito)
BatchImportFindingsfornisce un valore per un attributo in FindingProviderFields, ma non fornisce un valore per l'attributo di primo livello corrispondente. -
Ad esempio
BatchImportFindingsfornisceFindingProviderFields.Confidence, ma non fornisceConfidence. Questa è l'opzione preferita perBatchImportFindingsrichieste.Security Hub CSPM aggiorna il valore dell'attributo in
FindingProviderFields.Replica il valore nell'attributo di primo livello solo se l'attributo non è già stato aggiornato da
BatchUpdateFindings. BatchImportFindingsfornisce un valore per un attributo di primo livello, ma non fornisce un valore per l'attributo corrispondente inFindingProviderFields.-
Ad esempio
BatchImportFindingsfornisceConfidence, ma non fornisceFindingProviderFields.Confidence.Security Hub CSPM utilizza il valore per aggiornare l'attributo in
FindingProviderFields. Sovrascrive qualsiasi valore esistente.Security Hub CSPM aggiorna l'attributo di primo livello solo se l'attributo non è già stato aggiornato da
BatchUpdateFindings. BatchImportFindingsfornisce un valore sia per un attributo di primo livello che per l'attributo corrispondente inFindingProviderFields.-
Ad esempio
BatchImportFindingsfornisce entrambiConfidenceeFindingProviderFields.Confidence.Per una nuova scoperta, Security Hub CSPM utilizza il valore in
FindingProviderFieldsper compilare sia l'attributo di primo livello che l'attributo corrispondente inFindingProviderFields. Non utilizza il valore dell'attributo di primo livello fornito.Per un risultato esistente, Security Hub CSPM utilizza entrambi i valori. Tuttavia, aggiorna il valore dell'attributo di primo livello solo se l'attributo non è già stato aggiornato da
BatchUpdateFindings.