Alerts - List

Service:: Advanced Security

Versione API:: 7.2-preview.1

Ottenere avvisi per un repository

GET https://advsec.dev.azure.com/{organization}/{project}/_apis/alert/repositories/{repository}/alerts?api-version=7.2-preview.1

Con parametri facoltativi:

GET https://advsec.dev.azure.com/{organization}/{project}/_apis/alert/repositories/{repository}/alerts?top={top}&orderBy={orderBy}&criteria.alertIds={criteria.alertIds}&criteria.alertType={criteria.alertType}&criteria.confidenceLevels={criteria.confidenceLevels}&criteria.dependencyName={criteria.dependencyName}&criteria.dependencyScope={criteria.dependencyScope}&criteria.epssPercentileMax={criteria.epssPercentileMax}&criteria.epssPercentileMin={criteria.epssPercentileMin}&criteria.fromDate={criteria.fromDate}&criteria.hasLinkedWorkItems={criteria.hasLinkedWorkItems}&criteria.isTriaged={criteria.isTriaged}&criteria.keywords={criteria.keywords}&criteria.licenseName={criteria.licenseName}&criteria.modifiedSince={criteria.modifiedSince}&criteria.onlyDefaultBranch={criteria.onlyDefaultBranch}&criteria.phaseId={criteria.phaseId}&criteria.phaseName={criteria.phaseName}&criteria.pipelineId={criteria.pipelineId}&criteria.pipelineName={criteria.pipelineName}&criteria.ref={criteria.ref}&criteria.ruleId={criteria.ruleId}&criteria.ruleName={criteria.ruleName}&criteria.severities={criteria.severities}&criteria.states={criteria.states}&criteria.toDate={criteria.toDate}&criteria.toolName={criteria.toolName}&criteria.toolNames={criteria.toolNames}&criteria.validity={criteria.validity}&expand={expand}&continuationToken={continuationToken}&api-version=7.2-preview.1

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path	True	string	ID progetto o nome progetto
repository	path	True	string	Nome o ID del repository
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.2-preview.1' per usare questa versione dell'API.
continuationToken	query		string	Se sono presenti più avvisi che possono essere restituiti, un token di continuazione viene inserito nell'intestazione "x-ms-continuationtoken". Usare questo token qui per ottenere la pagina successiva degli avvisi
criteria.alertIds	query		integer[]	Se specificato, restituisce solo avvisi con gli ID specificati. In caso contrario, restituisce qualsiasi avviso.
criteria.alertType	query		AlertType	Se specificato, restituisce solo avvisi di questo tipo. In caso contrario, restituire avvisi di tutti i tipi.
criteria.confidenceLevels	query		string[]	Se specificato, restituisce solo avvisi a questi livelli di attendibilità. È necessario specificare sia High che Other per recuperare gli avvisi di tutti i livelli di attendibilità. In caso contrario, restituire avvisi con livello di attendibilità elevato. Applicabile solo per gli avvisi segreti.
criteria.dependencyName	query		string	Se specificato, vengono restituiti solo gli avvisi per questa dipendenza. In caso contrario, restituire avvisi per tutte le dipendenze. In un invio sarif, viene specificata una dipendenza (o un componente) nel risultato. RelatedLocations[].logicalLocation. Non applicabile per gli avvisi segreti.
criteria.dependencyScope	query		DependencyScope	Se fornito, vengono restituiti solo gli avvisi per dipendenze in questo ambito. In caso contrario, restituire avvisi indipendentemente dall'ambito. Applicabile solo per gli avvisi di dipendenza.
criteria.epssPercentileMax	query		number (double)	Se specificato, vengono restituiti solo gli avvisi il cui avviso ha un percentile EPSS minore o uguale a questo valore. Gli avvisi senza metadati EPSS vengono esclusi quando viene fornito uno dei due limiti. Applicabile solo per gli avvisi di dipendenza.
criteria.epssPercentileMin	query		number (double)	Se specificato, vengono restituiti solo gli avvisi i cui avvisi hanno un percentile EPSS maggiore o uguale a questo valore. Gli avvisi senza metadati EPSS vengono esclusi quando viene fornito uno dei due limiti. Applicabile solo per gli avvisi di dipendenza.
criteria.fromDate	query		string (date-time)	Se specificato, restituisce solo gli avvisi visualizzati dopo questa data. In caso contrario, restituisce tutti gli avvisi.
criteria.hasLinkedWorkItems	query		boolean	Se specificato, filtra gli avvisi in base alla presenza di elementi di lavoro collegati. Impostare su "true" per restituire solo avvisi con elementi di lavoro collegati. Impostare su "false" per restituire solo avvisi senza elementi di lavoro collegati. Se non specificato, restituisce tutti gli avvisi indipendentemente dagli elementi di lavoro collegati. Non applicabile per gli avvisi di analisi delle dipendenze e dei segreti. Questa proprietà verrà deprecata in futuro; preferisce filtrare in base al tipo di metadati.
criteria.isTriaged	query		boolean	Se fornito con isTriaged, restituisce solo avvisi che sono stati eseguiti. In caso contrario, restituire avvisi indipendentemente dallo stato di valutazione.
criteria.keywords	query		string	Se specificato, restituisce solo avvisi i cui titoli corrispondono a questo modello.
criteria.licenseName	query		string	Se specificato, vengono restituiti solo gli avvisi creati per la dipendenza con questa licenza. In caso contrario, restituire avvisi per tutte le licenze. In un invio sarif, la licenza per una dipendenza (o un componente) viene specificata nel risultato. RelatedLocations[].logicalLocation.properties.license. Non applicabile per gli avvisi segreti.
criteria.modifiedSince	query		string (date-time)	Se specificato, restituisce solo avvisi modificati dopo questa data. In caso contrario, restituisce tutti gli avvisi.
criteria.onlyDefaultBranch	query		boolean	Se true o non è impostato, restituisce solo avvisi trovati nel ramo predefinito del repository. Se non sono state eseguite esecuzioni completate nel ramo predefinito, l'ultima esecuzione viene usata invece indipendentemente dal ramo usato per tale esecuzione. Se false, restituisce avvisi da tutti i rami. Questa opzione viene ignorata se viene specificato ref. Non applicabile per gli avvisi segreti.
criteria.phaseId	query		string (uuid)	Se fornito con pipelineName, restituisce solo gli avvisi rilevati in questa fase della pipeline In caso contrario, vengono restituiti avvisi rilevati in tutte le fasi. Non applicabile per gli avvisi segreti.
criteria.phaseName	query		string	Se fornito con pipelineName, restituisce solo gli avvisi rilevati in questa fase della pipeline In caso contrario, vengono restituiti avvisi rilevati in tutte le fasi. Non applicabile per gli avvisi segreti.
criteria.pipelineId	query		integer (int32)	Se fornito con pipelineId, restituisce solo gli avvisi rilevati in questa pipeline In caso contrario, restituire gli avvisi rilevati in tutte le pipeline.
criteria.pipelineName	query		string	Se specificato, restituisce solo gli avvisi rilevati in questa pipeline. In caso contrario, restituire gli avvisi rilevati in tutte le pipeline. Non applicabile per gli avvisi segreti.
criteria.ref	query		string	Se specificato, includere solo avvisi per questo riferimento. Se non viene specificato e OnlyDefaultBranch è true, includere solo gli avvisi trovati nel ramo predefinito o nell'ultimo ramo di esecuzione se non è disponibile alcuna configurazione di analisi per il ramo predefinito. In caso contrario, includere avvisi da tutti i rami. Non applicabile per gli avvisi segreti.
criteria.ruleId	query		string	Se specificato, restituisce solo avvisi per questa regola. In caso contrario, restituire avvisi di tutte le regole.
criteria.ruleName	query		string	Se specificato, restituisce solo avvisi per questa regola. In caso contrario, restituire avvisi per tutte le regole.
criteria.severities	query		string[]	Se specificato, restituisce solo avvisi con questi livelli di gravità. In caso contrario, restituire avvisi con qualsiasi gravità.
criteria.states	query		string[]	Se specificato, restituisce solo avvisi in questi stati. In caso contrario, restituire avvisi in qualsiasi stato.
criteria.toDate	query		string (date-time)	Se specificato, restituisce solo gli avvisi visualizzati prima di questa data. In caso contrario, restituisce tutti gli avvisi.
criteria.toolName	query		string	Se fornito con toolName, restituisce solo gli avvisi rilevati da questo strumento. In caso contrario, restituire gli avvisi rilevati da tutti gli strumenti.
criteria.toolNames	query		string[]	Se forniti, rispondi solo agli avvisi rilevati da questi strumenti. Ha la precedenza su ToolName quando viene popolato. Richiede il flag di funzionalità EnableMultiToolSelection.
criteria.validity	query		string[]	Se specificato, restituisce solo avvisi con la validità specificata qui. Se lo stato di validità è Sconosciuto, recuperare gli avvisi di tutti i risultati di validità. Applicabile solo per gli avvisi segreti. Il filtro in base allo stato di validità può causare la restituzione di meno avvisi rispetto a quelli richiesti con il parametro TOP. A causa di questo comportamento, è necessario basare l'>ContinuationToken(]] nell'intestazione della risposta per decidere se è necessario recuperare un altro batch.
expand	query		AlertListExpandOption
orderBy	query		string	Deve essere "id" "firstSeen" "lastSeen" "fixedOn" o "severity" Il valore predefinito è "id"
top	query		integer (int32)	Numero massimo di avvisi da restituire

Risposte

Nome	Tipo	Descrizione
200 OK	Alert[]	operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Ambiti

Nome	Descrizione
vso.advsec	Concede la possibilità di leggere avvisi, istanze dei risultati, istanze dei risultati dell'analisi

Definizioni

Nome	Descrizione
Alert
AlertListExpandOption
AlertType	Tipo di avviso. Ad esempio segreto, codice e così via.
AlertValidityInfo	Dati di validità per un avviso che farà parte delle API degli avvisi e dell'interfaccia utente.
AlertValidityStatus
Confidence	Livello di confidenza dell'avviso.
DependencyKind	Tipo di dipendenza di questa posizione logica.
DependencyScope	Se fornito, vengono restituiti solo gli avvisi per dipendenze in questo ambito. In caso contrario, restituire avvisi indipendentemente dall'ambito. Applicabile solo per gli avvisi di dipendenza.
Dismissal	Informazioni sulla chiusura di un avviso
DismissalType	Motivo del licenziamento
IdentityRef
License	Informazioni sulla licenza per le dipendenze
LicenseState	Stato della licenza
LicenseType	Tipo di licenza
LogicalLocation
PhysicalLocation	Posizione nel sistema di controllo del codice sorgente in cui è stato rilevato il problema
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
Region
RelationMetadata	Metadati da associare all'avviso.
Rule	Regola di analisi che ha causato l'avviso.
Severity	Gravità dell'avviso.
State	Questo valore viene calcolato e restituito dal servizio. Si tratta di un valore basato sui risultati di tutte le configurazioni di analisi.
Tool	Strumento di analisi in grado di generare avvisi di sicurezza
ValidationFingerprint
ValidationResult	Risultato della convalida.
VersionControlDetails	Informazioni per l'individuazione dei file in un sistema di controllo del codice sorgente

Alert

Oggetto

Nome	Tipo	Descrizione
additionalInformationMessage	string	Messaggio di informazioni aggiuntive da mostrare per questo avviso. Per gli strumenti ASAN, contiene dettagli di crash formattati in blocchi di codice. Per gli strumenti di scansione del codice IA, contiene contenuti markdown da risult.message.markdown.
additionalProperties	object	Proprietà aggiuntive dell'avviso.
alertId	integer (int64)	Identificatore dell'avviso. È univoco all'interno dell'organizzazione di Azure DevOps.
alertType	AlertType	Tipo di avviso. Ad esempio segreto, codice e così via.
confidence	Confidence	Livello di confidenza dell'avviso.
dismissal	Dismissal	Contiene informazioni per la chiusura dell'avviso se l'avviso è stato ignorato.
epssPercentile	number (double)	Classificazione (0-1) di EpssScore rispetto a tutti gli avvisi con punteggio. Null quando non sono disponibili metadati EPSS per l'avviso.
epssScore	number (double)	Probabilità EPSS (0-1) che l'avviso alla base di questo avviso di dipendenza verrà sfruttato nei prossimi 30 giorni. Null quando non sono disponibili metadati EPSS per l'avviso.
firstSeenDate	string (date-time)	Questo valore viene calcolato e restituito dal servizio. Questo valore rappresenta la prima volta che il servizio ha rilevato questo problema in un'istanza di analisi.
fixedDate	string (date-time)	Questo valore viene calcolato e restituito dal servizio. Se il problema è stato risolto, questo valore rappresenta il momento in cui il servizio ha rilevato questo problema risolto in un'istanza di analisi.
gitRef	string	Riferimento a un oggetto Git, ad esempio riferimento al ramo.
hasTrustedSourceOrigin	boolean	Il valore indica se l'avviso proviene da un SARIF caricato da una fonte affidabile.
introducedDate	string (date-time)	Questo valore viene calcolato e restituito dal servizio. Questo valore rappresenta la prima volta che è stata introdotta la vulnerabilità.
isAutoFixable	boolean	Il valore indica se Copilot prefisso automatico può essere attualmente eseguito nell'avviso. True quando Copilot prefisso automatico è disponibile per l'organizzazione e abilitato nel repository, l'avviso è di un tipo idoneo. Null quando il valore non è stato calcolato per questo percorso di codice.
isDevDependency	boolean	Il valore indica se l'avviso è stato generato per una dipendenza da sviluppo. True indica dipendenza dallo sviluppo, false indica dipendenza a runtime, e null indica sconosciuto o non applicabile.
lastSeenDate	string (date-time)	Questo valore viene calcolato e restituito dal servizio. Questo valore rappresenta l'ultima volta che il servizio ha rilevato questo problema in un'istanza di analisi.
logicalLocations	LogicalLocation[]	Posizioni logiche per l'avviso. Questo valore viene calcolato e restituito dal servizio. Si tratta di un valore basato sui risultati di tutte le configurazioni di analisi. Un esempio di posizione logica è un componente.
physicalLocations	PhysicalLocation[]	Questo valore viene calcolato e restituito dal servizio. Si tratta di un valore basato sui risultati di tutte le configurazioni di analisi. Un esempio di percorso fisico è un percorso di file.
projectId	string (uuid)	Identificatore del progetto in cui è stato rilevato l'avviso.
relations	RelationMetadata[]	Relazioni tra avvisi e altri artefatti.
repositoryId	string	Identificatore del repository in cui è stato rilevato l'avviso.
repositoryUrl	string	URL del repository in cui è stato rilevato l'avviso.
severity	Severity	Gravità dell'avviso.
state	State	Questo valore viene calcolato e restituito dal servizio. Si tratta di un valore basato sui risultati di tutte le configurazioni di analisi.
title	string	Il rendering del titolo verrà eseguito solo come testo e non supporta la formattazione markdown. È previsto un limite massimo di caratteri pari a 512.
tools	Tool[]	Strumenti che hanno rilevato questo problema.
truncatedSecret	string	Versione troncata/offuscata del segreto relativo all'avviso (se applicabile).
validationFingerprints	ValidationFingerprint[]	ValidationFingerprints per il controllo dell'attività segreta. Restituito solo su richiesta in Get API with Expand parameter set to be ValidationFingerprint (not returned in List API)
validityDetails	AlertValidityInfo	Dettagli di validità di un avviso. Attualmente, questo è applicabile solo agli avvisi segreti. In caso di avvisi segreti, lo stato di validità e l'ora vengono calcolati esaminando i risultati della dinamica per le impronte digitali di convalida associate a un avviso.

