Amazon EC2 in Google SecOps einbinden
In diesem Dokument wird beschrieben, wie Sie AWS Elastic Compute Cloud (Amazon EC2) in Google Security Operations einbinden.
Anwendungsfälle
Amazon Elastic Compute Cloud-Instanzen (Amazon EC2) sichern
- Erstellen Sie Sicherheitsgruppen, um den eingehenden und ausgehenden Internetzugriff auf Amazon EC2 einzuschränken.
- Neue Elastic-IP-Adresse zuweisen
- Neue Elastic-IP-Adresse verknüpfen
Ressourcenverwaltung: Verwenden Sie benutzerdefinierte Instanz-Tags, um AWS-Ressourcen zu verfolgen und zu identifizieren.
Hinweis
Bevor Sie die AWS Elastic Compute Cloud (EC2)-Integration in Google SecOps konfigurieren, müssen Sie prüfen, ob Ihre Netzwerkumgebung und Ihre AWS-Anmeldedaten alle betrieblichen Voraussetzungen erfüllen.
So bereiten Sie Ihre Umgebung für die Integration vor:
Prüfen Sie die Netzwerkverbindung zwischen Google SecOps und den regionalen AWS EC2-Dienstendpunkten.
Rufen Sie AWS-API-Anmeldedaten (eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel) mit den entsprechenden IAM-Berechtigungen ab.
Konfigurieren und testen Sie die Integrationsinstanz in Google SecOps.
Netzwerkanforderungen
Google SecOps kommuniziert direkt mit dem AWS EC2-Dienst über HTTPS-REST-APIs und das AWS Python SDK (boto3).
Ihre Netzwerkumgebung muss die folgenden Verbindungsregeln erfüllen:
Ausgehender HTTPS-Zugriff: Aktivieren Sie die ausgehende HTTPS-Kommunikation von Ihrer Google SecOps-Instanz oder Ihrem Remote-Agent zum regionalen AWS EC2-Endpunkt (
ec2.<region>.amazonaws.com) über Port443/TCP.Weitere Informationen finden Sie in der AWS-Dokumentation unter AWS-Dienstendpunkte.
Proxy-Konfiguration: Wenn Ihre Organisation ausgehenden Traffic über einen HTTP/HTTPS-Proxy weiterleitet, konfigurieren Sie Standard-Proxy-Variablen für die Umgebung (
HTTP_PROXY,HTTPS_PROXY,NO_PROXY) auf dem Google SecOps-Server oder Remote-Agent-Host.
Authentifizierung und Anmeldedaten
Für die AWS EC2-Integration sind programmatische API-Anmeldedaten erforderlich, um Anfragen mit AWS Signature Version 4 zu authentifizieren.
Ihre AWS-Umgebung muss die folgenden Authentifizierungsanforderungen erfüllen:
Programmatische Anmeldedaten: Rufen Sie eine gültige AWS-Zugriffsschlüssel-ID und einen geheimen AWS-Schlüssel ab, die mit einem AWS-IAM-Nutzer oder einer AWS-IAM-Rolle verknüpft sind.
Informationen zum Erstellen von IAM-Identitäten und zum Generieren von Anmeldedaten finden Sie in der AWS-Dokumentation unter Zugriffsschlüssel für IAM-Nutzer verwalten und IAM-Identitäten.
Geringste Berechtigung: Beschränken Sie die Berechtigungen auf die Aktionen und Rechenressourcen, die für Ihre automatisierten Workflows erforderlich sind, und rotieren Sie die Anmeldedaten regelmäßig.
Weitere Informationen zu Sicherheitsempfehlungen finden Sie in der AWS-Dokumentation unter Best Practices für die Sicherheit in IAM.
Aktionsberechtigungen konfigurieren
Gewähren Sie der authentifizierenden AWS-IAM-Identität die spezifischen Berechtigungen, die für die Aktionen erforderlich sind, die Ihre Google SecOps-Playbooks ausführen.
In der folgenden Tabelle finden Sie die Mindestberechtigungen für AWS Elastic Compute Cloud (EC2)-Aktionen:
| Aktionsname | Erforderliche AWS-IAM-Berechtigung (ActionName:Permission) |
Erforderliche Berechtigung | Beschreibung/Ressourcenbereich |
|---|---|---|---|
| Ausgehenden Traffic für Sicherheitsgruppe autorisieren | ec2:AuthorizeSecurityGroupEgress |
ec2:DescribeRegions |
Fügt einer EC2-Sicherheitsgruppe Regeln für ausgehenden Traffic hinzu. Ressource: ARN der Zielsicherheitsgruppe. |
| Authorize Security Group Ingress | ec2:AuthorizeSecurityGroupIngress |
ec2:DescribeRegions |
Fügt einer EC2-Sicherheitsgruppe Regeln für eingehenden Traffic hinzu. Ressource: ARN der Zielsicherheitsgruppe. |
| Tags erstellen | ec2:CreateTags |
ec2:DescribeRegions |
Fügt Tags zu EC2-Ressourcen hinzu oder überschreibt sie. Ressource: ARN der EC2-Zielressource. |
| Instanzen auflisten | ec2:DescribeInstances |
ec2:DescribeRegions |
Ruft Status und Metadaten für EC2-Instanzen ab. Ressource:
*. |
| Sicherheitsgruppen auflisten | ec2:DescribeSecurityGroups |
– | Ruft Konfigurationen und Regeln für Sicherheitsgruppen ab. Ressource:
*. |
| Ping | ec2:DescribeRegions |
– | Validiert die Integrationsverbindung. Ressource: *. |
| Ausgehenden Traffic der Sicherheitsgruppe widerrufen | ec2:RevokeSecurityGroupEgress |
ec2:DescribeRegions |
Entfernt Regeln für ausgehenden Traffic aus einer EC2-Sicherheitsgruppe. Ressource: ARN der Zielsicherheitsgruppe. |
| Revoke Security Group Ingress | ec2:RevokeSecurityGroupIngress |
ec2:DescribeRegions |
Entfernt eingehende Regeln aus einer EC2-Sicherheitsgruppe. Ressource: ARN der Zielsicherheitsgruppe. |
| Instanz starten | ec2:StartInstances |
– | Startet beendete EC2-Instanzen. Ressource: ARN der EC2-Zielinstanz. |
| Instanz beenden | ec2:StopInstances |
– | Beendet die Ausführung von EC2-Instanzen. Ressource: ARN der EC2-Zielinstanz. |
| Snapshot erstellen | ec2:CreateSnapshots |
ec2:DescribeRegions |
Erstellt EBS-Snapshots zu einem bestimmten Zeitpunkt für Instanz-Volumes. Ressource: Instanz- und Volume-ARNs. |
| Instanz beenden | ec2:TerminateInstances |
– | Fährt EC2-Instanzen herunter und beendet sie. Ressource: ARN der EC2-Zielinstanz. |
Kurzreferenz (ActionName:Permission)
In der folgenden Kurzübersicht finden Sie die erforderlichen Berechtigungen für die einzelnen Aktionen:
Ping: ec2:DescribeRegions
Authorize Security Group Egress: ec2:AuthorizeSecurityGroupEgress, ec2:DescribeRegions
Authorize Security Group Ingress: ec2:AuthorizeSecurityGroupIngress, ec2:DescribeRegions
Create Tags: ec2:CreateTags, ec2:DescribeRegions
List Instances: ec2:DescribeInstances, ec2:DescribeRegions
List Security Groups: ec2:DescribeSecurityGroups
Revoke Security Group Egress: ec2:RevokeSecurityGroupEgress, ec2:DescribeRegions
Revoke Security Group Ingress: ec2:RevokeSecurityGroupIngress, ec2:DescribeRegions
Start Instance: ec2:StartInstances
Stop Instance: ec2:StopInstances
Take Snapshot: ec2:CreateSnapshots, ec2:DescribeRegions
Terminate Instance: ec2:TerminateInstances
Beispiel für eine IAM-Richtlinie (geringste Berechtigung)
Die folgende Beispielrichtlinie zeigt die Berechtigungen, die zum Ausführen aller AWS EC2-Aktionen in Google SecOps erforderlich sind.
Eine Anleitung zum Erstellen und Anhängen von IAM-Richtlinien finden Sie in der AWS-Dokumentation unter IAM-Richtlinien erstellen.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "SecOpsEC2Discovery",
"Effect": "Allow",
"Action": [
"ec2:DescribeRegions",
"ec2:DescribeInstances",
"ec2:DescribeSecurityGroups"
],
"Resource": "*"
},
{
"Sid": "SecOpsEC2InstanceRemediation",
"Effect": "Allow",
"Action": [
"ec2:StartInstances",
"ec2:StopInstances",
"ec2:TerminateInstances",
"ec2:CreateTags",
"ec2:CreateSnapshots"
],
"Resource": "*"
},
{
"Sid": "SecOpsEC2SecurityGroupManagement",
"Effect": "Allow",
"Action": [
"ec2:AuthorizeSecurityGroupIngress",
"ec2:RevokeSecurityGroupIngress",
"ec2:AuthorizeSecurityGroupEgress",
"ec2:RevokeSecurityGroupEgress"
],
"Resource": "arn:aws:ec2:*:*:security-group/*"
}
]
}
Integrationsparameter
Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| AWS-Zugriffsschlüssel-ID | String | – | Ja | AWS-Zugriffsschlüssel-ID, die für die Integration verwendet werden soll. |
| AWS Secret Key | Passwort | – | Ja | AWS-Secret-Key, der in der Integration verwendet werden soll. |
| AWS-Standardregion | String | – | Ja | AWS-Standardregion, die in der Integration verwendet werden soll, z. B. us-west-2. |
Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.
Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.
Aktionen
Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.
Ausgehenden Traffic der Sicherheitsgruppe autorisieren
Fügt die angegebene Regel für ausgehenden Traffic einer Sicherheitsgruppe zur Verwendung mit einer VPC hinzu. Eine Regel für ausgehenden Traffic ermöglicht es Instanzen, Traffic an die angegebenen IPv4- oder IPv6-CIDR-Adressbereiche zu senden. Regeländerungen werden so schnell wie möglich an die betroffenen Instanzen weitergegeben. Es kann jedoch zu einer kleinen Verzögerung kommen.
Weitere Informationen zu Limits für VPC-Sicherheitsgruppen finden Sie unter Amazon VPC-Limits.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Sicherheitsgruppen-IDs | String | – | Ja | Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt. Hinweis für Entwickler: Jede ID muss in einer separaten Anfrage gesendet werden. |
| IP-Protokoll | DDL | Alle | Nein | Der Name des IP-Protokolls. Verwenden Sie „all“, um alle Protokolle anzugeben. Wenn Sie „all“ angeben, wird Traffic an allen Ports zugelassen, unabhängig von einem angegebenen Portbereich. Mögliche Werte: tcp , udp , icmp, all Note for dev: 'all' equals -1 from code |
| Vom Port | Ganzzahl | Nein | Der Anfang des Portbereichs für die TCP- und UDP-Protokolle oder eine ICMP-Typnummer. | |
| Bis Port | Ganzzahl | Nein | Das Ende des Portbereichs für die TCP- und UDP-Protokolle lässt Traffic auf allen Ports zu, unabhängig von dem von Ihnen angegebenen Portbereich. | |
| IP-Bereiche – CidrIP | String | – | Nein | Der IPv4-CIDR-Bereich. Verwenden Sie die Präfixlänge /32, um eine einzelne IPv4-Adresse anzugeben. |
| IPv6-Bereiche – CidrIP | String | – | Nein | Der IPv6-CIDR-Bereich. Verwenden Sie die Präfixlänge /128, um eine einzelne IPv6-Adresse anzugeben. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Wenn die angegebenen Regeln für ausgehenden Traffic mindestens einer (oder allen) Sicherheitsgruppen hinzugefügt wurden (is_success = true): „Die angegebene Regel für ausgehenden Traffic wurde den folgenden Sicherheitsgruppen hinzugefügt: {group_ids}“ Wenn die angegebenen Regeln für ausgehenden Traffic aufgrund eines Berechtigungsregelfehlers (ungültiger Port usw.) nicht hinzugefügt werden konnten (is_success = false): „Die angegebene Regel für ausgehenden Traffic konnte den folgenden Sicherheitsgruppen nicht hinzugefügt werden: {group_ids}. Grund: Ungültige IP-Berechtigungen festgelegt. Weitere Informationen finden Sie in den Logs.“ Wenn die angegebenen Regeln für ausgehenden Traffic aufgrund einer ungültigen Sicherheitsgruppen-ID nicht hinzugefügt werden konnten: (is_success = false): „Die angegebene Regel für ausgehenden Traffic konnte den folgenden Sicherheitsgruppen nicht hinzugefügt werden: {group_ids}. Grund: Es wurde eine ungültige Sicherheitsgruppen-ID angegeben. Weitere Informationen finden Sie in den Logs.`` Wenn die angegebenen Regeln für ausgehenden Traffic nicht allen Gruppen hinzugefügt werden konnten: is_success=false Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Ausgehenden Traffic der Sicherheitsgruppe autorisieren‘. Reason: {0}''.format(error.Stacktrace) |
Allgemein |
Eingehenden Traffic für Sicherheitsgruppe autorisieren
Fügt einer Sicherheitsgruppe die angegebene Regel für eingehenden Traffic hinzu. Eine Regel für eingehenden Traffic ermöglicht es Instanzen, Traffic von den angegebenen IPv4- oder IPv6-CIDR-Adressbereichen zu empfangen. Regeländerungen werden so schnell wie möglich an die betroffenen Instanzen weitergegeben. Es kann jedoch zu einer kleinen Verzögerung kommen.
Weitere Informationen zu Limits für VPC-Sicherheitsgruppen finden Sie unter Amazon VPC-Limits.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Sicherheitsgruppen-IDs | String | – | Ja | Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt. Hinweis für Entwickler: Jede ID muss in einer separaten Anfrage gesendet werden. |
| IP-Protokoll | DDL | Alle | Nein | Der Name des IP-Protokolls. Verwenden Sie „all“, um alle Protokolle anzugeben. Wenn Sie „all“ angeben, wird Traffic an allen Ports zugelassen, unabhängig von einem angegebenen Portbereich. Mögliche Werte: tcp , udp , icmp, all Note for dev: 'all' equals -1 from code |
| Vom Port | Ganzzahl | Nein | Der Anfang des Portbereichs für die TCP- und UDP-Protokolle oder eine ICMP-Typnummer. | |
| Bis Port | Ganzzahl | Nein | Das Ende des Portbereichs für die TCP- und UDP-Protokolle lässt Traffic auf allen Ports zu, unabhängig von dem von Ihnen angegebenen Portbereich. | |
| IP-Bereiche – CidrIP | String | – | Nein | Die IPv4-Adresse im CIDR-Format. Verwenden Sie die Präfixlänge /32, um eine einzelne IPv4-Adresse anzugeben. |
| IPv6-Bereiche – CidrIP | String | – | Nein | Der IPv6-CIDR-Bereich. Verwenden Sie die Präfixlänge /128, um eine einzelne IPv6-Adresse anzugeben. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Wenn die angegebenen Regeln für eingehenden Traffic mindestens einer Sicherheitsgruppe hinzugefügt wurden (wenn alle erfolgreich aktualisiert wurden, ist_success = true): „Die angegebene Regel für eingehenden Traffic wurde den folgenden Sicherheitsgruppen hinzugefügt: {group_ids}“ Wenn die angegebenen Regeln für eingehenden Traffic aufgrund eines Berechtigungsregelfehlers (ungültiger Port usw.) nicht hinzugefügt werden konnten: (is_success =false): „Die angegebene Regel für eingehenden Traffic konnte den folgenden Sicherheitsgruppen nicht hinzugefügt werden: {group_ids}. Grund: Ungültige IP-Berechtigungen festgelegt. Weitere Informationen finden Sie in den Logs.“ Wenn die angegebenen Regeln für eingehenden Traffic aufgrund einer ungültigen Sicherheitsgruppen-ID nicht hinzugefügt werden konnten (is_success =false): „Die angegebene Regel für eingehenden Traffic konnte den folgenden Sicherheitsgruppen nicht hinzugefügt werden: {group_ids}. Grund: Es wurde eine ungültige Sicherheitsgruppen-ID angegeben. Weitere Informationen finden Sie in den Logs.`` Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Authorize Security Group Ingress‘. Reason: {0}''.format(error.Stacktrace) |
Allgemein |
Tags erstellen
Ein Tag ist ein Label, das Sie einer AWS-Ressource zuweisen. Jedes Tag besteht aus einem Schlüssel und einem optionalen Wert. Sie können Tags verwenden, um Ihre Ressourcen zu suchen und zu filtern oder Ihre AWS-Kosten zu verfolgen. Fügt nur die angegebenen Tags für die angegebene Amazon EC2-Ressource oder die angegebenen Amazon EC2-Ressourcen hinzu oder überschreibt sie. Wenn Sie einen vorhandenen Tag-Schlüssel angeben, wird der Wert mit dem neuen Wert überschrieben. Jede Ressource kann maximal 50 Tags haben. Tag-Schlüssel müssen pro Ressource eindeutig sein.
Weitere Informationen zu Tags finden Sie im Amazon Elastic Compute Cloud-Nutzerhandbuch unter Ressourcen taggen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Ressourcen-IDs | String | – | Ja | Eine oder mehrere Ressourcen-IDs. Durch Kommas getrennt. |
| Tags | String | – | Ja | Die Schlüssel/Wert-Kombination eines Tags, das der Ressource zugewiesen werden soll. Wenn Sie beispielsweise allen angegebenen Ressourcen ein Tag mit dem Schlüssel Sie können die angegebenen Tags hinzufügen oder überschreiben. Die Tag-Schlüssel müssen pro Ressource eindeutig sein. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Bei Erfolg: „{tags_list} Tags wurden den folgenden Ressourcen hinzugefügt: „resource_ids“ Bei ungültigen Ressourcen-IDs (is_success = false): „Die Tags {tag_list} konnten den folgenden Ressourcen nicht hinzugefügt werden: {resource_ids}. Grund: Ungültige Ressourcen-ID Wenn die Ressource mehr als 50 Tags hat (is_success = false): „Die Tags {tag_list} konnten den folgenden Ressourcen nicht hinzugefügt werden: {resource_ids}. Grund: Die Ressource kann maximal 50 Tags haben. Wenn der Tag-Schlüssel nicht eindeutig ist (is_success = false): „Die Tags {tag_list} konnten den folgenden Ressourcen nicht hinzugefügt werden: {resource_ids}. Grund: Tag-Schlüssel müssen pro Ressource eindeutig sein. Wenn das angegebene Tag ein ungültiges Format hat (d. h. nur Schlüssel oder nur Wert ohne die vollständige Struktur von Schlüssel:Wert) (is_success = false): „{invalid_tags} Tags konnten den folgenden Ressourcen nicht hinzugefügt werden: {ids}. Grund: Ungültiges Format. Das Tag muss einen Schlüssel und einen Wert enthalten. Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Tags erstellen‘. Reason: {0}''.format(error.Stacktrace) |
Allgemein |
Instanzen auflisten
Beschreibt die angegebenen Instanzen oder alle Instanzen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Instanz-IDs | String | – | Nein | Eine oder mehrere Instanz-IDs. Wenn Sie Instanz-IDs angeben, enthält die Ausgabe nur Informationen zu den angegebenen Instanzen. Dieser Parameter kann nicht mit dem Parameter „Max. Ergebnisse“ verwendet werden. „Instanz-IDs“ hat Vorrang vor dem Parameter „Max. Ergebnis“. |
| Tag-Filter | String | – | Nein | Die Schlüssel/Wert-Kombination eines Tags, das der Ressource zugewiesen ist. Wenn Sie beispielsweise alle Ressourcen finden möchten, die ein Tag mit dem Schlüssel „Owner“ und dem Wert „TeamA“ haben, geben Sie „Owner:TeamA“ an. Kommagetrennte Tag-Filter. Beispiel: Name:Name1,Owner:TeamA. Die zurückgegebenen Instanzen entsprechen allen Filtern. |
| Max. Anzahl von Ergebnissen | Ganzzahl | 50 | Nein | Geben Sie an, wie viele Instanzen zurückgegeben werden sollen. Der Standardwert ist 50. Der Maximalwert beträgt 1.000. Der Parameter „Instanz-IDs“ kann nicht mit dem Parameter „Max. Ergebnisse“ verwendet werden. „Instanz-IDs“ hat Vorrang vor dem Parameter „Max. Ergebnis“. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
"EC2_Instances": [
{
"AmiLaunchIndex":0,
"ImageId":"ami-047a51fa27710816e",
"InstanceId":"i-044c08c5bfe1a7f98",
"InstanceType":"t2.micro",
"KeyName":"\"Key\": \"Test\", \"Value\":\"Test\"",
"LaunchTime":"2021-1-30",
"Monitoring":{
"State":"disabled"
},
"Placement":{
"AvailabilityZone":"us-east-1d",
"GroupName":"",
"Tenancy":"default"
},
"PrivateDnsName":"ip-192-0-2-220.ec2.internal",
"PrivateIpAddress":"192.0.2.220",
"ProductCodes":[
],
"PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
"PublicIpAddress":"192.0.2.218",
"State":{
"Code":16,
"Name":"running"
},
"StateTransitionReason":"",
"SubnetId":"subnet-1b1fda3a",
"VpcId":"vpc-ID",
"Architecture":"x86_64",
"BlockDeviceMappings":[
{
"DeviceName":"/dev/xvda",
"Ebs":{
"AttachTime":"2021-1-30",
"DeleteOnTermination":true,
"Status":"attached",
"VolumeId":"vol-00f70681a43e5d86e"
}
}
],
"ClientToken":"",
"EbsOptimized":false,
"EnaSupport":true,
"Hypervisor":"xen",
"NetworkInterfaces":[
{
"Association":{
"IpOwnerId":"amazon",
"PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
"PublicIp":"192.0.2.218"
},
"Attachment":{
"AttachTime":"",
"AttachmentId":"eni-attach-06bc5e5901ce99ef2",
"DeleteOnTermination":true,
"DeviceIndex":0,
"Status":"attached",
"NetworkCardIndex":0
},
"Description":"",
"Groups":[
{
"GroupName":"launch-wizard-2",
"GroupId":"sg-001700ccddac4189a"
}
],
"Ipv6Addresses":[
],
"MacAddress":"12:34:56:ab:cd:ef",
"NetworkInterfaceId":"eni-020fa83efd417e32d",
"OwnerId":"ID",
"PrivateDnsName":"ip-192-0-2-220.ec2.internal",
"PrivateIpAddress":"192.0.2.220",
"PrivateIpAddresses":[
{
"Association":{
"IpOwnerId":"amazon",
"PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
"PublicIp":"192.0.2.218"
},
"Primary":true,
"PrivateDnsName":"ip-192-0-2-220.ec2.internal",
"PrivateIpAddress":"192.0.2.220"
}
],
"SourceDestCheck":true,
"Status":"in-use",
"SubnetId":"subnet-1b1fda3a",
"VpcId":"vpc-ID",
"InterfaceType":"interface"
}
],
"RootDeviceName":"/dev/xvda",
"RootDeviceType":"ebs",
"SecurityGroups":[
{
"GroupName":"launch-wizard-2",
"GroupId":"sg-001700ccddac4189a"
}
],
"SourceDestCheck":true,
"Tags":[
{
"Key":"Owner",
"Value":"Example"
},
{
"Key":"Name",
"Value":"Example test"
}
],
"VirtualizationType":"hvm",
"CpuOptions":{
"CoreCount":1,
"ThreadsPerCore":1
},
"CapacityReservationSpecification":{
"CapacityReservationPreference":"open"
},
"HibernationOptions":{
"Configured":false
},
"MetadataOptions":{
"State":"applied",
"HttpTokens":"optional",
"HttpPutResponseHopLimit":1,
"HttpEndpoint":"enabled"
},
"EnclaveOptions":{
"Enabled":false
}
}
]
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, ungültiger Instanz-ID, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Instanzen auflisten‘. Reason: {0}''.format(error.Stacktrace) |
Allgemein |
| Tabelle mit Fall-Repository | Tabellenname: Amazon EC2-Instanzen Tabellenspalten: ID Bundesland Typ Verfügbarkeitszone Öffentliches IPv4-DNS Öffentliche IPv4-Adresse Monitoring Name der Sicherheitsgruppe Schlüsselname Startzeit |
Sicherheitsgruppen auflisten
Beschreibt die angegebenen Sicherheitsgruppen oder alle Ihre Sicherheitsgruppen. Eine Sicherheitsgruppe ist für die Verwendung mit Instanzen entweder auf der EC2-Classic-Plattform oder in einer bestimmten VPC vorgesehen.
Weitere Informationen finden Sie unter Amazon EC2-Sicherheitsgruppen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Namen von Sicherheitsgruppen | String | – | Falsch | Ein oder mehrere Sicherheitsgruppennamen [nur EC2-Classic und Standard-VPC]. Durch Kommas getrennt.Wenn Sie Namen von Sicherheitsgruppen angeben, enthält die Ausgabe nur Informationen zu den angegebenen Namen. |
| Sicherheitsgruppen-IDs | String | – | Falsch | Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt.Wenn Sie Sicherheitsgruppen-IDs angeben, enthält die Ausgabe nur Informationen zu den angegebenen IDs. Erforderlich für Sicherheitsgruppen in einer nicht standardmäßigen VPC. |
| Tag-Filter | String | – | Falsch | Die Schlüssel/Wert-Kombination eines Tags, das der Sicherheitsgruppe zugewiesen ist. Wenn Sie beispielsweise alle Gruppen mit einem Tag suchen möchten, das den Schlüssel |
| Max. Anzahl von Ergebnissen | Ganzzahl | 50 | Falsch | Die Anzahl der zurückzugebenden Sicherheitsgruppen. Der Standardwert ist 50.
Der Höchstwert ist 1000.
Hinweis: Die Parameter „Sicherheitsgruppen-IDs“ und „Sicherheitsgruppennamen“ können nicht mit dem Parameter „Maximale Ergebnisse“ verwendet werden. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
"EC2_Security_Groups": [
{
"Description":"launch-wizard-2 created 2021-01-30T19:37:11.523+02:00",
"GroupName":"launch-wizard-2",
"IpPermissions":[
{
"FromPort":22,
"IpProtocol":"tcp",
"IpRanges":[
{
"CidrIp":"192.0.2.0/0"
}
],
"Ipv6Ranges":[
],
"PrefixListIds":[
],
"ToPort":22,
"UserIdGroupPairs":[
]
}
],
"OwnerId":"582302349248",
"GroupId":"sg-001700ccddac4189a",
"IpPermissionsEgress":[
{
"IpProtocol":"-1",
"IpRanges":[
{
"CidrIp":"192.0.2.0/0"
}
],
"Ipv6Ranges":[
],
"PrefixListIds":[
],
"UserIdGroupPairs":[
]
}
],
"Tags":[
{
"Key":"Team",
"Value":"A-Team"
},
{
"Key":"Owner",
"Value":"Example"
}
],
"VpcId":"vpc-ID"
}
]
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, ungültiger Gruppen-ID/ungültigem Gruppennamen, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Sicherheitsgruppen auflisten‘. Reason: {0}''.format(error.Stacktrace) |
Allgemein |
| Tabelle mit Fall-Repository | Tabellenname: Amazon EC2-Instanzen Tabellenspalten: Sicherheitsgruppen-ID Name der Sicherheitsgruppe VPC-ID Beschreibung Inhaber-ID |
Ping
Testen Sie die Verbindung zu AWS EC2.
Parameter
–
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Bei Erfolg: „Successfully connected to the Amazon EC2 with the provided connection parameters!“ Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Wenn nicht erfolgreich: „Verbindung zum Amazon EC2-Server konnte nicht hergestellt werden! Error is {0}".format(exception.stacktrace) |
Allgemein |
Ausgehenden Traffic für Sicherheitsgruppe widerrufen
Entfernt die angegebenen Regeln für ausgehenden Traffic aus einer Sicherheitsgruppe für EC2-VPC. Diese Aktion gilt nicht für Sicherheitsgruppen, die in EC2-Classic verwendet werden. Wenn Sie eine Regel entfernen möchten, müssen die von Ihnen angegebenen Werte (z. B. Ports) genau mit den Werten der vorhandenen Regel übereinstimmen. Regeländerungen werden so schnell wie möglich an Instanzen innerhalb der Sicherheitsgruppe weitergegeben. Es kann jedoch zu einer kleinen Verzögerung kommen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Sicherheitsgruppen-IDs | String | – | Ja | Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt. Hinweis für Entwickler: Jede ID muss in einer separaten Anfrage gesendet werden. |
| IP-Protokoll | DDL | Alle | Nein | Der Name des IP-Protokolls. Verwenden Sie „all“, um alle Protokolle anzugeben. Wenn Sie „all“ angeben, wird Traffic an allen Ports zugelassen, unabhängig von einem angegebenen Portbereich. Mögliche Werte: tcp , udp , icmp, all Note for dev: 'all' equals -1 from code |
| Vom Port | Ganzzahl | Nein | Der Anfang des Portbereichs für die TCP- und UDP-Protokolle oder eine ICMP-Typnummer. | |
| Bis Port | Ganzzahl | Nein | Das Ende des Portbereichs für die TCP- und UDP-Protokolle lässt Traffic auf allen Ports zu, unabhängig von dem von Ihnen angegebenen Portbereich. | |
| IP-Bereiche – CidrIP | String | – | Nein | Die IPv4-Adresse im CIDR-Format. Verwenden Sie die Präfixlänge /32, um eine einzelne IPv4-Adresse anzugeben. |
| IPv6-Bereiche – CidrIP | String | – | Nein | Der IPv6-CIDR-Bereich. Verwenden Sie die Präfixlänge /128, um eine einzelne IPv6-Adresse anzugeben. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Wenn die angegebenen Regeln für ausgehenden Traffic erfolgreich aus mindestens einer (oder allen) Sicherheitsgruppen widerrufen wurden (is_success = true): „Die angegebene Regel für ausgehenden Traffic wurde erfolgreich aus den folgenden Sicherheitsgruppen widerrufen: {group_ids}“ Wenn die angegebenen Regeln für ausgehenden Traffic aufgrund eines Berechtigungsfehlers nicht aufgehoben werden konnten (ungültiger Port wie 205 usw.): (is_success =false): „Die angegebene Regel für ausgehenden Traffic konnte nicht für die folgenden Sicherheitsgruppen aufgehoben werden: {group_ids}. Grund: Ungültige IP-Berechtigungen festgelegt. Weitere Informationen finden Sie in den Logs.“ Wenn die angegebenen Regeln für ausgehenden Traffic aufgrund einer ungültigen Sicherheitsgruppen-ID nicht aufgehoben werden konnten (is_success =false): „Die angegebene Regel für ausgehenden Traffic konnte nicht für die folgenden Sicherheitsgruppen aufgehoben werden: {group_ids}. Grund: Es wurde eine ungültige Sicherheitsgruppen-ID angegeben. Weitere Informationen finden Sie in den Logs.`` Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Ausgehenden Traffic der Sicherheitsgruppe widerrufen‘. Reason: {0}''.format(error.Stacktrace) |
Gener |
Eingehenden Traffic für Sicherheitsgruppe widerrufen
Entfernt die angegebenen Regeln für eingehenden Traffic (Inbound-Regeln) aus einer Sicherheitsgruppe. Wenn Sie eine Regel entfernen möchten, müssen die von Ihnen angegebenen Werte (z. B. Ports) genau mit den Werten der vorhandenen Regel übereinstimmen. Regeländerungen werden so schnell wie möglich an Instanzen innerhalb der Sicherheitsgruppe weitergegeben. Es kann jedoch zu einer kleinen Verzögerung kommen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Sicherheitsgruppen-IDs | String | – | Ja | Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt. Hinweis für Entwickler: Jede ID muss in einer separaten Anfrage gesendet werden. |
| IP-Protokoll | DDL | Alle | Nein | Der Name des IP-Protokolls. Verwenden Sie „all“, um alle Protokolle anzugeben. Wenn Sie „all“ angeben, wird Traffic an allen Ports zugelassen, unabhängig von einem angegebenen Portbereich. Mögliche Werte: tcp , udp , icmp, all Note for dev: 'all' equals -1 from code |
| Vom Port | Ganzzahl | Nein | Der Anfang des Portbereichs für die TCP- und UDP-Protokolle oder eine ICMP-Typnummer. | |
| Bis Port | Ganzzahl | Nein | Das Ende des Portbereichs für die TCP- und UDP-Protokolle lässt Traffic auf allen Ports zu, unabhängig von dem von Ihnen angegebenen Portbereich. | |
| IP-Bereiche – CidrIP | String | – | Nein | Die IPv4-Adresse im CIDR-Format. Verwenden Sie die Präfixlänge /32, um eine einzelne IPv4-Adresse anzugeben. |
| IPv6-Bereiche – CidrIP | String | – | Nein | Der IPv6-CIDR-Bereich. Verwenden Sie die Präfixlänge /128, um eine einzelne IPv6-Adresse anzugeben. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Wenn die angegebenen Regeln für eingehenden Traffic für mindestens eine (oder alle) Sicherheitsgruppen erfolgreich widerrufen wurden: (is_success = true): „Die angegebene Regel für eingehenden Traffic wurde für die folgenden Sicherheitsgruppen erfolgreich widerrufen: {group_ids}“ Wenn die angegebenen Regeln für eingehenden Traffic aufgrund eines Fehlers bei der Berechtigungsregel (ungültiger Port wie 205 usw.) nicht widerrufen werden konnten: (is_success =false): „Die angegebene Regel für eingehenden Traffic konnte nicht aus den folgenden Sicherheitsgruppen widerrufen werden: {group_ids}. Grund: Ungültige IP-Berechtigungen festgelegt. Weitere Informationen finden Sie in den Logs.“ Wenn die angegebenen Regeln für eingehenden Traffic aufgrund einer ungültigen Sicherheitsgruppen-ID nicht widerrufen werden konnten (is_success =false): „Die angegebene Regel für eingehenden Traffic konnte nicht für die folgenden Sicherheitsgruppen widerrufen werden: {group_ids}. Grund: Es wurde eine ungültige Sicherheitsgruppen-ID angegeben. Weitere Informationen finden Sie in den Logs.`` Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Eingehenden Traffic der Sicherheitsgruppe widerrufen‘. Reason: {0}''.format(error.Stacktrace) |
Allgemein |
Instanz starten
Startet eine zuvor beendete Instanz, die von Amazon Elastic Block Store (Amazon EBS) unterstützt wird. Es kann einige Minuten dauern, bis die Instanz den Status „Wird ausgeführt“ erreicht. Beachten Sie, dass Sie eine Instanz, die durch einen Instanzspeicher gesichert ist, nicht starten können. Weitere Informationen zu Instanzen mit Instanzspeicher finden Sie unter Speicher für das Root-Gerät.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Instanz-IDs | String | – | Ja | Eine oder mehrere Instanz-IDs. Durch Kommas getrennt |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
[
{
"CurrentState": "pending",
"InstanceId": "string",
"PreviousState":"stopped"
}
]
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Instanz starten‘. Reason: {0}''.format(error.Stacktrace) |
Allgemein |
Instanz beenden
Beendet eine von Amazon EBS unterstützte Instanz. Wenn Sie eine Instanz beenden, versucht das System, sie nach einer kurzen Verzögerung zwangsweise herunterzufahren. Es kann einige Minuten dauern, bis die Instanz beendet ist. Sie können die Instanz jederzeit neu starten. Sie können eine Instanz mit Instanzspeicher nicht beenden, sondern müssen sie stattdessen beenden. Weitere Informationen zu Instanzen mit Instanzspeicher finden Sie unter https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Instanz-IDs | String | – | Ja | Eine durch Kommas getrennte Liste von Instanz-IDs. |
| Erzwingen | Boolesch | – | Nein | Wenn diese Option ausgewählt ist, wird die Instanz sofort beendet, ohne dass Dateisystem-Caches oder Metadaten geleert werden.
Für diesen Vorgang sind obligatorische Prüf- und Reparaturverfahren für das Dateisystem erforderlich, bevor die Instanz den Betrieb wieder aufnehmen kann. Nicht empfohlen für Windows-Instanzen.
Standardmäßig nicht aktiviert. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Foto machen
Erstellen Sie einen Snapshot der Instanz.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Instanz-ID | String | – | Ja | Geben Sie die Instanz-ID an. |
| Beschreibung | String | – | Nein | Geben Sie die Beschreibung des Snapshots an. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"EC2_Snapshot": [
{
"Description": "",
"Tags": [],
"Encrypted": false,
"VolumeId": "vol-ID",
"State": "pending",
"VolumeSize": 8,
"StartTime": "2022-11-13 15:45:44.795000+00:00",
"Progress": "",
"OwnerId": "OWNER_ID",
"SnapshotId": "snap-ID"
}
]
}
Instanz beenden
Beendet eine Instanz.
Beendete Instanzen können nicht neu gestartet werden. Nur Instanzen, die durch einen Instanzspeicher gesichert sind, können beendet werden. Weitere Informationen zu Instanzen mit Instanzspeicher finden Sie unter Speicher für das Root-Gerät.
Wenn Sie eine Instanz mehrmals beenden, ist jeder Aufruf erfolgreich. Wenn Sie mehrere Instanzen angeben und die Anfrage fehlschlägt (z. B. aufgrund einer einzelnen falschen Instanz-ID), wird keine der Instanzen beendet.
Beendete Instanzen bleiben nach der Beendigung etwa eine Stunde lang sichtbar. Standardmäßig löscht Amazon EC2 alle EBS-Volumes, die beim Start der Instanz angehängt waren. Volumes, die nach dem Start der Instanz angehängt wurden, werden weiterhin ausgeführt. Weitere Informationen finden Sie im Amazon-Nutzerhandbuch.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Instanz-IDs | String | – | Ja | Eine oder mehrere Instanz-IDs. Durch Kommas getrennt. |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
"StoppingInstances": [
{
"CurrentState": "shutting-down",
"InstanceId": "string",
"PreviousState":"running"
}
]
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Instanz beenden‘. Reason: {0}''.format(error.Stacktrace) |
Allgemein |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten