Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md).

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à.

# Proprietà SARIF supportate
<a name="test.sarif"></a>

Lo Static Analysis Results Interchange Format (SARIF) è un formato di file di output disponibile nell'analisi della composizione del software (SCA) e nei report di analisi statica in Amazon. CodeCatalyst L'esempio seguente mostra come configurare manualmente SARIF in un report di analisi statica:

```
Reports:
MySAReport:
Format: SARIFSA
IncludePaths:
    - output/sa_report.json
SuccessCriteria:
    StaticAnalysisFinding:
    Number: 25
    Severity: HIGH
```

CodeCatalyst supporta le seguenti proprietà SARIF che possono essere utilizzate per ottimizzare la visualizzazione dei risultati dell'analisi nei report.

**Topics**
+ [Oggetto `sarifLog`](#test.sarif.sarifLog)
+ [Oggetto `run`](#test.sarif.run)
+ [Oggetto `toolComponent`](#test.sarif.toolComponent)
+ [Oggetto `reportingDescriptor`](#test.sarif.reportingDescriptor)
+ [Oggetto `result`](#test.sarif.result)
+ [Oggetto `location`](#test.sarif.location)
+ [Oggetto `physicalLocation`](#test.sarif.physicalLocation)
+ [Oggetto `logicalLocation`](#test.sarif.logicalLocation)
+ [Oggetto `fix`](#test.sarif.fix)

## Oggetto `sarifLog`
<a name="test.sarif.sarifLog"></a>


| Nome | Richiesto | Descrizione | 
| --- | --- | --- | 
| `$schema` | Sì | [L'URI dello schema JSON SARIF per la versione 2.1.0.](https://json.schemastore.org/sarif-2.1.0.json) | 
| `version` | Sì | CodeCatalyst supporta solo la versione SARIF 2.1.0. | 
| `runs[]` | Sì | Un file SARIF contiene una matrice di una o più esecuzioni, ognuna delle quali rappresenta una singola esecuzione dello strumento di analisi. | 

## Oggetto `run`
<a name="test.sarif.run"></a>


| Nome | Richiesto | Descrizione | 
| --- | --- | --- | 
| `tool.driver` | Sì | Un `toolComponent` oggetto che descrive lo strumento di analisi. | 
| `tool.name` | No | Una proprietà che indica il nome dello strumento utilizzato per eseguire l'analisi. | 
| `results[]` | Sì | I risultati dello strumento di analisi visualizzati su CodeCatalyst. | 

## Oggetto `toolComponent`
<a name="test.sarif.toolComponent"></a>


| Nome | Richiesto | Descrizione | 
| --- | --- | --- | 
| `name` | Sì | Il nome dello strumento di analisi. | 
| `properties.artifactScanned` | No | Numero totale di artefatti analizzati dallo strumento. | 
| `rules[]` | Sì | Una serie di `reportingDescriptor` oggetti che rappresentano regole. In base a queste regole, lo strumento di analisi rileva problemi nel codice analizzato. | 

## Oggetto `reportingDescriptor`
<a name="test.sarif.reportingDescriptor"></a>


| Nome | Richiesto | Descrizione | 
| --- | --- | --- | 
| `id` | Sì | L'identificatore univoco della regola utilizzata per fare riferimento a un risultato.<br />Lunghezza massima: 1.024 caratteri | 
| `name` | No | Il nome visualizzato della regola.<br />Lunghezza massima: 1.024 caratteri | 
| `shortDescription.text` | No | Una breve descrizione della regola.<br />Lunghezza massima: 3.000 caratteri | 
| `fullDescription.text` | No | Una descrizione completa della regola.<br />Lunghezza massima: 3.000 caratteri | 
| `helpUri` | No | Una stringa che può essere localizzata per contenere l'URI assoluto della documentazione principale della regola.<br />Lunghezza massima: 3.000 caratteri | 
| `properties.unscore` | No | Un contrassegno che indica se il risultato della scansione è stato valutato. | 
| `properties.score.severity` | No | Un set fisso di stringhe che specificano il livello di gravità del risultato.<br />Lunghezza massima: 1.024 caratteri | 
| `properties.cvssv3_baseSeverity` | No | Una valutazione di gravità qualitativa del [Common Vulnerability Scoring](https://www.first.org/cvss/v3.1/specification-document) System v3.1. | 
| `properties.cvssv3_baseScore` | No | [Un punteggio di base CVSS v3 compreso tra 0,0 e 10,0.](https://nvd.nist.gov/vuln-metrics/cvss) | 
| `properties.cvssv2_severity` | No | Se i valori CVSS v3 non sono disponibili, cerca i valori CVSS v2. CodeCatalyst  | 
| `properties.cvssv2_score` | No | [Un punteggio di base CVSS v2 compreso tra 0,0 e 10,0.](https://nvd.nist.gov/vuln-metrics/cvss) | 
| `properties.severity` | No | Un insieme fisso di stringhe che specificano il livello di gravità del risultato.<br />Lunghezza massima: 1.024 caratteri | 
| `defaultConfiguration.level` | No | La severità predefinita di una regola. | 

## Oggetto `result`
<a name="test.sarif.result"></a>


| Nome | Richiesto | Descrizione | 
| --- | --- | --- | 
| `ruleId` | Sì | L'identificatore univoco della regola utilizzata per fare riferimento a un risultato.<br />Lunghezza massima: 1.024 caratteri | 
| `ruleIndex` | Sì | L'indice della regola associata nel componente `rules[]` utensile. | 
| `message.text` | Sì | Un messaggio che descrive il risultato e visualizza il messaggio per ogni risultato.<br />Lunghezza massima: 3.000 caratteri | 
| `rank` | No | Un valore compreso tra 0,0 e 100,0 inclusi che rappresenta la priorità o l'importanza del risultato. Il valore di questa scala è 0,0 come priorità più bassa e 100,0 come priorità più alta. | 
| `level` | No | La gravità del risultato.<br />Lunghezza massima: 1.024 caratteri | 
| `properties.unscore` | No | Un contrassegno che indica se il risultato della scansione è stato valutato. | 
| `properties.score.severity` | No | Un set fisso di stringhe che specificano il livello di gravità del risultato.<br />Lunghezza massima: 1.024 caratteri | 
| `properties.cvssv3_baseSeverity` | No | Una valutazione di gravità qualitativa del [Common Vulnerability Scoring](https://www.first.org/cvss/v3.1/specification-document) System v3.1. | 
| `properties.cvssv3_baseScore` | No | [Un punteggio di base CVSS v3 compreso tra 0,0 e 10,0.](https://nvd.nist.gov/vuln-metrics/cvss) | 
| `properties.cvssv2_severity` | No | Se i valori CVSS v3 non sono disponibili, cerca i valori CVSS v2. CodeCatalyst  | 
| `properties.cvssv2_score` | No | [Un punteggio di base CVSS v2 compreso tra 0,0 e 10,0.](https://nvd.nist.gov/vuln-metrics/cvss) | 
| `properties.severity` | No | Un insieme fisso di stringhe che specificano il livello di gravità del risultato.<br />Lunghezza massima: 1.024 caratteri | 
| `locations[]` | Sì | L'insieme di posizioni in cui è stato rilevato il risultato. È necessario includere solo una posizione, a meno che il problema non possa essere corretto solo apportando una modifica in ogni posizione specificata. CodeCatalyst utilizza il primo valore nell'array di posizione per annotare il risultato.<br />Numero massimo di `location` oggetti: 10 | 
| `relatedLocations[]` | No | Un elenco di riferimenti a località aggiuntivi inclusi nel risultato.<br />Numero massimo di `location` oggetti: 50 | 
| `fixes[]` | No | Una serie di `fix` oggetti che rappresentano la raccomandazione fornita dallo strumento di scansione. CodeCatalyst utilizza la prima raccomandazione dell'`fixes`array. | 

## Oggetto `location`
<a name="test.sarif.location"></a>


| Nome | Richiesto | Descrizione | 
| --- | --- | --- | 
| `physicalLocation` | Sì | Identifica l'artefatto e la regione. | 
| `logicalLocations[]` | No | L'insieme di posizioni descritte per nome senza riferimento all'artefatto. | 

## Oggetto `physicalLocation`
<a name="test.sarif.physicalLocation"></a>


| Nome | Richiesto | Descrizione | 
| --- | --- | --- | 
| `artifactLocation.uri` | Sì | L'URI che indica la posizione di un artefatto, in genere un file nel repository o generato durante una compilazione. | 
| `fileLocation.uri` | No | L'URI di riserva che indica la posizione del file. Viene utilizzato se i risultati `artifactLocation.uri` sono vuoti. | 
| `region.startLine` | Sì | Il numero di riga del primo carattere nella regione. | 
| `region.startColumn` | Sì | Il numero di colonna del primo carattere nella regione. | 
| `region.endLine` | Sì | Il numero di riga dell'ultimo carattere nella regione. | 
| `region.endColumn` | Sì | Il numero di colonna dell'ultimo carattere nella regione. | 

## Oggetto `logicalLocation`
<a name="test.sarif.logicalLocation"></a>


| Nome | Richiesto | Description | 
| --- | --- | --- | 
| `fullyQualifiedName` | No | Informazioni aggiuntive che descrivono la posizione del risultato.<br />Lunghezza massima: 1.024 caratteri | 

## Oggetto `fix`
<a name="test.sarif.fix"></a>


| Nome | Richiesto | Description | 
| --- | --- | --- | 
| `description.text` | No | Un messaggio che mostra un consiglio per ogni risultato.<br />Lunghezza massima: 3.000 caratteri | 
| `artifactChanges.[0].artifactLocation.uri` | No | L'URI che indica la posizione dell'elemento che deve essere aggiornato. |