AlertListExpandOption

Enumerazione

Valore	Descrizione
none	Nessuna espansione.
minimal	Restituisce una rappresentazione minima di un avviso.
count	Restituisce solo il numero di avvisi attivi raggruppati per tipo di avviso.

AlertType

Enumerazione

Tipo di avviso. Ad esempio segreto, codice e così via.

Valore	Descrizione
unknown	Il codice presenta un tipo di vulnerabilità non specificato
dependency	Il codice usa una dipendenza con una vulnerabilità nota.
secret	Il codice contiene un segreto che è stato compromesso e deve essere revocato.
code	Il codice contiene una debolezza determinata dall'analisi statica.
aiCode	Il codice contiene una debolezza determinata da un'analisi basata sull'IA.
malware	Il codice usa una dipendenza contrassegnata come malware dal database consultivo GitHub.

AlertValidityInfo

Oggetto

Dati di validità per un avviso che farà parte delle API degli avvisi e dell'interfaccia utente.

Nome	Tipo	Descrizione
validityLastCheckedDate	string (date-time)
validityStatus	AlertValidityStatus

AlertValidityStatus

Enumerazione

Valore	Descrizione
none	Quando all'avviso non sono associate impronte digitali di convalida.
unknown	Quando le convalide per le impronte digitali di convalida associate all'avviso non sono state conclusive.
active	Quando almeno un'impronta digitale di convalida associata all'avviso è sfruttabile.
inactive	Quando tutte le impronte digitali di convalida associate all'avviso non sono sfruttabili.

