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à.
Crea un modello di minaccia
Crea modelli di minaccia nell'applicazione web AWS Security Agent per analizzare l'architettura dell'applicazione e identificare le minacce alla sicurezza. Un modello di minaccia produce due risultati principali: una panoramica del sistema che descrive come è costruito e si comporta il sistema e una serie di minacce che descrive come il sistema potrebbe essere attaccato, ognuna con un livello di gravità, una classificazione STRIDE e raccomandazioni attuabili.
Un modello di minaccia accetta due tipi di input ed è possibile fornire uno o entrambi:
-
Documenti relativi all'ambito: documenti tecnici di progettazione, specifiche delle API o documentazione sull'architettura che definiscono gli aspetti su cui si concentra il modello di minaccia. Quando viene fornita, l'agente elabora l'analisi in base al contesto descritto in questi documenti. Puoi caricare file (DOC, DOCX, JPEG, MD, PDF, PNG, TXT), fornire URI S3 o connettere pagine Confluence tramite un'integrazione.
-
Sorgenti: codice sorgente proveniente da repository collegati ( GitHub Enterprise Server o GitHub Bitbucket) o da sedi GitLab S3 GitLab Self-Managed. AWS Security Agent legge il codice sorgente per comprendere il sistema esistente. Se combinato con i documenti di ambito, il codice sorgente fornisce un contesto sull'implementazione corrente.
In questa procedura, si crea un modello di minaccia configurandone gli input e le autorizzazioni, quindi si avvia una corsa.
Prerequisiti
Prima di iniziare, assicurati di disporre dei seguenti elementi:
-
Accesso all'applicazione Web AWS Security Agent
-
Almeno uno dei seguenti elementi:
-
Un repository connesso (GitHub GitHub Enterprise Server o Bitbucket) da utilizzare come sorgente (vedi) GitLab GitLab Self-Managed Abilita la modellazione delle minacce
-
Un bucket S3 contenente codice sorgente
-
Progetta documenti da caricare come documenti di riferimento o come integrazione con Confluence
-
Suggerimento
Se disponi già di repository o bucket S3 collegati a Agent Space (ad esempio, tramite la revisione del codice o la configurazione dei test di penetrazione), puoi creare immediatamente un modello di minaccia, senza richiedere alcuna configurazione aggiuntiva.
In che modo AWS Security Agent gestisce un modello di minaccia
Gli input forniti determinano il modo in cui AWS Security Agent esegue il modello di minaccia. Esistono tre scenari.
| Input forniti | In che modo AWS Security Agent gestisce il modello di minaccia |
|---|---|
|
Solo sorgenti (codice sorgente) |
AWS Security Agent analizza il codice sorgente per comprendere la struttura dell'applicazione, classifica i componenti, estrae i flussi di dati, crea un modello di minaccia e identifica le minacce in base a come il sistema è effettivamente implementato. |
|
Solo documenti Scope (documenti di progettazione) |
AWS Security Agent esegue un modello di minaccia incentrato sul design descritto nei tuoi documenti. Identifica le minacce in base all'architettura, ai flussi di dati e ai componenti descritti nei documenti relativi all'ambito, utili per modellare le minacce di un progetto prima che esista qualsiasi codice. |
|
Documenti relativi alle fonti e all'ambito |
AWS Security Agent analizza il modello di minaccia in base al contesto descritto nei documenti dell'ambito (ad esempio, un documento di progettazione per una nuova funzionalità). Utilizza il codice sorgente per comprendere il sistema esistente, quindi modella le minacce in base al design descritto nei documenti relativi all'ambito, indipendentemente dal fatto che tale progetto sia già implementato o meno. |
Accedi alla pagina dei modelli di minaccia
Vai alla sezione sulla modellazione delle minacce nell'applicazione web.
-
Accedi all'applicazione Web AWS Security Agent.
-
Nella barra laterale sinistra, scegli Threat models.
-
Viene visualizzato un elenco di modelli di minaccia esistenti con il relativo titolo, lo stato di esecuzione più recente e il numero di minacce per gravità.
Crea un modello di minaccia
Configura un nuovo modello di minaccia configurandone gli input e le autorizzazioni.
-
Nella pagina Modelli di minaccia, scegli Crea modello di minaccia.
Configura i dettagli del modello di minaccia
Fornisci un titolo per il tuo modello di minaccia.
-
Nel campo Titolo, inserisci un nome descrittivo per il tuo modello di minaccia.
Suggerimento
Usa un nome che identifichi l'applicazione o il servizio da modellare. Ad esempio, «billing-service» o «checkout-api».
Aggiungi documenti Scope
Fornisci i documenti tecnici di progettazione che definiscono su cosa si concentra il modello di minaccia, come la documentazione sull'architettura, le specifiche delle API o le proposte di progettazione. Quando vengono forniti i documenti relativi all'ambito, l'agente elabora l'analisi in base al contesto descritto in questi documenti. I documenti relativi all'ambito sono facoltativi se si forniscono le fonti.
-
Nella sezione Documenti Scope, aggiungi documenti utilizzando uno o più dei seguenti metodi:
-
Carica file: carica direttamente i documenti di progettazione (DOC, DOCX, JPEG, MD, PDF, PNG o TXT).
-
URI S3: inserisci gli URI S3 che puntano ai documenti archiviati nei bucket S3 collegati.
-
Pagine Confluence: se disponi di un'integrazione Confluence connessa a Agent Space, seleziona le pagine dall'area di lavoro Confluence.
-
Suggerimento
Per ottenere i migliori risultati, includi diagrammi di architettura, specifiche API e documentazione tecnica che descriva i componenti del sistema, i flussi di dati e i limiti di fiducia.
Aggiungi fonti
Seleziona il codice sorgente utilizzato da AWS Security Agent per comprendere il tuo sistema esistente. Se combinato con i documenti di ambito, il codice sorgente fornisce un contesto sull'implementazione corrente: l'agente lo utilizza per comprendere ciò che già esiste. Le fonti sono facoltative se si forniscono documenti di ambito.
-
Nella sezione Sorgenti, aggiungi il codice sorgente utilizzando uno o più dei seguenti metodi:
Archivi integrati
Seleziona tra i repository collegati al tuo Agent Space (GitHub GitHub Enterprise Server o GitLab Self-Managed Bitbucket). GitLab
-
Seleziona la casella di controllo accanto a ciascun repository che desideri includere come fonte.
-
Utilizza il campo di ricerca per trovare repository specifici per nome.
Nota
Qui vengono visualizzati solo i repository collegati al tuo Agent Space. Per aggiungere altri repository, chiedi al tuo amministratore di aggiornare la configurazione di Agent Space.
Sorgenti S3
Aggiungi URI S3 che puntano al codice sorgente memorizzato nei bucket S3 collegati.
-
Inserisci l'URI S3 per ogni posizione del codice sorgente che desideri includere.
Configurazione delle risorse AWS
Seleziona il ruolo del servizio IAM e il gruppo di CloudWatch log opzionale per questo modello di minaccia.
-
Nel menu a discesa Service role, seleziona il ruolo IAM dai ruoli di servizio configurati.
Nota
Il ruolo di servizio deve disporre delle autorizzazioni per accedere al codice sorgente in S3 e scrivere nei log. CloudWatch I ruoli di servizio vengono configurati durante la configurazione di Agent Space nella Console di gestione AWS.
-
(Facoltativo) Nel menu a discesa Log group, seleziona un gruppo di CloudWatch log per archiviare i log di esecuzione del modello di minaccia.
Crea il modello di minaccia
-
Verifica la configurazione.
-
Scegli Crea modello di minaccia.
Verrai reindirizzato alla pagina dei dettagli del modello di minaccia in cui puoi iniziare una corsa.
Esegui un modello di minaccia
Dopo aver creato un modello di minaccia, avvia un'esecuzione per iniziare l'analisi.
-
Nella pagina di dettaglio del modello di minaccia, scegli Avvia esecuzione.
-
AWS Security Agent inizia ad analizzare le fonti e i documenti relativi all'ambito.
Puoi anche avviare un'esecuzione dalla pagina di elenco dei modelli di minaccia selezionando Avvia esecuzione accanto al modello di minaccia che desideri eseguire.
Monitora l'esecuzione di un modello di minaccia
Tieni traccia dei progressi del tuo modello di minaccia man mano che viene eseguito.
Stato di esecuzione
L'intestazione della pagina di esecuzione mostra un indicatore di stato:
-
In corso: l'agente del modello di minaccia è in esecuzione.
-
Interruzione: è stato richiesto un annullamento; l'agente sta terminando l'attività corrente prima di interromperla.
-
Completata: l'esecuzione è stata completata correttamente.
-
Fallita: si è verificato un errore nell'esecuzione. Viene visualizzato un messaggio di errore con i dettagli. Inizia una nuova corsa dopo aver risolto il problema.
-
Interrotta: l'esecuzione è stata annullata dall'utente. Tutte le minacce generate prima dell'interruzione vengono preservate.
Esegui le schede delle pagine
Nella pagina dei dettagli di esecuzione, naviga tra le schede:
-
Panoramica: visualizza il riepilogo dell'esecuzione (ID del lavoro, ora di inizio, stato, durata) con un grafico a torta sui livelli di gravità che mostra la suddivisione delle minacce per gravità (critica, alta, media, bassa). Sotto il riepilogo, visualizza un grafico a barre delle categorie di minacce STRIDE che mostra quante minacce rientrano in ciascuna categoria STRIDE. Al termine dell'esecuzione, visualizza la panoramica del sistema prodotta dall'agente.
-
Configurazione: visualizza le fonti, i documenti e le autorizzazioni (ruolo del servizio, gruppo di CloudWatch log) utilizzati per questa esecuzione.
-
Preflight: visualizza lo stato dei controlli preliminari eseguiti prima dell'inizio dell'analisi delle minacce, inclusa la configurazione dell'infrastruttura di registrazione, la convalida dell'accesso alla sorgente S3 (se applicabile) e la configurazione dell'ambiente di test. Una barra di avanzamento mostra quanti controlli sono stati completati.
-
Registri: visualizza un elenco filtrabile delle attività eseguite dall'agente durante l'esecuzione. Seleziona un'attività per visualizzarne l'output dettagliato del registro in un pannello laterale.
-
Minacce: visualizza le minacce identificate durante l'esecuzione (vediEsamina le minacce partendo da un modello di minaccia).
Cronologia delle corse
Ogni modello di minaccia conserva una cronologia di tutte le esecuzioni. Nella pagina dei dettagli del modello di minaccia:
-
La tabella delle esecuzioni elenca tutte le esecuzioni con ora di inizio, stato, durata, numero di minacce e ID.
-
Scegli il link all'ora di inizio di una corsa per visualizzarne i dettagli completi.
Suggerimento
Re-run lo stesso modello di minaccia dopo aver aggiornato il codice sorgente o modificato i documenti relativi all'ambito per vedere come la panoramica del sistema e le minacce cambiano nel tempo.
Modifica un modello di minaccia
Per modificare la configurazione del modello di minaccia:
-
Nella pagina dei dettagli del modello di minaccia, scegli Modifica.
-
Aggiorna il titolo, i sorgenti, i documenti di ambito o le risorse AWS secondo necessità.
-
Scegli Save changes (Salva modifiche).
Nota
La modifica di un modello di minaccia non influisce sulle esecuzioni completate in precedenza. Questi conservano l'istantanea di configurazione utilizzata al momento dell'esecuzione.
Eliminare un modello di minaccia
Per eliminare un modello di minaccia e tutte le esecuzioni e le minacce associate:
-
Nella pagina di dettaglio del modello di minaccia, apri il menu delle azioni e scegli Elimina.
-
Conferma l’eliminazione.
Importante
Se è attualmente in corso un'esecuzione, è necessario interromperla prima di eliminare il modello di minaccia.
Fasi successive
Dopo aver eseguito un modello di minaccia:
-
Esamina la panoramica del sistema e le minacce (vediEsamina le minacce partendo da un modello di minaccia)
-
Re-run il modello di minaccia dopo aver apportato modifiche per verificare che le minacce siano state affrontate
-
Modifica le fonti e l'ambito dei documenti man mano che l'applicazione si evolve
