Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Erstellen Sie ein Bedrohungsmodell
Erstellen Sie Bedrohungsmodelle in der AWS Security Agent-Webanwendung, um die Architektur Ihrer Anwendung zu analysieren und Sicherheitsbedrohungen zu identifizieren. Ein Bedrohungsmodell liefert zwei Hauptergebnisse: eine Systemübersicht, die beschreibt, wie Ihr System aufgebaut ist und sich verhält, und eine Reihe von Bedrohungen, die beschreiben, wie das System angegriffen werden könnte, jeweils mit einem Schweregrad, einer STRIDE-Klassifizierung und umsetzbaren Empfehlungen.
Ein Bedrohungsmodell akzeptiert zwei Arten von Eingaben, und Sie können eine oder beide angeben:
-
Dokumente zum Umfang — Dokumente zum technischen Design, API-Spezifikationen oder Architekturdokumentationen, die definieren, worauf sich das Bedrohungsmodell konzentriert. Sofern bereitgestellt, beschränkt der Agent seine Analyse auf den in diesen Dokumenten beschriebenen Kontext. Sie können Dateien hochladen (DOC, DOCX, JPEG, MD, PDF, PNG, TXT), S3-URIs bereitstellen oder Confluence-Seiten über eine Integration verbinden.
-
Quellen — Quellcode aus verbundenen Repositorys (GitHub, GitHub Enterprise Server, GitLab GitLab Self-Managed, oder Bitbucket) oder von S3-Standorten. Der AWS Security Agent liest den Quellcode, um Ihr bestehendes System zu verstehen. In Kombination mit den Scope-Dokumenten bietet der Quellcode einen Kontext zur aktuellen Implementierung.
In diesem Verfahren erstellen Sie ein Bedrohungsmodell, indem Sie dessen Eingaben und Berechtigungen konfigurieren, und starten dann eine Ausführung.
Voraussetzungen
Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:
-
Zugriff auf die AWS Security Agent-Webanwendung
-
Mindestens eine der folgenden Optionen:
-
Ein verbundenes Repository (GitHub, GitHub Enterprise Server, GitLab GitLab Self-Managed, oder Bitbucket), das als Quelle verwendet werden soll (sieheBedrohungsmodellierung aktivieren)
-
Ein S3-Bucket, der Quellcode enthält
-
Entwerfen Sie Dokumente, die als Scope-Dokumente oder als Confluence-Integration hochgeladen werden können
-
Tipp
Wenn Sie bereits Repositorys oder S3-Buckets mit Ihrem Agent Space verbunden haben (z. B. durch die Einrichtung von Codeüberprüfungen oder Penetrationstests), können Sie sofort ein Bedrohungsmodell erstellen — es ist keine zusätzliche Einrichtung erforderlich.
Wie AWS Security Agent ein Bedrohungsmodell ausführt
Die von Ihnen bereitgestellten Eingaben bestimmen, wie der AWS Security Agent das Bedrohungsmodell ausführt. Es gibt drei Szenarien.
| Eingaben, die Sie bereitstellen | So führt AWS Security Agent das Bedrohungsmodell aus |
|---|---|
|
Nur Quellen (Quellcode) |
AWS Security Agent analysiert den Quellcode, um die Struktur Ihrer Anwendung zu verstehen, klassifiziert Komponenten, extrahiert Datenflüsse, erstellt ein Bedrohungsmodell und identifiziert Bedrohungen auf der Grundlage der tatsächlichen Implementierung des Systems. |
|
Nur Dokumente zum Geltungsbereich (Entwurfsdokumente) |
AWS Security Agent führt ein Bedrohungsmodell aus, das sich auf das in Ihren Dokumenten beschriebene Design konzentriert. Es identifiziert Bedrohungen auf der Grundlage der Architektur, der Datenflüsse und der Komponenten, die in den Umfangsdokumenten beschrieben sind. Dies ist nützlich, um ein Bedrohungsmodell zu modellieren, bevor Code existiert. |
|
Sowohl Quellen als auch Dokumente zum Geltungsbereich |
AWS Security Agent ordnet das Bedrohungsmodell dem in den Geltungsbereichsdokumenten beschriebenen Kontext zu (z. B. einem Entwurfsdokument für eine neue Funktion). Es verwendet den Quellcode, um Ihr bestehendes System zu verstehen, und modelliert dann das in den Scope-Dokumenten beschriebene Design — unabhängig davon, ob dieses Design bereits implementiert ist oder nicht. |
Rufen Sie die Seite mit den Bedrohungsmodellen auf
Navigieren Sie in der Webanwendung zum Bereich Bedrohungsmodellierung.
-
Melden Sie sich bei der AWS Security Agent-Webanwendung an.
-
Wählen Sie in der linken Seitenleiste Bedrohungsmodelle aus.
-
Sie sehen eine Liste vorhandener Bedrohungsmodelle mit ihrem Titel, dem Status der letzten Ausführung und der Anzahl der Bedrohungen nach Schweregrad.
Erstellen Sie ein Bedrohungsmodell
Richten Sie ein neues Bedrohungsmodell ein, indem Sie dessen Eingaben und Berechtigungen konfigurieren.
-
Wählen Sie auf der Seite Bedrohungsmodelle die Option Bedrohungsmodell erstellen aus.
Konfigurieren Sie die Details zum Bedrohungsmodell
Geben Sie einen Titel für Ihr Bedrohungsmodell ein.
-
Geben Sie im Feld Titel einen aussagekräftigen Namen für Ihr Bedrohungsmodell ein.
Tipp
Verwenden Sie einen Namen, der die Anwendung oder den Dienst identifiziert, der modelliert wird. Zum Beispiel „Billing-Service“ oder „Checkout-API“.
Dokumente zum Geltungsbereich hinzufügen
Stellen Sie die technischen Entwurfsdokumente bereit, die definieren, worauf sich das Bedrohungsmodell konzentriert, z. B. Architekturdokumentation, API-Spezifikationen oder Designvorschläge. Wenn Dokumente zum Umfang bereitgestellt werden, beschränkt der Agent seine Analyse auf den in diesen Dokumenten beschriebenen Kontext. Scope-Dokumente sind optional, wenn Sie Quellen angeben.
-
Fügen Sie im Abschnitt Scope-Dokumente Dokumente mit einer oder mehreren der folgenden Methoden hinzu:
-
Dateien hochladen — Laden Sie Designdokumente direkt hoch (DOC, DOCX, JPEG, MD, PDF, PNG oder TXT).
-
S3-URIs — Geben Sie S3-URIs ein, die auf Dokumente verweisen, die in verbundenen S3-Buckets gespeichert sind.
-
Confluence-Seiten — Wenn Sie eine Confluence-Integration mit Ihrem Agent Space verbunden haben, wählen Sie Seiten aus Ihrem Confluence-Workspace aus.
-
Tipp
Um optimale Ergebnisse zu erzielen, fügen Sie Architekturdiagramme, API-Spezifikationen und technische Unterlagen hinzu, die die Komponenten, Datenflüsse und Vertrauensgrenzen Ihres Systems beschreiben.
Fügen Sie Quellen hinzu
Wählen Sie den Quellcode aus, den AWS Security Agent verwendet, um Ihr bestehendes System zu verstehen. In Kombination mit den Scope-Dokumenten bietet der Quellcode einen Kontext zur aktuellen Implementierung — der Agent verwendet ihn, um zu verstehen, was bereits existiert. Quellen sind optional, wenn Sie Scope-Dokumente bereitstellen.
-
Fügen Sie im Abschnitt Quellen Quellcode mit einer oder mehreren der folgenden Methoden hinzu:
Integrierte Repositorys
Wähle aus Repositorys, die mit deinem Agent Space (GitHub, GitHub Enterprise Server, GitLab GitLab Self-Managed, oder Bitbucket) verbunden sind.
-
Markiere das Kästchen neben jedem Repository, das du als Quelle einbeziehen möchtest.
-
Verwenden Sie das Suchfeld, um bestimmte Repositorys anhand des Namens zu finden.
Anmerkung
Hier werden nur Repositorys angezeigt, die mit Ihrem Agent Space verbunden sind. Um weitere Repositorys hinzuzufügen, bitten Sie Ihren Administrator, die Agent Space-Konfiguration zu aktualisieren.
S3-Quellen
Fügen Sie S3-URIs hinzu, die auf Quellcode verweisen, der in verbundenen S3-Buckets gespeichert ist.
-
Geben Sie den S3-URI für jeden Quellcode-Speicherort ein, den Sie einbeziehen möchten.
AWS-Ressourcen konfigurieren
Wählen Sie die IAM-Servicerolle und die optionale CloudWatch Protokollgruppe für dieses Bedrohungsmodell aus.
-
Wählen Sie in der Dropdownliste Servicerolle die IAM-Rolle aus Ihren konfigurierten Servicerollen aus.
Anmerkung
Die Servicerolle muss über Berechtigungen verfügen, um auf Ihren Quellcode in S3 zuzugreifen und in Protokolle zu CloudWatch schreiben. Servicerollen werden während der Einrichtung von Agent Space in der AWS-Managementkonsole konfiguriert.
-
(Optional) Wählen Sie in der Dropdownliste Protokollgruppe eine CloudWatch Protokollgruppe aus, in der Ausführungsprotokolle für das Bedrohungsmodell gespeichert werden sollen.
Erstellen Sie das Bedrohungsmodell
-
Überprüfen Sie die Sicherheitskonfiguration.
-
Wählen Sie Bedrohungsmodell erstellen aus.
Sie werden auf die Detailseite des Bedrohungsmodells weitergeleitet, auf der Sie einen Testlauf starten können.
Führen Sie ein Bedrohungsmodell aus
Nachdem Sie ein Bedrohungsmodell erstellt haben, starten Sie einen Rechenlauf, um mit der Analyse zu beginnen.
-
Wählen Sie auf der Detailseite des Bedrohungsmodells die Option Start run aus.
-
AWS Security Agent beginnt mit der Analyse Ihrer Quellen und Dokumente zum Geltungsbereich.
Sie können einen Rechenlauf auch von der Seite mit der Liste der Bedrohungsmodelle aus starten, indem Sie neben dem Bedrohungsmodell, das Sie ausführen möchten, die Option Ausführung starten auswählen.
Überwachen Sie die Ausführung eines Bedrohungsmodells
Verfolgen Sie den Fortschritt Ihres Bedrohungsmodells bei der Ausführung.
Run status (Ausführungsstatus)
In der Kopfzeile der Run-Seite wird eine Statusanzeige angezeigt:
-
In Bearbeitung — Der Threat Model Agent wird ausgeführt.
-
Stoppen — Es wurde ein Abbruch angefordert. Der Agent beendet gerade seine aktuelle Aufgabe, bevor er den Vorgang beendet.
-
Abgeschlossen — Die Ausführung wurde erfolgreich abgeschlossen.
-
Fehlgeschlagen — Bei der Ausführung ist ein Fehler aufgetreten. Eine Fehlermeldung mit Einzelheiten wird angezeigt. Starten Sie einen neuen Lauf, nachdem Sie das Problem behoben haben.
-
Gestoppt — Der Lauf wurde vom Benutzer abgebrochen. Alle Bedrohungen, die vor dem Stopp generiert wurden, bleiben erhalten.
Seiten-Tabs ausführen
Navigieren Sie auf der Seite mit den Ausführungsdetails zwischen den Tabs:
-
Überblick — Sehen Sie sich die Zusammenfassung der Ausführung (Job-ID, Startzeit, Status, Dauer) mit einem Kreisdiagramm mit Schweregrad an, in dem die Bedrohungen nach Schweregrad (Kritisch, Hoch, Mittel, Niedrig) aufgeschlüsselt sind. Unter der Zusammenfassung sehen Sie ein Balkendiagramm mit STRIDE-Bedrohungskategorien, das zeigt, wie viele Bedrohungen in die einzelnen STRIDE-Kategorien fallen. Sehen Sie sich nach Abschluss der Ausführung die vom Agenten erstellte Systemübersicht an.
-
Konfiguration — Sehen Sie sich die Quellen, Dokumente und Berechtigungen (Servicerolle, CloudWatch Protokollgruppe) an, die für diesen Lauf verwendet wurden.
-
Preflight — Zeigt den Status der Preflight-Prüfungen an, die vor Beginn der Bedrohungsanalyse ausgeführt werden, einschließlich der Einrichtung der Protokollierungsinfrastruktur, der Validierung des S3-Quellzugriffs (falls zutreffend) und der Einrichtung der Testumgebung. Ein Fortschrittsbalken zeigt an, wie viele Prüfungen abgeschlossen wurden.
-
Protokolle — Zeigt eine filterbare Liste der Aufgaben an, die der Agent während der Ausführung ausgeführt hat. Wählen Sie eine beliebige Aufgabe aus, um ihre detaillierte Protokollausgabe in einem Seitenbereich anzuzeigen.
-
Bedrohungen — Sehen Sie sich die Bedrohungen an, die während des Testlaufs erkannt wurden (sieheÜberprüfen Sie Bedrohungen anhand eines Bedrohungsmodells).
Verlauf ausführen
Jedes Bedrohungsmodell führt eine Historie aller Läufe. Gehen Sie auf der Detailseite des Bedrohungsmodells wie folgt vor:
-
In der Ausführungstabelle sind alle Läufe mit Startzeit, Status, Dauer, Anzahl der Bedrohungen und ID aufgeführt.
-
Wählen Sie den Link zur Startzeit eines beliebigen Laufs, um die vollständigen Details zu sehen.
Tipp
Re-run dasselbe Bedrohungsmodell, nachdem Sie Ihren Quellcode aktualisiert oder Ihre Scope-Dokumente überarbeitet haben, um zu sehen, wie sich die Systemübersicht und die Bedrohungen im Laufe der Zeit ändern.
Bearbeiten Sie ein Bedrohungsmodell
So ändern Sie die Konfiguration Ihres Bedrohungsmodells:
-
Wählen Sie auf der Detailseite des Bedrohungsmodells die Option Bearbeiten aus.
-
Aktualisieren Sie den Titel, die Quellen, die Dokumente zum Geltungsbereich oder die AWS-Ressourcen nach Bedarf.
-
Wählen Sie Änderungen speichern aus.
Anmerkung
Die Bearbeitung eines Bedrohungsmodells hat keine Auswirkungen auf zuvor abgeschlossene Läufe. Diese behalten den Konfigurations-Snapshot bei, der zum Zeitpunkt der Ausführung verwendet wurde.
Löschen Sie ein Bedrohungsmodell
Gehen Sie wie folgt vor, um ein Bedrohungsmodell und alle zugehörigen Varianten und Bedrohungen zu löschen:
-
Öffnen Sie auf der Detailseite des Bedrohungsmodells das Aktionsmenü und wählen Sie Löschen.
-
Bestätigen Sie das Löschen.
Wichtig
Wenn gerade ein Rechenlauf läuft, müssen Sie ihn beenden, bevor Sie das Bedrohungsmodell löschen können.
Nächste Schritte
Nach der Ausführung eines Bedrohungsmodells:
-
Sehen Sie sich die Systemübersicht und die Bedrohungen an (sieheÜberprüfen Sie Bedrohungen anhand eines Bedrohungsmodells)
-
Re-run das Bedrohungsmodell, nachdem Sie Änderungen vorgenommen haben, um sicherzustellen, dass die Bedrohungen behoben wurden
-
Passen Sie Ihre Quellen und den Umfang der Dokumente an, wenn sich Ihre Anwendung weiterentwickelt