Confidence

Enumerazione

Livello di confidenza dell'avviso.

Valore	Descrizione
high	Livello di attendibilità elevato per l'avviso
other	Altro livello di attendibilità per l'avviso

DependencyKind

Enumerazione

Tipo di dipendenza di questa posizione logica.

Valore	Descrizione
unknown
rootDependency	La dipendenza radice ha introdotto il componente che viene avvisato.
component	Componente che viene avvisato.
vulnerableDependency	Dipendenza vulnerabile. Deprecazione di questo valore. Usare invece Componente.

DependencyScope

Enumerazione

Se fornito, vengono restituiti solo gli avvisi per dipendenze in questo ambito.
In caso contrario, restituire avvisi indipendentemente dall'ambito.
Applicabile solo per gli avvisi di dipendenza.

Valore	Descrizione
runtime
development

Dismissal

Oggetto

Informazioni sulla chiusura di un avviso

Nome	Tipo	Descrizione
dismissalId	integer (int64)	ID univoco per questa chiusura
dismissalType	DismissalType	Motivo del licenziamento
message	string	Messaggio informativo associato alla chiusura
stateChangedBy	string (uuid)	Identità che ha ignorato l'avviso
stateChangedByIdentity	IdentityRef	Identità che ha ignorato l'avviso

DismissalType

Enumerazione

Motivo del licenziamento

Valore	Descrizione
unknown	Tipo ignorato sconosciuto
fixed	Chiusura che indica che l'avviso è stato risolto
acceptedRisk	Ignora che indica che l'utente accetta un rischio per l'avviso
falsePositive	Ignora che indica che l'avviso è un falso positivo e probabilmente non verrà corretto.
agreedToGuidance	Ignora che indica che l'utente accetta di seguire le indicazioni sulle licenze.
toolUpgrade	Ignora che indica che lo strumento di rilevamento back-end è stato aggiornato e l'avviso non viene rilevato dalla nuova versione dello strumento.
notDistributed	Ignora che indica che la dipendenza interessata non viene distribuita agli utenti finali.

IdentityRef

Oggetto

Nome	Tipo	Descrizione
_links	ReferenceLinks	Questo campo contiene zero o più collegamenti interessanti sull'oggetto grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate sull'oggetto grafico.
descriptor	string	Il descrittore è il modo principale per fare riferimento all'oggetto del grafo mentre il sistema è in esecuzione. Questo campo identificherà in modo univoco lo stesso soggetto del grafico in account e organizzazioni.
directoryAlias	string	Deprecato: può essere recuperato eseguendo una query sull'utente graph a cui si fa riferimento nella voce "self" del dizionario IdentityRef "_links"
displayName	string	Si tratta del nome visualizzato non univoco dell'oggetto del grafico. Per modificare questo campo, è necessario modificarne il valore nel provider di origine.
id	string
imageUrl	string	Deprecato : disponibile nella voce "avatar" del dizionario IdentityRef "_links"
inactive	boolean	Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza graph a cui si fa riferimento nella voce "membershipState" del dizionario "_links" GraphUser
isAadIdentity	boolean	Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Deprecato: non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef
uniqueName	string	Deprecato: usare invece Domain+PrincipalName
url	string	Questo URL è la route completa alla risorsa di origine di questo oggetto grafico.

License

Oggetto

Informazioni sulla licenza per le dipendenze

Nome	Tipo	Descrizione
name	string	Nome licenza
state	LicenseState	Stato della licenza
type	LicenseType	Tipo di licenza
url	string	URL per le informazioni sulla licenza

LicenseState

Enumerazione

Stato della licenza

Valore	Descrizione
unknown	Le informazioni della licenza non sono state raccolte da ClearlyDefined
notHarvested	Le informazioni della licenza non sono state raccolte da ClearlyDefined
harvested	Le informazioni della licenza sono state raccolte da ClearlyDefined

LicenseType

Enumerazione

Tipo di licenza

Valore	Descrizione
unknown	Il tipo di licenza è sconosciuto o non specificato.
permissive	Una licenza permissiva consente al software di essere liberamente usato, modificato e distribuito con restrizioni minime. Esempi: MIT, Apache 2.0.
weakCopyleft	Una licenza copyleft debole richiede modifiche al software da condividere con la stessa licenza, ma non impone restrizioni a lavori più grandi che includono il software. Esempi: LGPL.
strongCopyleft	Una licenza copyleft avanzata richiede che tutte le opere derivate o più grandi che includono il software devono essere distribuite anche con la stessa licenza. Esempi: GPL.
networkCopyleft	Una licenza copyleft di rete estende il requisito copyleft al software a cui si accede in rete, richiedendo che il codice sorgente sia reso disponibile. Esempi: AGPL.
other	Una licenza che non rientra nelle categorie standard o è definita in modo personalizzato. In CG indica una licenza commerciale.
noAssertion	Non viene eseguita alcuna asserzione sul tipo di licenza, lasciandola non specificata.

LogicalLocation

Oggetto

Nome	Tipo	Descrizione
fullyQualifiedName	string
kind	DependencyKind	Tipo di dipendenza di questa posizione logica.
license	License	Informazioni sulla licenza per Dependency Only applicabili quando Kind è "Component" e alertType dell'avviso con questo percorso è License

PhysicalLocation

Oggetto

Posizione nel sistema di controllo del codice sorgente in cui è stato rilevato il problema

Nome	Tipo	Descrizione
additionalProperties	object	Proprietà aggiuntive per cui è stato trovato il problema
filePath	string	Percorso del file in cui è stato trovato il problema
isValidGitPath	boolean	Indica se il percorso è un percorso Git valido presente nel repository Git associato all'avviso.
region	Region	Informazioni dettagliate sulla posizione in cui è stato trovato il problema, incluso un frammento di codice
versionControl	VersionControlDetails	Informazioni specifiche del sistema di controllo del codice sorgente sulla posizione

ReferenceLinks

Oggetto

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

Region

Oggetto

Nome	Tipo	Descrizione
columnEnd	integer (int32)	Colonna in cui termina il frammento di codice
columnStart	integer (int32)	Colonna in cui viene avviato il frammento di codice
lineEnd	integer (int32)	Numero di riga in cui termina il frammento di codice
lineStart	integer (int32)	Numero di riga in cui viene avviato il frammento di codice

RelationMetadata

Oggetto

Metadati da associare all'avviso.

Nome	Tipo	Descrizione
attributes	object	Eventuali attributi aggiuntivi dei metadati.
properties	object	Proprietà dei metadati.
rel	string	Tipo dei metadati.
url	string	URL dei metadati.

Rule

Oggetto

Regola di analisi che ha causato l'avviso.

Nome	Tipo	Descrizione
additionalProperties	object	Proprietà aggiuntive di questa regola dipendenti dal tipo di regola. Ad esempio, le regole di dipendenza possono includere l'ID CVE, se disponibile.
description	string	Descrizione di ciò che questa regola rileva
friendlyName	string	Identificatore di regola testo normale
helpMessage	string	Informazioni aggiuntive su questa regola
opaqueId	string	Identificatore di regola specifico dello strumento
resources	string	Elenco di risorse formattato markdown per altre informazioni sulla regola. In alcuni casi, viene invece usato RuleInfo.AdditionalProperties.advisoryUrls.
tags	string[]	Tag di classificazione per questa regola

Severity

Enumerazione

Gravità dell'avviso.

Valore	Descrizione
low
medium
high
critical
note
warning
error
undefined

State

Enumerazione

Questo valore viene calcolato e restituito dal servizio. Si tratta di un valore basato sui risultati di tutte le configurazioni di analisi.

Valore	Descrizione
unknown	L'avviso è in uno stato indeterminato
active	L'avviso è stato rilevato nel codice
dismissed	Avviso ignorato da un utente
fixed	Il problema non viene più rilevato nel codice
autoDismissed	Lo strumento ha determinato che il problema non è più un rischio
draft	Alert è in stato di bozza ed è visibile solo alle identità presenti nella lista privilegiata di Advanced Security draft-alert. Filtrato da tutti i Ricevi risposte di avviso (risultati e conteggi) per i chiamanti non privilegiati.

Tool

Oggetto

Strumento di analisi in grado di generare avvisi di sicurezza

Nome	Tipo	Descrizione
isDeterministic	boolean	Se lo strumento produce risultati deterministici. Usato per raggruppare gli strumenti nell'interfaccia del filtro degli allarmi.
name	string	Nome dello strumento
rules	Rule[]	Regole definite dallo strumento
toolVersion	string	Rappresentazione di stringa della versione dello strumento

ValidationFingerprint

Oggetto

Nome	Tipo	Descrizione
assetFingerprint	object	Rappresentazione del valore della chiave dell'impronta digitale dell'asset.
c3Id	string	Rappresenta CrossCompanyCorrelatingId per il segreto in ValidationFingerprintJson.
normalizedValidationToolVersion	integer (int32)	Rappresentazione di stringa normalizzata della versione dello strumento di convalida.
validationFingerprintHash	string	Hash associato al segreto.
validationFingerprintJson	string	Rappresentazione JSON del segreto. Tenere presente che questo campo può contenere il segreto nel formato non crittografato. Prestare attenzione quando si usa questo campo.
validityLastUpdatedDate	string (date-time)	Data dell'ultimo aggiornamento della validità.
validityResult	ValidationResult	Risultato della convalida.

ValidationResult

Enumerazione

Risultato della convalida.

Valore	Descrizione
none	Valore predefinito, non è possibile dedurre informazioni sul segreto.
exploitable	Rappresenta un segreto che può essere utilizzato per connettersi a una risorsa.
notExploitable	Rappresenta un segreto che non può essere usato per connettersi a una risorsa.
inconclusive	Rappresenta un segreto in cui non è possibile determinare la sua sfruttabilità.
validationNotSupported	Rappresenta un segreto in cui non è possibile convalidare, ad esempio un validator dinamico mancante.
transientError	Rappresenta un segreto in cui il processo di convalida non è riuscito a causa di un errore temporaneo, ad esempio un problema di rete. Questo risultato indica che il processo di convalida deve essere ritentato.

VersionControlDetails

Oggetto

Informazioni per l'individuazione dei file in un sistema di controllo del codice sorgente

Nome	Tipo	Descrizione
commitHash	string
itemUrl	string

Commenti e suggerimenti

Questa pagina è stata utile?